Object

The following table describes the tools in the Object section of the Edit tab.

Tool Description
Join and Close Used to connect across gaps in lines, to merge common boundaries between different surfaces and cap open ends of surfaces.
Explode
By Geometry — Breaks apart disjoint components of edge networks and triangulations into separate objects.
By Attribute — Breaks apart single objects into multiple objects based on edge connectivity.
Fill Used to fill a polygon object with a solid colour.
Unfill Used to remove solid fill from a polygon object.
Simplify Line Removes excess points while retaining the shape of a line.
Subdivide Edge Inserts points along a line at equal intervals.
Point Z from Attribute Displays a selected attribute as height (point z).
Snap Points Used to slightly move points (that are close together) to the same point.
Script Used to write Java scripts for analysis of point data.

Join and Close

Lines

  1. Select points around the gap(s) to be joined. The closest end points of the selected points will be joined together.

  2. Go to Edit > Object > Join and Close.

If the end points were not correctly joined, select the end points to connect using the point selection mode and run the option again.

The following example shows contours with removed edges. After the close lines option is run on the point selection, the edges are reconnected.

Surfaces

  1. Select points around the region to be merged or capped, otherwise select the entire surface(s) to carry out all steps together, producing a single closed object . Create > Surface > Loop triangulation can be used with this function to complete the merging process.

  2. Select Edit > Object > Join and Close.

The following example combines with the function at Create > Surface > Loop triangulation to merge and cap three separate hollow surfaces.

Two open surfaces selected (representing sections of a mine tunnel) with a gap between the opening to be joined .

Create > Surface > Loop triangulation creates a joining piece (coloured orange in this example) between the first two surfaces. There are three separate surfaces now, in contact along two common boundaries.

The function firstly identifies where the three surfaces are in contact and merges them into one surface.

The function continues by capping the ends of the selected surfaces. The result is a single closed solid surface.

The original surfaces were merged along common boundaries and the open ends capped.

Explode

By Geometry

The Explode by Geometry option breaks apart disjoint components of edge networks and triangulations into separate objects.

The object below, on the left consists of two arrows. Once exploded, each arrow is a single object.

To break the object apart into separate objects:

  1. Select the object to be exploded.

  2. Go to Edit > Object > Explode > By Geometry. The action is carried out immediately on the object.

A container is created with the multiple objects stored inside.

By Attribute

The Explode by Attribute option breaks apart single objects (points) into multiple objects.

To explode by attribute:

  1. Select an object.

  2. Go to Edit > Object > Explode > By Attribute.

  3. A panel will open allowing you to select an attribute. Press OK or Apply to continue. Press Cancel to quit the process.

A container is created with the multiple objects stored inside.

Fill

To fill a polygon with a solid colour:

  1. Select the object(s).

  2. Go to Edit > Object > Fill or right-click and choose Edit > Fill from the context menu and the polygon will be filled with a solid colour corresponding to the colour currently on the colour palette.

Unfill

Edit > Object > Unfill allows the selected polygon object to be reverted to an unfilled object.

To unfill an object:

  1. Select the object(s).

  2. Choose Edit > Object > Unfill or right-click and choose Edit > Unfill from the context menu.

Simplify Line

To use the Simplify Line tool:

  1. Go to Edit > Object > Simplify line. This will open a new panel.

  2. Enter a Filter distance. This specifies a maximum distance deviation from the line for which points are retained. As the distance gets smaller, more points are retained and fewer are removed from the line.

Simplified objects can be recovered using the Undo option.

Subdivide Edge

To use the Subdivide Edge tool:

  1. Go to Edit > Object > Subdivide Edge. A new panel will open.

  2. Choose one of the following options:

    • Subdivisions per edge— Choose this option if you want to specify the number of equal subdivisions to split the selected edges in to. An edge is a line segment, and the connection between two points. A subdivision of 2 will insert one point midway along each edge in the selection. A single edge within a line can be selected using edge selection mode.

    • Number of result edges — Choose this option if you want to specify new points on the line. For example setting the option to 2 would make a point half way at each segment.

  3. Click OK or Apply to accept the subdivision

Objects can be recovered using the Undo option.

Point Z from Attribute

The Point Z from Attribute tool is used to display a selected attribute as height. This may be useful for visualising the selected attribute. One example usage would be setting the height of contours imported from Shapefiles which have a height property.

To use the tool:

  1. Go to Edit > Object > Point Z from Attribute. This will open a new panel.

  2. Select the objects.

  3. Select the Attribute to be displayed as height from the Attribute drop-down list.

  4. Select OK. The selected attribute is displayed in the View window as height.

Snap Points

Points can be very close but not on the same point as a result of:

  • Using the Extend to face tool (from the triangulation context menu) on fitted planes. Numerical rounding means the points are very close but not exactly on the same point.

  • Importing data from other software packages. This data can have points that are close, but are meant to be on the same point.

  1. On the Edit ribbon tab navigate to the Object group and select Snap Points.

  2. Select the two points to be snapped.

  3. Enter the Tolerance. This defines the maximum distance between points for a snap to occur.

    Fig. Close up of two planes with a result after snapping the points

Script

Script editor is used to write Java scripts for manipulation or analysis of point data. This may be useful for calculating new fields or adjusting missing or default values as well as changing display attributes.

Scripts operate on point objects. An object must be selected for the script to work.

  1. Go to Edit > Object > Script. This will open a new panel.

  2. Write the required script in the top window.

  3. Enter the location to save the script in the Script field.

  4. The debugging window displays the changes the script will make to the selected data.

  5. Press the Test script button to show the changes the script will make in the debugging window.

  6. When complete, press Apply script to selection to run the script.

Scripting in Vulcan GeologyCore follows the JavaScript syntax.

Point Script

The Object/Script option allows a simple Java script to be created to add or edit point attributes and adjust colouring.

Note:  More advanced data manipulation, using Python code, is available through the Online Python SDK Help.

The following is an example of a script to create a gold topcut field in a set of sample points and then adjust point visibility to display only points with positive grade values:

/*1 define topcut value*/
var topcut = 20;

/*2 add new variables*/
p.au_cut = -999;

/*3 calculate variable*/
if (p.au > topcut)
{
    p.au_cut = topcut;
}
else
{
    p.au_cut = p.au;
}
			
/*4 replace blank values with default*/
if (isNaN(p.au_cut))
{
    p.au_cut = -999;
}
			
/*5 make default values invisible*/
if (p.au_cut < 0)
{
    p.Visible = false;
}
else
{
    p.Visible = true;
}

1. Setting temporary variable

The var keyword will create a locally scoped variable which will last for the processing of a single point. This avoids having to create attributes which will only be needed for a single operation. JavaScript variables are dynamically typed, meaning the data type does not need to be specified.

Example: To define a topcut value of 20

var topcut = 20;

2. Adding and Deleting variables

To add a new variable, set the default value.

Example: To add au_cut field to samples

p.au_cut = -999;

Note:  The samples can be created using the Split by length modifier in the Domain Manager and the Point Extract tool.

This must be done outside of any guards, such as if or while statements, since it will need to be applied to every point before processing. It's also recommended to declare any new variables at the top of your script.

To delete, use the Delete macro. Since the delete macro is applied to the entire dataset at once, we needn't use the 'p.' namespace.

Delete(myAttribute);

3. Populate variable from a conditional formula

Note that variable names containing spaces can be called with the notation p[“<variable>”].

For example: LENGTH = p[“Bottom Depth”] – p[“Top Depth”]

if (p.au > topcut)
{
    p.au_cut = topcut;
}
else
{
    p.au_cut = p.au;
}

4. Set missing values to a default

If the referenced point is out of bounds and does not refer to a point in the dataset, any attributes will return a NaN value. This can be checked by using the built-in isNaN function. For example:

if (isNaN(p.au_cut))
{
    p.au_cut = -999;
}		

5. Visibility

Visible is a built-in attribute which can be used to change the visibility of a point, and is useful for filtering operations. It is used to hide points that have default value for grade. The Visible attribute can be set to 'true' or 'false'. For example:

if (p.au_cut < 0)
{
    p.Visible = true;
}
else
{
    p.Visible = false;
}

Note:  The visibility can later be adjusted with the Query and Filter, Attributes, and Show all options.