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:
- Spherical: the default and recommended choice for most applications
- Exponential: generally gives similar results to Spherical and may be superior for some datasets
- 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
| Direction | Name | Type | Description |
|---|---|---|---|
| Input | Input External Grid | Field | A field containing an external grid to use for the output. (Advanced Version Only) |
| Input | Input External Data | Field | A field containing external data to use instead of reading a file. (Advanced Version Only) |
| Input | Input Filename | String | File used to estimate analytical data. |
| Output | Output Filename | String | File used to estimate analytical data. |
| Output | Output Field | Field | The main output field with analytical data added. |
| Output | Status Information | String | Text containing the full status information output from the module. |
| Output | Surface | Renderable | A renderable object displaying the component surface. |
| Output | Analytical Grid Data | Realization | Information required for direct exporting of raw analytical grid data. |
Properties
Grid Settings
| Property | Type | Description |
|---|---|---|
| Grid Type | Choice: Rectilinear, Convex Hull | The 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 Coordinates | Coordinates | Defines 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 Resolution | Integer | The number of grid nodes in the model horizontal domain. |
| Y Resolution | Integer | The number of grid nodes in the model vertical domain. |
| Adaptive Gridding | Boolean | Refines the grid automatically to place grid nodes at all measured data points, ensuring the output honors all measured locations exactly. |
| Adaptive Gridding Limit | Integer | Turns off adaptive gridding when the number of sample points exceeds this value. |
| Boundary Offset | Double | The 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
| Property | Type | Description |
|---|---|---|
| Data Processing | Choice: Linear Processing, Log Processing | Allows the module to be run in either linear or log space. |
| Data Scaling | Double | A value by which all nodal data values will be multiplied before kriging. |
| Pre Clip Min | Double | Any nodal property value less than this number will be replaced during preprocessing. |
| Pre Clip Max | Double | Any nodal property value greater than this number will be replaced during preprocessing. |
| LT Multiplier | Double | Applied when reading a file with values flagged with the ‘<’ character. Multiplies the file value by this multiplier. |
| Detection Limit | Double | Affects file values set with the ‘ND’ or other non-detect flags. The module inserts a value equal to (Detection Limit * LT Multiplier). |
| Collapse Method | Choice: Max, Min | The 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 Collapse | Double | The maximum distance in 2D that points will be considered coincident. Coincident points will be dropped depending on the Collapse Method. |
| Post Clip Min | Double | The smallest nodal value that will be present in the output data field. |
| Post Clip Max | Double | The largest nodal value that will be present in the output data field. |
| Auto Exponentiate External Log Data | Boolean | Detects if data imported via the External Data port has been log processed and exponentiates it, avoiding double log processing. |
| External Data | Multi-select | Selects which data components from the External Data port to use for interpolation. |
Time Settings
| Property | Type | Description |
|---|---|---|
| Chem File Is Time Domain | Boolean | Causes 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 Component | Boolean | Allows the Data Component value to select a date, resulting in exact data at a date instead of an interpolated value. |
| Date For Interpolation | Date | The date of interest. Used with the Interpolation Type to determine the value of a sample before interpolation onto the grid. |
| Analyte Name | String | The analyte name for date files. |
| Date Interpolation Method | Choice: Direct Interpolation Only, Interpolate Only, Interpolate and Extrapolate Beyond, Interpolate and Extrapolate | Defines how to interpolate when given unsampled times in a file. |
| TCF File Name | File | The 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 TCF | Button | Causes 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
| Property | Type | Description |
|---|---|---|
| Estimation Type | Choice: Kriging, IDW (Shepard), IDW (Franke/Nielson), Nearest Neighbor, FastRBF, Natural Neighbors | The method for interpolating file data onto the created grid. |
| Use Gradients | Boolean | Used with Natural Neighbor interpolation. When on, gradients estimated at sample points improve the interpolation result. |
| Reach | Double | The 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 Reach | Integer | The maximum number of data points within the reach to consider for parameter estimation at a model node. |
| Quadrant Search | Boolean | When selected, searching is performed for each of the four quadrilaterals surrounding the point to be kriged. |
| Use All Points | Boolean | Causes 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 Limit | Integer | The 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 Tolerance | Double | Specifies the interval in linear space around the kriged model estimates to which the kriging confidence or uncertainty applies. |
| Statistical Confidence Factor | Double | Specifies the interval in log space around the kriged model estimates to which the kriging confidence or uncertainty applies. |
| Min Max Confidence | Double | Specifies the interval around the kriged model estimates to which the kriging confidence or uncertainty applies. |
| IDW Power | Double | Used with Inverse Distance Weighting. Greater values increase the influence of values closest to the interpolated point. |
| Variogram And Anisotropy | Variogram | Controls the semi-variogram model and anisotropy settings for kriging. |
Data To Export
| Property | Type | Description |
|---|---|---|
| Auxillary Kriging Data | Multi-select: Max Plume, Min Plume, Statistical Confidence, Standard Deviation, Statistical Uncertainty | Selects 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
| Property | Type | Description |
|---|---|---|
| Display Output Surface | Boolean | Controls whether the output surface is displayed. |
| Surface Distortion Component | Choice | Sets 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 Toggle | Multi-select | Turns on or off the spheres representing the locations of maximum uncertainty. |
Variography Display
| Property | Type | Description |
|---|---|---|
| Display Variogram Ellipse | Boolean | Displays the variography ellipse in the viewport. |
| Ellipse Opacity | Double | Sets the opacity of the ellipse. |
| Resolution | Integer | The resolution of the ellipse. Larger numbers create more detailed representations. |
| Ellipse Scale | Double | Scales the ellipse equally along each axis. |
| X Offset | Double | Translates the ellipse along the x axis. |
| Y Offset | Double | Translates the ellipse along the y axis. |
| Z Offset | Double | Translates the ellipse along the z axis. |
| Ellipse Color | Color | The color of the variogram ellipse. |
| Display Variogram Lines | Boolean | Displays lines aligned with the variography ellipse. |
| Line Scale | Double | A scalar that sets the length of the variogram lines relative to the scale of the ellipse. |
| Primary Ratio Color | Color | The color of the primary ratio axis line. |
| Secondary Ratio Color | Color | The color of the secondary ratio axis line. |
Drill Guide
| Property | Type | Description |
|---|---|---|
| Create DG File | Button | Runs 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 Samples | Integer | Controls how many times drill guide will run. |
| Target Concentration | Boolean | When selected, changes the location of the uncertainty sphere based upon the specified Target Isolevel. |
| Target Isolevel | Double | When Target Concentration is selected, this value is used to change the location of the uncertainty sphere. |
| User Points | Coordinates | Manages 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
| Property | Type | Description |
|---|---|---|
| Allow Run | Boolean | Controls whether the module will run when applications are loaded or data changes. When off, the module will not run unless Execute is pressed. |
| Filename | File | The file containing the data to interpolate onto the created grid. |
| Data Component | Integer | Selects 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 Priority | Choice: Maximum Values, Minimum Values | Affects which samples are adaptively gridded. |
| Execute | Button | Forces the module to run. If pressed and the application saved, the module will run when the application is loaded. |
| Z Scale | Double | The vertical exaggeration to apply to the variogram, the uncertainty sphere, and the output surface. |