Identify Source Clusters

Use the Identify Source Clusters option (Geosoft.uxo.gxnet.dll(Geosoft.GX.UXO.UxaIdentifyUnexplainedItems;Run)*) to flag the unexplained ground truth items in the source database.

ClosedExpand to see the locations (menus) where this option is available.

UX-Analyze extension:

  • AGC Dynamic Data > Review Classification
  • AGC Static Data > Review Classification
  • AGC Expert User > Source and Library Management

Identify Source Clusters dialog options

Source Database

Name

Specify the source database name.

Script Parameter:UXANALYZE.SOURCEGDB

Group

Select the source group name.

Script Parameter:UXANALYZE.SOURCEGROUP

ID channel

Select the source ID channel name.

Script Parameter:UXANALYZE.TARGETID

Mask channel

Select the source mask channel name.

Script Parameter:UXANALYZE.TARGETMASK

Size channel

Select the source size channel name.

Default value is UXA_SIZE.

Script Parameter:UXANALYZE.TARGETSIZE

Type channel

Select the type channel name, which is a string channel.

If this channel is blank, all the sources in the group are matched against each other. If the channel is selected, the sources are grouped based on the ground truth values, then the matching is done.

Script Parameter:UXANALYZE.TARGETGROUNDTRUTH

Gates

Select the low and high gates, which will be passed to Perform Library Match that is executed in the background.

Default value for low gate is 14 in case of TEM2x2x3 and 8 for other sensors.

Default value for high gate is the maximum number of gates minus one.

Script Parameter:

  • UXANALYZE.LOGATE
  • UXANALYZE.HIGATE

Library Database

Name

Specify the signature library database name.

Library database is optional, and when it is blank, Group, Item description channel, and Library match metric will be disabled.

Script Parameter:UXANALYZE.LIBRARYGDB

Group

Select the signature library group name.

Script Parameter:UXANALYZE.LIBRARYGROUP

Item description channel

Select the item description channel name.

Script Parameter:UXANALYZE.LIBRARYID

Library match metric

Specify the library match metric, which is used to find the library items matching the source.

Default value is 0.95.

Script Parameter:UXANALYZE.LIBRARY_THRESHOLD

Source Cluster Output

Cluster suffix

Specify the cluster suffix.

When the dialog is run, a unique cluster ID is assigned to all the sources in that cluster. Starting cluster ID is 1.

Cluster ID channel name is: UXA)CLUSTER_ID_[SUFFIX].

In order to specify the main item in each cluster, UXA_UNIQUE_SIGNATURE_[SUFFIX] channel is also created. This channel is dummy for all the records except the main item in each cluster, which is assigned the cluster ID.

Script Parameter:UXANALYZE.TARGETCLUSTER_SUFFIX

Minimum match metric

Specify the cluster threshold, which is used to find the sources that are similar.

Default value is 0.95.

Script Parameter:UXANALYZE.MATCH_THRESHOLD

Minimum number of matches

Select the minimum number of matches (items) to define a cluster.

Default value is 3.

Script Parameter:UXANALYZE.MIN_NO_OF_MATCHES

Minimum polarization amplitude

Specify the minimum polarization amplitude, which will be passed to Perform Library Match that is executed in the background.

Default value is 0.001.

Script Parameter:UXANALYZE.MIN_BETA_AMP

Application Notes

Below are the processing steps used to flag the unexplained ground truth items in the source database.

Processing Steps

  • Sort the sources based on low gate of size channel.
  • Mask out the sources smaller than a minimum size, read from "uxa.config", for more information refer to uxa.config section below.
  • Run library match with 111 weights, and mask out items with a metric exceeding the Library threshold.
  • Mask out any sources without a valid library match, which is specified by -9999.
  • In order to speed up the process, put the sources into different bins based on the maximum number of sources in each bin. Each bin will overlap the adjacent bins by a percentage of the number of sources in each bin. The number of sources in each bin and the percentage overlap are read from "uxa.config".
    However, if you select a ground truth channel, the sources are put into bins based on the ground truth values (and no overlapping between bins occur).
  • Run self-match with 111 weights for each bin until all sources are masked out.

Output Files

The following channels are created:

UXA_CLUSTER_ID_[SUFFIX]

UXA_UNIQUE_SIGNATURE_[SUFFIX]

uxa.config

The minimum size and binning information can be found in "uxa.config", which can be located in C:\Program Files\Geosoft\Desktop Applications \etc folder:

<manageLibrary> <targetSize min="-1" /> <targetBin size="500" overlap="20" /> </manageLibrary>

*The GX tool will search in the "gx" folder. The GX.Net tools, however, are embedded in the Geosoft.uxo.gxnet.dll located in the bin folder. If running this GX interactively, bypassing the menu, first change the folder to point to the bin folder, then supply the GX.Net tool in the specified format.