Background Location Validation Test
Use the Background Location Validation Test option, (Geosoft.uxo.gxnet.dll(Geosoft.GX.UXO.UxaBackgroundValidationTest;Run)*), to determine whether a specific field location is suitable for background measurements.
 Expand to see the locations (menus) where this option is available.
Expand to see the locations (menus) where this option is available.
UX-Analyze extension:
- AGC Static Data > Sensor Tests and QC Tools
- AGC Expert User > Static Data Prep and QC
Background Location Validation Test dialog options
| Raw Background Validation Data | |
| Database prefix | Select the prefix for the background locations databases that contain the raw background location validation measurements (SBR). Script Parameter:UXANALYZE.BKGTEST_RECONPREFIX | 
| Group name | Select the group name. Script Parameter:UXANALYZE.BKGTEST_RECONGROUP | 
| Mask channel | Select the mask channel. Script Parameter:UXANALYZE.BKGTEST_TARGETMASK | 
| TOI Reference Data | |
| Database prefix | Select the prefix for the databases containing the data for the TOI reference item. Script Parameter:UXANALYZE.BKGTEST_TOIPREFIX | 
| Group name | Select the group name. Script Parameter:UXANALYZE.BKGTEST_TOIGROUP | 
| ID channel | Select the ID channel. Script Parameter:UXANALYZE.BKGTEST_IDCHANNEL | 
| TOI description channel | Select the channel that contains description of the TOI. Script Parameter:UXANALYZE.BKGTEST_DESCRCHANNEL | 
| Selected TOI | Pick the TOI to use for the test. The list is populated from the values in Description channel. Script Parameter:UXANALYZE.BKGTEST_SELE…DTOI | 
| Response data channel | Select the channel that contains the TOI response data. Script Parameter:UXANALYZE.BKGTEST_DATACHANNEL | 
| [More] | |
| Background cluster distance (m) | Specify the search distance that is used to identify clusters of measurements for test location. Default value is 1.5 times the cart width (see the SBR Target database, UXA_Cart). The factor is defined in the configuration file, clusterWidthvalueMultiplier. Script Parameter:UXANALYZE.BKGTEST_SENSORWIDTH | 
| Min. reference to surrounding measurement (m) | Specify the minimum distance from the reference background (centre) to the surrounding measurements. Default value is 0.25 times the cart width (see the SBR Target database, UXA_Cart). The factor is defined in the configuration file, clusterWidthminMultiplier. Script Parameter:UXANALYZE.BKGTEST_MINDIST | 
| Max. reference to surrounding measurement (m) | Specify the maximum distance from the reference background (centre) to the surrounding measurements. Default value is 1.0 times the cart width (see the SBR Target database, UXA_Cart). The factor is defined in the configuration file, clusterWidthmaxMultiplier. Script Parameter:UXANALYZE.BKGTEST_MAXDIST | 
| Sum of TOI to background amplitude threshold (m3/s) | Specify the sum of TOI to background amplitude threshold. Default value is 2.5. Script Parameter:UXANALYZE.BKGTEST_SUMOFAMPLITUDETHRESHOLD | 
| Minimum polarization amplitude (mV) | Specify the minimum beta value. Default value is 0.001. Script Parameter:UXANALYZE.BKGTEST_MINBETA | 
| TOI match metric | Specify the minimum combined match metric between the background measurements and the TOI. This threshold should define a high confidence TOI classification. Default value is 0.85. Script Parameter:UXANALYZE.BKGTEST_MATCHTHRESH | 
| Background difference window start gate | Select the start gate to be used to calculate the sum of absolute differences between the reference background and the surrounding measurements. Default value is the first valid time gate (determined from UXA_GateFirstValidTime). Script Parameters:UXANALYZE.BKGTEST_STARTGATE | 
| Background difference window end gate | Select the end gate to be used to calculate the sum of absolute differences between the reference background and the surrounding measurements. Default value is the first valid time gate plus two gates. Defined in the configuration file, windowGatesNumber. Script Parameter:UXANALYZE.BKGTEST_ENDGATE | 
| Background location ID | The background location (cluster) ID can be generated automatically if Auto generate is selected. The starting number is 1. The current flag ID can also be used as the location, if the Use flag ID is selected. Default value is Auto generate. Script Parameter:UXANALYZE.BKGTEST_LOCATIONID_METHOD | 
Application Notes
*The Invert for Sources (Static) option is located under the AGC Expert User > Invert Data menu.
At the start of your project, establish background measurement locations to remove the effects of instrument drift and geology on the survey measurements. Additional locations can be defined as needed throughout the project.
To ensure a location is suitable for background measurements, confirm the following:
- The area is "clean", i.e., free from metallic objects in the vicinity.
- A TOI (Target of Interest) is detectable above the background noise level.
The background test involves a static measurement at a central (reference) location, along with at least four surrounding measurements. These surrounding measurements should be placed at a distance of ½ sensor width from the initial reference location and distributed evenly.
For example:
1 202 4
You'll also need to provide a reference TOI representing the worst-case scenario—specifically, the smallest TOI at the maximum required detection depth—to demonstrate detectability above background noise.
TOI data can be generated using either of the following methods:
- Calculation: Use library data to calculate the item's response — see Calculate Forward Model. 
- Data Collection: Gather and process data from an item on a test stand (Import, Level, and Invert). 
Process
The Background Location Validation Test tool performs the following steps:
- Manage the Data- Group or cluster the measurements to identify background locations.- Determine which measurements fall within the background cluster distance of each other.
- Assign a sequential Background ID to each valid background test location.
- Label each measurement with the associated Background ID.
 
- Determine which measurement is the centre (reference) background location ID.
- Label measurements - assign Location IDs as follows:- Centre location is labeled 0.
- Surrounding measurements are labeled 1 to n, based on heading (i.e., ordered clockwise from North).
 
 
- Group or cluster the measurements to identify background locations.
- Check Location- Calculate the distance and heading of each surrounding measurement relative to centre (reference location).
- Identify measurements that are:
- Too close (Min. reference to surrounding measurement) from the centre/reference location.
- Too far (Max. reference to surrounding measurement) from the centre/reference location.
- Identify measurements that are not evenly distributed around the centre/reference location:
- Ensure no more than ~120° of angular separation between any two consecutive surrounding measurements.
- Subtract the centre (reference) measurement from each surrounding measurement (levelling the data to reference location).
- Identify surrounding measurements where the difference of the sum of absolute value for the response (between the Background difference window start and end) is greater than the Sum of TOI to background amplitude threshold.
- Identify background locations with fewer than four valid surrounding measurements–as defined by surroundingMeasTolerance in the configuration file.
 
- Check Noise and TOI Detectability- Add the TOI response data to the surrounding measurements:- Invert the surrounding measurements to solve for a single object.
- Determine a combined library match with the TOI item. The combined match metric is the average of 111, 110, 011, and 100 match metrics.
 
- Identify background locations with fewer than four valid surrounding measurements.
 
- Add the TOI response data to the surrounding measurements:
Output
- Static Background Validated (SBV) Databases 
 Two types of databases will be generated as part of the output:
- Target database – contains measurement metrics for each surrounding location as array channels. There will be two  groups of background measurements:- Validated: background locations that can be used for subsequent survey background QC checks and levelling.
- Failed: background locations that did not pass validation criteria.
 
- Data database – stores measurement data only for the valid background locations.
- Summary Report/Table (CSV Format)
 A tabular report will be generated with the following columns:- Location ID
- Pass/Fail
- X
- Y
- Combined metric match for each surrounding location (1 to n)
- Difference in sum of absolute response values Window start to Window end for each surrounding location (1 to n)
 
- Map and Summary Plot:- Generate a map that shows all the background locations with labels - clearly mark the background locations that fail, along with the date/time.
- Generate a plot for each background location that shows:- The locations of all the measurements with labels - for failed surrounding measurements, the symbols are highlighted in red.
- Polarization plots – show the polarization curves for each surrounding measurement (see below). For failed surrounding measurements, the plot title is highlighted in red.
- TOI response in blue
- TOI reference item in red.
- Amplitude plot - displays for each surrounding measurement the sum of absolute response value for each gate, along with that of the TOI reference item.
- A table listing the surrounding measurement statistics. Failed   measurements are indicated with an asterisk (*):- Surround measurement location ID
- The distance from surrounding measurement to reference measurement
- The azimuth in degrees to surrounding measurements
- Sum of the response over Window start to Window end
- Combined match metric to the TOI Reference Item
- Sensor ID
- Low gate
- High gate
- Minimum beta (polarization) amplitude
 
 
 
Duplicate Identifiers
When writing to an existing output database, the GX performs a validation step:
- It checks whether any input flag IDs already exist in the output database. 
- If a duplicate ID is detected, the system will issue a warning and prompt the user with two options: 
- Manual Correction: Edit the input data and manually assign a new, unique flag ID to all records within the flagged cluster.
- Auto-Generate Option: Select Auto generate to create a new background location ID, calculated as: max(existing background location ID) + 1
*The GX tool will search in the gx folder. The GX.Net tools, however, are embedded within the Geosoft.uxo.gxnet.dll located in the bin directory. If running this tool interactively, bypassing the menu, change the folder to point to the bin directory, then ensure the GX.Net tool is supplied in the correct format when called directly.
Got a question? Visit the Seequent forums or Seequent support
Copyright (c) 2025 Bentley Systems, Incorporated. All rights reserved.
Privacy | Terms of Use
