Classify and Rank (Dynamic)

Use the AGC Dynamic Data > Classify and Rank menu option (Geosoft.uxo.gxnet.dll(Geosoft.GX.UXO.UxaDynClassifyRank;Run)*) to classify and rank sources from dynamic data using sensors capable of one-pass classification. The tool performs modeling, library matches, self matches, and creates a prioritized dig list and a final QC environment with graphics.

Classify and Rank (Dynamic) dialog options

Databases

Target Database

Databases prefix

Select the databases prefix.

Script Parameter: UXANALYZE.PROCESS_DATA_DBPREFIX

Target group

Select the target group.

Script Parameter: UXANALYZE.TARGETGROUP

Source group

Select the source group to store the results from inversion /modelling the data with an n-dipole solver.

Script Parameter:UXANALYZE.SOURCEGROUP

ID channel

Select the ID channel.

Script Parameter: UXANALYZE.TARGETID

Mask channel

Select the target database mask channel to filter out specific targets. When this channel is set to 1, the action will be performed on the target. If the value is set to 0 or dummy (*), the corresponding target will be ignored.

Script Parameter: UXANALYZE.TARGETMASK

Mask channel - all sources

Select the secondary mask channel, which will be used in some of the options that are part of this dialog.

Script Parameter: UXANALYZE.TARGETMASK2

Survey data channel

Select the data channel.

  • The data channel is an array channel.

    • Script Parameter: UXANALYZE.SENCHAN

    Gates

    Select the low, high, and decay time gates from the list. The low and high gates limit the range of data used when modelling the data. The decay along with the low gate is used to determine the decay for an item.

    Default value for low gate is read from the Target database channel 'UXA_gateFirstValidTime'.

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

    Default value for decay gate is the gate closest to 1ms after current turn off.

    Script Parameter:

    • UXANALYZE.LOGATE

    • UXANALYZE.HIGATE
    • UXANALYZE.THRESHOLDGATE

    Time of gates (ms)

    This is a read-only parameter that displays the time of gates from the Survey database.

    Amplitude grid

    Specify the signal amplitude anomaly grid file name.

    Script Parameter: UXANALYZE.DYN_AMP_GRID

    Model coherence grid

    Specify the model coherence anomaly grid file name.

    Script Parameter: UXANALYZE.DYN_COH_GRID

    Library Database

    Name

    Select the signature library database.

    This library is a Geosoft database containing the polarizabilities and other parameters for a variety of known items.

    Script Parameter: UXANALYZE.LIBRARYGDB

    Group - TOI

    Select the library group for TOI (target of interest) items only.

    Script Parameter: UXANALYZE.LIBRARYGROUP_TOI

    Group - Clutter

    Select the library group for items that are known to be clutter items.

    Script Parameter: UXANALYZE.LIBRARYGROUP_CLUTTER

    Item description channel

    Select the item description channel. This channel must contain unique values for each library item.

    Script Parameter: UXANALYZE.LIBRARYID

    Tools

    Tools

    The following tools can be executed as part of the Classify and Rank process:

    • Invert for sources (this also includes the Inversion QC and Calculate Size and Decay)
    • Perform library match
    • Perform self match / identify clusters
    • Identify similar items
    • Set thresholds and prioritize
    • See the 'See Also' links for more information on these options.

    The Settings button for each option enables you to change some of the parameters specific to that option. Note that some of the parameters are read-only, because they have already been captured as part of the current dialog.

    Script Parameter:

    • UXANALYZE.MODELING_SELECTED
    • UXANALYZE.LIBRARY_MATCH_SELECTED
    • UXANALYZE.LIBRARY_MATCH2_SELECTED
    • UXANALYZE.SIMILAR_ITEMS_SELECTED
    • UXANALYZE.RANK_SELECTED

    Minimum model coherence

    Specify a model coherence anomaly grid value below which you want peaks to be removed from the list. Required if a model coherence anomaly grid was selected. The default value is 0.1.

    To help determine a reasonable threshold, you can use the Determine Coherence Threshold tool.

    Script Parameter: UXANALYZE.COH_THRESHOLD

    Minimum amplitude

    Specify the amplitude anomaly grid value below which you want peaks to be removed from the list. The default value is 0.5.

    Script Parameter: UXANALYZE.AMP_THRESHOLD

    Chi2 threshold

    Enter the chi-squared threshold. Chi-squared, the goodness of the model fit; a measure of the difference of between the modelled and measured data.

    Default value is 50.

    Script Parameter:UXANALYZE.CHI2THRESHOLD

    Self match cluster threshold

    Specify the threshold for the metric match to consider the item a self match and similar to other items in the source database.

    Default value is 0.95.

    Script Parameter:UXANALYZE.MATCH_THRESHOLD

    Min polarization amplitude

    Specify the minimum polarization amplitude used when performing library matches.

    Default value is 0.001.

    Script Parameter: UXANALYZE.MIN_BETA_AMP

    Fit coherence

    Specify the minimum acceptable fit coherence used when performing Inversion QC and Set Thresholds and Prioritize.

    Default value is 0.8.

    Script Parameter: UXANALYZE.MIN_FIT_COHERENCE

    Difference - array position & inverted location (m)

    Specify the maximum distance between the array position and the inverted location used when performing Inversion QC and Set Thresholds and Prioritize.

    Default value is 0.4.

    Script Parameter: UXANALYZE.MAX_DIFF_ARRAY_INV_LOCATION

    Difference - array position & flag location (m)

    Specify the maximum distance between the array position and the flag location used when performing Inversion QC and Set Thresholds and Prioritize.

    Default value is 0.75.

    Script Parameter: UXANALYZE.MAX_DIFF_ARRAY_FLAG_LOCATION

    Difference - flag location & inverted location (m)

    Specify the maximum distance between in the flag location and the inverted location used when performing Inversion QC and Set Thresholds and Prioritize.

    Default value is 0.6.

    Script Parameter: UXANALYZE.MAX_DIFF_FLAG_INV_LOCATION

    Minimum size

    Specify the minimum size; any sources (values in the channel 'UXA_Size' at the low gate) that have a size less than this value would fail the Inversion QC.

    Default value is -1.5.

    Script Parameter: UXANALYZE.MIN_SIZE

    Maximum decay

    Specify the maximum decay; any sources (values in the channel 'UXA_Decay' at the decay gate) that have a decay greater than this value would fail the Inversion QC.

    Default value is 1.

    Script Parameter: UXANALYZE.MAX_DECAY

    Plots

    Create decay plot - measured vs modeled

    Select Create decay plots - measured vs modeled to show curves for both the measured and modelled data. The plots are saved in your project folder /UXANALYZE_wrk.

    The Settings button enables you to change some of the parameters. Note that some of the parameters are read-only, because they have already been captured as part of the current dialog.

    Script Parameter: UXANALYZE.DECAY_MAP_SELECTED

    Create data map

    Select Create data map, which includes the measure and modelled data. The maps are saved in your project folder /UXANALYZE_wrk.

    The Settings button enables you to change some of the parameters. Note that some of the parameters are read-only, because they have already been captured as part of the current dialog.

    Script Parameter: UXANALYZE.DATA_MAP_SELECTED

    Create polarization plot with library (single source)

    Select the Create polarization plots with library (single source) using the results from the single object solver that shows the six (6) best library matches The plot is saved in your project folder /UXANALYZE_wrk. .

    Preset indicates that the settings for this plot are already set.

    Script Parameter: UXANALYZE.POL_MAP_SELECTED

    Create polarization plot with library (n-dipole sources)

    Select Create polarization plots with library (multiple sources) using the results from the multiple object solver that shows the six (6) best library matches. The plot is saved in your project folder /UXANALYZE_wrk.

    Preset indicates that the settings for this plot are already set.

    Script Parameter: UXANALYZE.POL_MAP2_SELECTED

    Create polarization plot with library (cluster)

    Select Create polarization plots with library (cluster) using the results from the multiple object solver and self-match that shows the best library match and, if present, other similar items The plot is saved in your project folder /UXANALYZE_wrk.

    Preset indicates that the settings for this plot are already set.

    Script Parameter: UXANALYZE.POL_MAP3_SELECTED

    Create size and decay plot (cluster)

    Select Create Size and decay plot (cluster) using the results from the multiple object solver self-match (if selected on the Database Tab). The current target (source) is highlighted, the symbols are coloured based on the number of items in a self-match cluster, with the members of the current shown in bold, other items are faded. The plot is saved in your project folder /UXANALYZE_wrk.

    The Settings button enables you to change some of the parameters. Note that some of the parameters are read-only, because they have already been captured as part of the current dialog.

    Script Parameter: UXANALYZE.SIZEDECAY_PLOT_CLUSTER_SELECTED

    Create size and decay plot (classify)

    Select Create Size and decay map (classify) using the final (combined) ranking (if selected below). Otherwise, plots will be created using the multiple object solver (if selected on the Database Tab) solutions. The plot is saved in your project folder /UXANALYZE_wrk.

    The current target (source) is highlighted, the symbols are coloured based on the standard UX-Analyze categorization.

    The Settings button enables you to change some of the parameters. Note that some of the parameters are read-only, because they have already been captured as part of the current dialog.

    Script Parameter: UXANALYZE.SIZEDECAY_PLOT_CLASSIFY_SELECTED

    Create source classification-decision plot

    Select Create source classification-decision plot that includes the select (classify) plots and maps using the final (combined) ranking. The plot is saved in your project folder /UXANALYZE_wrk.

    The Settings button enables you to change some of the parameters. Note that some of the parameters are read-only, because they have already been captured as part of the current dialog.

    Script Parameter: UXANALYZE.SOURCE_CLASS_SELECTED

    Create interactive image view (classify)

    Select Create interactive image view (classify) of the selected (classify plots).

    Preset indicates that the settings for this plot are already set.

    Script Parameter: UXANALYZE.VIEWER_CLASSIFY_SELECTED

    Create plots based on final ranking

    Select Create plots based on final "combined" ranking of the modeling or inversion results. On the Tools tab, you should select "Perform self match / identify clusters", "Identify similar items", and "Set thresholds and prioritize" if you are re-running Classify and Rank. Depending on your selections for previous runs, this will ensure only the sources in the final list are used for clustering and that sources are ranked as expected.

    Script Parameter: UXANALYZE.USE_FINAL_RANKING

    Plot/map prefix

    Specify the prefix used to name the output plots or maps.

    Script Parameter: UXANALYZE.MAP_PREFIX

    [Restore Defaults]

    		Selecting the Restore Defaults button returns all of the parameters to their default values.
  • The sensor configuration is set from the import and can be reviewed using our Edit Metadata tool, which can be accessed via Utilities > Edit Internal Metadata.

    • Application Notes

    Once the project library has been validated, the final step is to classify and rank the targets (and calculated sources) as to the likelihood that they are targets of interest (TOI). The Classify and Rank option enables you to perform modeling, library matches, self-matches, classify source objects, and create a prioritized dig list along with final maps and plots to aid data processing review and quality control. To create the final prioritized dig list, for each target (flag), the chosen solution (single or multi solver) is the one that has the highest match to a target of interest.

  • Running a script in a new project with new database files may fail due to a missing directory that is recorded in the script file. The following lines must be commented out ( / ) of the script file:
    /SAVEINI .\UXANALYZE_wrk\interim_files\__process_data_temp.ini,UXANALYZE
    /APPENDINI .\UXANALYZE_wrk\interim_files\__process_data_temp.ini,UXACLASSIFICATION
    /APPENDINI .\UXANALYZE_wrk\interim_files\__process_data_temp.ini,UXAPOLARIZATIONMAP

    • *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.

    See Also: