Using Point Data

The Point Data drop down includes operators for importing point data, managing and stylizing point data, and querying point data.

Input Data (CSV file)

Your CSV file must include columns for;

• X: The easting coordinate. Ensure it matches the CRS that your blender scene is set to.
• Y: The northing coordinate.
• Z: The elevation.
• Any additional data columns will be brought in as custom properties

Importing Points

1. Under Point Data click the drop down arrow for Import Point Data (CSV)

2. Click Load CSV to bring up the file browser and select your CSV file

3. Select the appropriate columns for X (easting) Y (northing) and Z (elevation)

4. Click Import Points to render them into your scene. These will now appear as a collection called Points Collection within your outliner. The point data comes in as sphere objects (mesh) with no material assigned to them.

Managing and Stylizing Point Data

This Operator is nearly identical to the Manage Drill Holes Operator, with the option to color and resize the individual objects.

1. Under Point Data click the drop down arrow for Manage Point Data

2. Choose the collection holding your point data (This will be called Points Collection if it has not been renamed)

3. Choose the attribute you would like to plot from the populated list. This list will contain every column from the CSV you used to import the points.

4. Select a color map. Note the color map options will adjust based on whether your selected column is numerical or categorical.

Continuous Color Maps

Categorical Color Maps

5. Choose a desired size (radius of the spheres). This defaults to the same size as the import, so re-sizing is optional.

6. Utilize the optional check boxes:

• Normalize color mapping (numerical data):

  • This method uses the Interquartile Range (IQR) which adjusts the color mapping range based on the middle 50% of the data.
  • Bounds are calculated as:
    • Lower Bound = Q1 - (scaling_factor × IQR)
    • Upper Bound = Q3 + (scaling_factor × IQR)
  • This Focuses the color gradient on core data trends without excluding any values, making subtle differences more recognizable.
  • Increasing the Scaling Factor will increase the upper the lower bounds of the data range, thus creating a color map where outliers are highlighted more

• Log Scale Sizing (numerical data):

  • This method will dynamically size the data points (curve objects) along a log scale or linear scale based on the values. Bigger values get bigger sizes.
  • 1. Select an attribute to apply the sizing to
  • 2. Switch to a linear scale if desired
  • 3. Use the Size Multiplier to size up or down the entire group. ('1' means no scaling is applied)

• Legend (numerical OR categorical data)

  • to generate the legend you must ensure that you have the Image Editor open in one of your editor types. For example, you can change your outliner to image editor by clicking the change editor type icon in the upper left corner of the outliner. Once this is open, the legend will generate in this space.

7. Click Render to apply the style

Any inputs and settings can be changed or adjusted. Click Render again and it will override the previous style

Point Data Query

1. Under Point Data click the drop down arrow for Point Data Query

2. Choose the collection holding your point data (This will be called Points Collection if it has not been renamed)

3. Choose the query property from the populated list

• If the property is numerical the lower and upper bounds of the data column are calculated and presented in a text box. Change the upper and lower bounds to query out everything outside of this defined range
• If the property is categorical check boxes of each unique value will populate. check boxes for values to keep, all others are queried out.

4. Click Apply Query to hide objects that are queried out.

5. Click Reset Query to bring back the default state.