Table of Contents

Importing and Creating Drillholes

This guide explains how to import drillhole data into Unity and set up drillholes in a scene.

Creating Drillholes from Data

  1. Go to the TerraTools website.

  2. Upload the three required CSV files:

    • Collar
    • Survey
    • Assay

  3. Once the files are processed, download the generated .fbx and .json files.

  4. Rename the files using the required naming format:

    DH_M_<DrillholeName>.fbx
DH_J_<DrillholeName>.json

    Example:

    DH_M_FiloDrillholes.fbx
DH_J_FiloDrillholes.json

    The <DrillholeName> must be exactly the same for both files.

Importing into Unity

  1. Place both the .fbx and .json files in the same folder in the Unity project.

  2. Unity will automatically create a DrillholeDataAsset named:

    DH_<DrillholeName>.asset

  3. Select the created asset and confirm that it is complete. A complete asset requires:

    • A valid FBX model
    • A valid JSON file
    • Mineral channel data from the JSON

Scene Setup

  1. Create a new empty GameObject in the scene.
  2. Place it under the CesiumGeoreference object.
  3. Add the Geology Data Manager component to the GameObject.
  4. Assign the generated DrillholeDataAsset to the Data Asset field.
  5. Assign the drillhole material to the Material field.
  6. Click Setup Drillholes.

The drillhole model will be instantiated as a child of the GameObject. Each drillhole child will be positioned using the longitude, latitude, and elevation values from the JSON data.

Configuring Mineral Channels

After assigning a valid DrillholeDataAsset, the Geology Data Manager inspector will display the available mineral channels from the JSON data.

For each mineral channel, you can:

  1. Add cutoff entries.
  2. Set colors for each value range.
  3. Choose whether each range is active by default.
  4. Apply threshold presets.
  5. Apply color presets.

Each channel supports up to 8 entries.

Ignore Lowest Value

When Ignore Lowest Value is enabled, the first entry is treated as ignored data:

  • Its color is locked to black.
  • It starts disabled.
  • It is not shown as an active mineral range by default.

This is useful when the lowest value represents empty, missing, or background data.

Clearing Drillholes

If drillholes have already been set up, the inspector will show a Clear Drillholes button instead of Setup Drillholes.

Click Clear Drillholes to remove the generated drillhole prefab from the scene. You can then run Setup Drillholes again.

Focus Groups

Focus groups can be configured in the Geology Data Manager inspector.

A focus group contains a list of drillhole GameObjects. Calling a focus group will highlight those objects and de-emphasize the others.

Depending on the manager settings, focus groups can either:

  • Change object alpha values, or
  • Set non-focused objects inactive

Use Reset Focus Groups to restore all drillholes to their default visible state.

Edit this page