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.
Expand 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
set 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)]
| ||||||||||||||||
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 ( 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)]
| ||||||||||||||||
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 |
|
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:
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.
For each seed item found to match to a source, the following channels are gathered from the source group:
determined 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
The 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
Channels 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.
Channels 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
Channels added to identify the sources that are matched to seeds:
UXA_Seed_Id: the unique id of the seed
UXA_Seed_Type: the type of seed
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
four 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
- 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_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
following 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
- Horizontal (radial) offset distance (m)
- Vertical/depth offset (m)
- Fit coherence
- Signal amplitude difference (%)
- Size difference (%)
- Decay difference (%)
- Name:
- Group:
- Type: e.g., Quality Control, Synthetic
- Name:
- Group:
- Created: YYYY-MM-DD, hh:mm:ss
Summary Report Plot
The plot will report on the following
summary items:
- Title: "Seed Statistics Summary"
- File details and date:
- Seed database
- Name
- Group
- Type (e.g., Quality Control)
- Source database
- Name
- Group
- Created: YYYY-MM-DD, hh:mm:ss
- 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
- 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.
See Also:
Got a question? Visit the Seequent forums or Seequent support
© 2024 Seequent, The Bentley Subsurface Company
Privacy | Terms of Use