Calculate Seed Statistics

Use the Calculate Seed Statistics option (Geosoft.uxo.gxnet.dll(Geosoft.GX.UXO.UxaCalculateSeedStatistics;Run)*) to generate statistics by comparing seed and source databases based on a set of source metrics and defined thresholds. You can plot a detailed report of the statistics, display the summary statistics on a map, or save the seed statistics to a report (CSV) file. The tool can be used both individually with physical seeds or in conjunction with synthetic seeding.

ClosedExpand to see where this option is available.

UX-Analyze extension:

  • AGC Dynamic Data
  • AGC Static Data
  • AGC Expert User

The following are accomplished when this tool is executed:

  • Quality control (QC) statistics are generated – comparing seed (known) and source (unknown) databases based on correct location and classification of seed items.
  • The seed database is updated with new (mask) channels for the seed statistics and source metrics that:
    • indicate which seeds passed the QC.
    • indicate which seeds failed the QC based on a defined Closedset of thresholds:
      Maximum horizontal (radial) distance(m)
      Maximum vertical/depth(BGS) distance(m)
      Minimum model fit coherence
      Maximum inverted and sensor distance(m)
      Maximum signal amplitude difference(%)
      Maximum size difference(%)
      Maximum decay difference(%)
  • The source database is updated with new channels for seed statistics.
  • A summary text file (CSV), map, and report (plot) can be produced.

Calculate Seed Statistics dialog options

Source Database

Name

Select the source database.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.SOURCE_DATABASE

Group

Select the group from the source database that will be compared to the seed items and used in calculating the statistics.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.SOURCE_GROUP

Mask channel

Select a mask channel. When this channel is set to 1, the action will be performed on the data entry; if the value is set to 0 or dummy (*), the corresponding data entry will be ignored.

This field is optional.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.SOURCE_MASK_CHANNEL

Size channel

Select the source database size channel.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.SOURCE_SIZE_CHANNEL

Decay channel

Select the source database decay channel.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.SOURCE_DECAY_CHANNEL

Seed Database

Name

Select the seed (truth) database. Ideally the seed database would be the 'source' database, but this can also be a manually created seed database.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.SEED_DATABASE

Group

Select the group from the seed database that will be compared to the source items and used for calculating the statistics.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.SEED_GROUP

Mask channel

Select a mask channel. When this channel is set to 1, the action will be performed on the data entry; if the value is set to 0 or dummy (*), the corresponding data entry will be ignored.

This field is optional.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.SEED_MASK_CHANNEL

Seed type

Select the seed type. To help identify the type of seeds, the following labels are available: Quality Control (QC), Validation, or Synthetic.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.SEED_TYPE

Seed Id channel

Select the seed Id channel. This channel must contain unique values for each seed item.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.SEED_ID_CHANNEL

Depth channel

Select the channel from the seed database that contains the depth of each seed. This will be used in matching seed items to source items.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.SEED_DEPTH_CHANNEL

Signal amplitude channel

Select the signal amplitude channel.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.SEED_SIGNAL_CHANNEL

Size channel

Select the seed database size channel.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.SEED_SIZE_CHANNEL

Decay channel

Select the seed database decay channel.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.SEED_DECAY_CHANNEL

Output

Create map

Check this option to create a summary map (.map) file. See the Application Notes below for more details.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.CREATE_MAP [0: No | 1: Yes (default)]

New map

Select this option if a new map should be created.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.CREATE_MAP_OPTION [0: New map (default)]

Existing map

Select this option if an existing map is used.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.CREATE_MAP [1: Existing map]

Name

Enter a name for the output map or select an existing map file (i.e., click the browse button [...] or expand the drop-down list).

Script Parameter: UX_CALCULATE_SEED_STATISTICS.OUTPUT_MAP_NAME

Map template (page)

Select a standard template to be used to define the map layout. The map layout includes the media size, map margins, and a basic map drawing style. This field is disabled when the Existing map option is selected.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.MAP_TEMPLATE_NAME

Map scale

Use the calculator button (Calculate button) located to the right of the field to display the default map scale. You can also modify the calculated value to a desired map scale. If left blank, a default scale will be chosen to fit the data range to the specified template. This field is disabled when the Existing map option is selected.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.MAP_SCALE

Map symbol size

Specify the seed symbol size in mm.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.MAP_SYMBOL_SIZE

Plot non-seeded sources

Select this option to plot the locations of sources that do not match the seed items.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.PLOT_NON_SEEDED

Plot legend

Check this option to plot a legend on the map.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.PLOT_LEGEND [0: No | 1: Yes (default)]

X Location (mm)

Specify the X location of the top-left corner of the legend.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.LEGEND_X_LOCATION

Y Location (mm)

Specify the Y location of the top-left corner of the legend.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.LEGEND_Y_LOCATION

Plot / text report name

Specify a name for the summary text file where the contents of your seed (truth) database will be saved. The summary plot file ('Seed Statistics Summary') that is generated will inherit the name entered for the text file.

Both summary documents, the text (CSV) file and the plot (PNG) file are saved in the sub folder ..\UXANALYZE_wrk\Seed Statistics.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.REPORT_NAME

[More]

Click to expand the Thresholds section and set the parameters for checking the source metrics.

Thresholds

Maximum horizontal (radial) distance (m)

Default is 0.25.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.MAX_HORIZONTAL_DISTANCE

Maximum vertical/depth (BGS) distance (m)

Default is 0.15.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.MAX_VERTICAL_DISTANCE

Minimum model fit coherence

Default is 0.8.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.MIN_MODEL_FIT

Maximum inverted and sensor distance (m)

Default is 0.4.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.MAX_FIT_DISTANCE

Maximum signal amplitude difference (%)

Default is 25.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.MAX_SIGNAL_DIFFERENCE

Maximum size difference (%)

Default is 10.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.MAX_SIZE_DIFFERENCE

Maximum decay difference (%)

Default is 25.

Script Parameter: UX_CALCULATE_SEED_STATISTICS.MAX_DECAY_DIFFERENCE

[Restore Defaults]

Click the button to reset all the parameters back to their default values.

Application Notes

A seed item is an Industry Standard Object (ISO), or inert munition buried at a recorded location and depth; it is used as a process quality check for munitions response tasks, including detection surveys, static/cued surveys, and anomaly recovery operations.

The types of physical seeds are:

  • Quality control (QC): the identity, location, and depth of the seed item are blind (not known) to all members of the survey team. Ideally, QC seeds are distributed such that the field teams can be expected to encounter between one and three seeds per day per team.
  • Validation: the identity, location, and depth of the seed item are blind to the contractor. Emplaced by, or on behalf of, the government, they are used to evaluate overall contractor performance on advanced geophysical classification projects.

How it Works

When the GX is run, the following steps are executed:

  1. The seed items are matched to the source items by: 

    • finding all the sources that are within one metre of a seed location.
    • selecting the closest TOI source to the seed location (i.e., a category 1 or 2). If none are TOI, the closest source is selected.
    • checking that the source is with horizontal distance then depth.
  2. For each seed item found to match to a source, the following channels are gathered from the source group: Closeddetermined from the source group:

    • UXA_FIT_X
    • UXA_FIT_Y
    • UXA_Fit_BGS
    • UXA_TARGET_ID
    • UXA_FIT_COH
    • UXA_diff_array_fit
    • UXA_SIG_AMPLITUDE
    • UXA_SIZE (low gate), user selected
    • UXA_DECAY (decay gate), user selected
    • UXA_Decision_Statistic
    • UXA_Category
    • UXA_UXOType
  3. ClosedThe QC metrics and statistics are calculated:

    • Horizontal (radial) offset distance (m)
    • Vertical/depth offset (m)
    • Fit coherence
    • Signal amplitude difference (%)
    • Size difference (%)
    • Decay difference (%)
Outputs

This tool creates several outputs:

  • Metrics within the Seed database
  • Metrics within a CSV file
  • Summary Plot
  • Summary Map (optional)
Databases

The GX creates the following channels in the seed and source databases:

Seed Database

  • ClosedChannels added to seed-source metrics:

    • UXA_SeedQc_Pass: indicates the seed was detected and passed the QC metrics. In this mask channel, '1' indicates a pass.

    • UXA_SeedQcFail_Dig: indicates if the matched source is not on the dig list. In this mask channel, '1' indicates a QC failure, and it can be used to subset the list for further investigations.

    • UXA_SeedQcFail_Fit_Coh: indicates if the matched source has less than the minimum model fit coherence. In this mask channel, '1' indicates a QC failure, and it can be used to subset the list for further investigations.

    • UXA_SeedQcFail_Diff_Array_Fit: indicates if the matched source exceeds the maximum distance between the inverted (fit) and sensor array locations. In this mask channel, '1' indicates a QC failure, and it can be used to subset the list for further investigations.

    • UXA_SeedQcFail_SIG_AMPLITUDE: indicates if the match source exceeds the maximum signal amplitude difference. In this mask channel, '1' indicates a QC failure, and it can be used to subset the list for further investigations.

    • UXA_SeedQcFail_Size: indicates if the match source exceeds the maximum size difference. In this mask channel, '1' indicates a QC failure, and it can be used to subset the list for further investigations.

    • UXA_SeedQcFail_Decay: indicates if the match source exceeds the maximum decay difference. In this mask channel, '1' indicates a QC failure, and it can be used to subset the list for further investigations.

  • ClosedChannels added for other source metrics:

    • UXA_Src_TARGET_ID: the unique id of the source

    • UXA_Src_Dist_Horz: the horizontal (radial) offset distance between the seed and the source

    • UXA_Src_Dist_Vert: the vertical offset calculated from the seed to source

    • UXA_Src_Offset_Azimuth: the declination or azimuth between the seed to source

    • UXA_Src_Offset_Inclin: the inclination from the seed to source

    • UXA_Src_Fit_Coh: the fit coherence of the source

    • UXA_Src_Diff_Array_Fit: the distance between the inverted (Fit) location of the source and the center of the sensor array

    • UXA_Src_SIG_AMPLITUDE: the source signal amplitude, the maximum monostatic signal

    • UXA_Src_Size (low gate): size at the low/first gate

    • UXA_Src_Decay (decay gate): decay at the decay gate

    • UXA_Src_Decision_Statistic: the classification decision statistic for the source

    • UXA_Src_Category: the classification category of the source

    • UXA_Src_UXOType: the source classification UXO type

    • UXA_Src_Multi_Matched: a list of other source IDs that also fall within the search volume

Source Database

Summary CSV File

A comma delimited file with the same columns added to the seed database, listed above.

Summary Map

The Data view of the map will contain Closedfour separate groups:

  • Seeds: marked with symbols that are rotated to match the calculated seed-source azimuth and labeled with the Seed Id (above centered):
    • Seeds_Detected (Pass): green circle symbol rotated to match the calculated seed-source azimuth and labeled with the Seed Id
    • Seeds_NotDetected (Fail): red circle symbol rotated to match the calculated seed-source azimuth, and labeled with the Seed Id
  • Sources: marked with symbols and labeled with the Seed Id (below centered):
    • Sources_Seeded: blue circle symbol (75% of the seed symbol size) and labeled with the Seed Id
    • Sources_NonSeeded: grey circle symbol (50% of the seed symbol size) and labeled with the Seed Id

The Base view Legend group will contain the Closedfollowing items:

  • Number and percentage of seeds (detected)
  • Number and percentage of seeds (not detected)
  • Number of sources (seeded)
  • Number of sources (non-seeded)
  • Total number of seeds
  • Number and percentage of seeds (passing)
  • Number and percentage of seeds (passing) on the dig list
  • Statistics Table: Minimum / Maximum / Mean / Standard Deviation for:
    • Horizontal (radial) offset distance (m)
    • Vertical/depth offset (m)
    • Fit coherence
    • Signal amplitude difference (%)
    • Size difference (%)
    • Decay difference (%)
  • Seed database
    • Name:
    • Group:
    • Type: e.g., Quality Control, Synthetic
  • Source database
    • Name:
    • Group:
    • Created: YYYY-MM-DD, hh:mm:ss

Summary Report Plot

The plot will report on the following Closedsummary items:

  1. Title: "Seed Statistics Summary"
  2. File details and date:
    • Seed database
      • Name
      • Group
      • Type (e.g., Quality Control)
    • Source database
      • Name
      • Group
    • Created: YYYY-MM-DD, hh:mm:ss
  3. Summary
    • Total number of seeds
    • Number and percentage of seeds (detected)
    • Number and percentage of seeds (not detected)
    • Number and percentage of seeds (passing)
    • Number and percentage of seeds (passing) on the dig list
  4. Table of statistics - Minimum / Maximum / Mean / Standard Deviation for:
    • Horizontal (radial) offset distance (m)
    • Vertical/depth offset (m)
    • Fit coherence
    • Signal amplitude difference (%)
    • Size difference (%)
    • Decay difference (%)

Seed Types - Definition:
  • "Detected": the seed was matched to a source
  • "Passing": the seed was matched to a source and passed the metrics checks

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