2d estimation

2d estimation

2d estimation performs parameter estimation using kriging and other methods to map 2D analytical data onto surface grids defined by the limits of the data set as rectilinear or convex hull extents of the input data.

Its Adaptive Gridding feature further subdivides individual elements to place a “kriged” node at the location of each input data sample. This guarantees that the output will accurately reflect the input at all measured locations (i.e. the maximum in the output will be the maximum of the input).

The DrillGuide functionality produces a new input data file with a synthetic boring at the location of maximum uncertainty calculated from the previous kriging estimates, which can then be rerun to find the next area of highest uncertainty. The naming of the “DrillGuide©” file which is created when 2d estimation is run with all types of analyte (e.g. chemistry) files ends in apdv1, apdv2, apdv3, etc. There are no limits to the number of cycles that may be run.

2d estimation also provides special data processing options that allow it to extract 2-dimensional data sets from input data files containing three-dimensional data, and allows detailed analyses of property characteristics along 2-dimensional planes through the data set. The module also provides options to magnify or distort the resulting grid by the kriged value of the property at each grid node, and allows automatic clamping of the data distribution along a boundary offset from the convex hull of the data domain.

Variogram Options:

There are three variogram options:

  1. Spherical: the default and recommended choice for most applications
  2. Exponential: generally gives similar results to Spherical and may be superior for some datasets
  3. Gaussian: notoriously unstable, but can “smooth” your data with an appropriate nugget. Without a nugget term, Gaussian is generally unusable. If you find that Gaussian kriging is overshooting the plume, your nugget is likely too small; if the plume looks overly smooth, your nugget is likely too big.

Ports

DirectionNameTypeDescription
InputInput External GridFieldA field containing an external grid to use for the output. (Advanced Version Only)
InputInput External DataFieldA field containing external data to use instead of reading a file. (Advanced Version Only)
InputInput FilenameStringFile used to estimate analytical data.
OutputOutput FilenameStringFile used to estimate analytical data.
OutputOutput FieldFieldThe main output field with analytical data added.
OutputStatus InformationStringText containing the full status information output from the module.
OutputSurfaceRenderableA renderable object displaying the component surface.
OutputAnalytical Grid DataRealizationInformation required for direct exporting of raw analytical grid data.

Properties

Grid Settings

PropertyTypeDescription
Grid TypeChoice: Rectilinear, Convex HullThe type of grid to create for interpolation. Convex Hull creates a model with irregular boundaries defined by the extent of the measured data points.
Grid CoordinatesCoordinatesDefines the coordinate domain within the data set in which kriging will be completed. Min and Max values are only used when Rectilinear is selected.
X ResolutionIntegerThe number of grid nodes in the model horizontal domain.
Y ResolutionIntegerThe number of grid nodes in the model vertical domain.
Adaptive GriddingBooleanRefines the grid automatically to place grid nodes at all measured data points, ensuring the output honors all measured locations exactly.
Adaptive Gridding LimitIntegerTurns off adaptive gridding when the number of sample points exceeds this value.
Boundary OffsetDoubleThe distance in user units that the grid coordinate range for the kriging domain will be set outside of the actual coordinate range of the data.

Data Processing

PropertyTypeDescription
Data ProcessingChoice: Linear Processing, Log ProcessingAllows the module to be run in either linear or log space.
Data ScalingDoubleA value by which all nodal data values will be multiplied before kriging.
Pre Clip MinDoubleAny nodal property value less than this number will be replaced during preprocessing.
Pre Clip MaxDoubleAny nodal property value greater than this number will be replaced during preprocessing.
LT MultiplierDoubleApplied when reading a file with values flagged with the ‘<’ character. Multiplies the file value by this multiplier.
Detection LimitDoubleAffects file values set with the ‘ND’ or other non-detect flags. The module inserts a value equal to (Detection Limit * LT Multiplier).
Collapse MethodChoice: Max, MinThe method for extracting data within a depth interval when multiple samples exist. Duplicate samples at the same x, y, z coordinates are averaged first.
Distance To CollapseDoubleThe maximum distance in 2D that points will be considered coincident. Coincident points will be dropped depending on the Collapse Method.
Post Clip MinDoubleThe smallest nodal value that will be present in the output data field.
Post Clip MaxDoubleThe largest nodal value that will be present in the output data field.
Auto Exponentiate External Log DataBooleanDetects if data imported via the External Data port has been log processed and exponentiates it, avoiding double log processing.
External DataMulti-selectSelects which data components from the External Data port to use for interpolation.

Time Settings

PropertyTypeDescription
Chem File Is Time DomainBooleanCauses the file to be read as a time file, with values interpolated first to the set date and then to the grid.
Specify Date By ComponentBooleanAllows the Data Component value to select a date, resulting in exact data at a date instead of an interpolated value.
Date For InterpolationDateThe date of interest. Used with the Interpolation Type to determine the value of a sample before interpolation onto the grid.
Analyte NameStringThe analyte name for date files.
Date Interpolation MethodChoice: Direct Interpolation Only, Interpolate Only, Interpolate and Extrapolate Beyond, Interpolate and ExtrapolateDefines how to interpolate when given unsampled times in a file.
TCF File NameFileThe output TCF file name. When the module runs, it loops through each component and creates an EFB file; the dates and filenames are added to the TCF file.
Create TCFButtonCauses the module to run in a loop, going through each component and creating an EFB file at that time. These EFB files are linked together in the specified TCF file.

Krig Settings

PropertyTypeDescription
Estimation TypeChoice: Kriging, IDW (Shepard), IDW (Franke/Nielson), Nearest Neighbor, FastRBF, Natural NeighborsThe method for interpolating file data onto the created grid.
Use GradientsBooleanUsed with Natural Neighbor interpolation. When on, gradients estimated at sample points improve the interpolation result.
ReachDoubleThe radial distance from any given model node that the module will look for data points. Setting to 0 causes the module to calculate a reach approximately two-thirds of the longest distance between any two data points.
Points In ReachIntegerThe maximum number of data points within the reach to consider for parameter estimation at a model node.
Quadrant SearchBooleanWhen selected, searching is performed for each of the four quadrilaterals surrounding the point to be kriged.
Use All PointsBooleanCauses the module to include samples up to the All Points Limit value. If the number of samples exceeds the limit, Reach and Points In Reach settings are used.
All Points LimitIntegerThe maximum number of points to use when interpolating. If there are more samples than this value, Reach and Points In Reach settings will be used.
Statistical Confidence ToleranceDoubleSpecifies the interval in linear space around the kriged model estimates to which the kriging confidence or uncertainty applies.
Statistical Confidence FactorDoubleSpecifies the interval in log space around the kriged model estimates to which the kriging confidence or uncertainty applies.
Min Max ConfidenceDoubleSpecifies the interval around the kriged model estimates to which the kriging confidence or uncertainty applies.
IDW PowerDoubleUsed with Inverse Distance Weighting. Greater values increase the influence of values closest to the interpolated point.
Variogram And AnisotropyVariogramControls the semi-variogram model and anisotropy settings for kriging.

Data To Export

PropertyTypeDescription
Auxillary Kriging DataMulti-select: Max Plume, Min Plume, Statistical Confidence, Standard Deviation, Statistical UncertaintySelects which data components generated during kriging to include in the output field on a node by node basis. Available when using Kriging estimation.

Display Settings

PropertyTypeDescription
Display Output SurfaceBooleanControls whether the output surface is displayed.
Surface Distortion ComponentChoiceSets the z value at each node to the selected nodal data component, distorting the surface. Can be linked to or independent from the displayed component.
Display Sphere ToggleMulti-selectTurns on or off the spheres representing the locations of maximum uncertainty.

Variography Display

PropertyTypeDescription
Display Variogram EllipseBooleanDisplays the variography ellipse in the viewport.
Ellipse OpacityDoubleSets the opacity of the ellipse.
ResolutionIntegerThe resolution of the ellipse. Larger numbers create more detailed representations.
Ellipse ScaleDoubleScales the ellipse equally along each axis.
X OffsetDoubleTranslates the ellipse along the x axis.
Y OffsetDoubleTranslates the ellipse along the y axis.
Z OffsetDoubleTranslates the ellipse along the z axis.
Ellipse ColorColorThe color of the variogram ellipse.
Display Variogram LinesBooleanDisplays lines aligned with the variography ellipse.
Line ScaleDoubleA scalar that sets the length of the variogram lines relative to the scale of the ellipse.
Primary Ratio ColorColorThe color of the primary ratio axis line.
Secondary Ratio ColorColorThe color of the secondary ratio axis line.

Drill Guide

PropertyTypeDescription
Create DG FileButtonRuns the module in a loop, creating a synthetic boring at the maximum uncertainty location until the Number Of Synthetic Samples is reached.
Number Of Synthetic SamplesIntegerControls how many times drill guide will run.
Target ConcentrationBooleanWhen selected, changes the location of the uncertainty sphere based upon the specified Target Isolevel.
Target IsolevelDoubleWhen Target Concentration is selected, this value is used to change the location of the uncertainty sphere.
User PointsCoordinatesManages points added to the grid for drill guide purposes to eliminate areas of high uncertainty that cannot be drilled, such as under a building.

General

PropertyTypeDescription
Allow RunBooleanControls whether the module will run when applications are loaded or data changes. When off, the module will not run unless Execute is pressed.
FilenameFileThe file containing the data to interpolate onto the created grid.
Data ComponentIntegerSelects which property value in the analyte file will be kriged. The default value of -1 results in kriging of all data components in the file.
Data PriorityChoice: Maximum Values, Minimum ValuesAffects which samples are adaptively gridded.
ExecuteButtonForces the module to run. If pressed and the application saved, the module will run when the application is loaded.
Z ScaleDoubleThe vertical exaggeration to apply to the variogram, the uncertainty sphere, and the output surface.