section profile samples
The section profile samples module displays your input data straightened along a transect line, for use with straightened section profiles. Each sample’s X coordinate becomes the distance along the transect line passed into the Transect port, Y is flattened to 0, and Z (elevation) is preserved, producing a profile in the XZ plane. Borings farther than the Distance To Profile from the line are dropped from the output.
It reads the same file types as post samples:
- Sampling locations and the values of the properties in .apdv files
- The lithology specified in .pgf, .lsdv, .lpdv, or .geo files
- The location and values of well screens in .aidv files
Samples can be displayed as spheres or other glyphs, along with boring tubes, color tubes, well screens, and well and sample labels. The transect line is required: the module cannot straighten the data without it. Use the same line that is passed to section profile, and display the result in a section profile viewer with section profile axes.
The display can also be exported as an ArcGIS Pro layer package. Because the section profile is its own coordinate space, no real-world coordinate system is applied to the export.
Ports
| Direction | Name | Type | Description |
|---|---|---|---|
| Input | Transect | Field | A transect line determining the path for the section profile. |
| Input | Input Filename | String | File used to display data. |
| Input | Input Geologic Field | Field | The geologic field to use for exploding output. |
| Input | Input Date | Date | Date used for interpolating between dates in a time domain file format. |
| Input | Input Refine Distance | Number | The value used for refining PGF files. |
| Input | Sample Glyph | Field | A field containing a glyph that can be placed at sample locations. |
| Output | Output Filename | String | File used to display data. |
| Output | Output Refine Distance | Number | The value used for refining PGF files. |
| Output | Analyte Name | String | Text containing the name of the current analyte. |
| Output | Boring Tubes | Field | A field containing the boring tubes. This can be exported as a shapefile or EFB (with EnterVol) for use in ArcGIS. |
| Output | Color Tubes | Field | A field containing the color tube lines. This can be exported as a shapefile or EFB (with EnterVol) for use in ArcGIS. |
| Output | Boring Data | Field | A field containing the data associated with each boring. The contents depend on which objects are visible: colored tubes if present, otherwise colored spheres if present, otherwise well screens (interval data). |
| Output | Output Date | Date | Date used for interpolating between dates in a time domain file format. |
| Output | Sample Data | Renderable | A renderable object displaying the sample data. |
Properties
| Property | Type | Description |
|---|---|---|
| Distance To Profile | Double | The maximum distance from the transect line passed into the Transect port; borings farther than this distance from the line are dropped from the output. |
| Allow Run | Boolean | This toggle can prevent the module from running, allowing the user to make changes to large data sets without waiting for updates. |
| Execute | Button | This button will force the module to run even if the Allow Run toggle has been turned off. This allows the user to make a number of changes before updating. |
| Filename | File | The file name to process for display. Supports .apdv, .aidv, .pgf, .geo, .gmf, .lpdv, .lsdv, .dg, and .ldg files. |
| Data Component | Integer | Selects which file data component to process for display. |
| Samples | Boolean | Prevents or allows samples from being created or displayed. |
| Screens | Boolean | Prevents or allows screens from being created or displayed. |
| Boring Tubes | Boolean | Prevents or allows boring tubes from being created or displayed. |
| Color Tubes | Boolean | Prevents or allows color tubes from being created or displayed. |
| Well Labels | Boolean | Prevents or allows well labels from being created or displayed. |
| Sample Labels | Boolean | Prevents or allows sample labels from being created or displayed. |
| Suppress Output | Boolean | Prevents updates and warnings from being output. This is useful if running the module in a loop. |
Sample Settings
| Property | Type | Description |
|---|---|---|
| Data Processing | Choice: Linear Processing, Log Processing | Runs the module in either linear or log space. |
| Linear Post Clip | Range (Min/Max) | When Linear Processing is selected, the Minimum and Maximum are used after data processing to replace any sample property value that is less than the minimum or greater than the maximum in linear space. |
| Log Post Clip | Range (Min/Max) | When Log Processing is selected, the Minimum and Maximum are used after data processing to replace any sample property value that is less than the minimum or greater than the maximum in log space. |
| Datamap | Range (Min/Max) | The min and max values used by the datamap. This does not change data values from the file. |
| Detection Limit | Double | Affects any file values set with the ‘ND’ or other non-detect flags (see the APDV file format help for a list of these flags). When collapsing to 2D, the module inserts a value equal to (Detection Limit * LT Multiplier), matching 2d estimation’s ND convention; in 3D mode the Detection Limit value itself is inserted. |
| Less Than Multiplier | Double | The multiplier applied to any sample with the ‘<’ less than flag. |
| Default Coordinate Units | String | The default coordinate units for the input data. |
| Sphere Count Limit | Integer | The maximum number of spheres to create. If the number of samples exceeds this value, the module will turn spheres off and generate (more efficient) colored tubes instead. |
| Maximum Sample Threshold | Integer | The maximum number of samples from the input file to allow. If the file contains more than this amount an error will occur. |
| Synthetic Only | Boolean | Used when reading drill guide files. Causes only the synthetic drill guide samples to be displayed instead of both the synthetic and original samples. |
Glyph Settings
| Property | Type | Description |
|---|---|---|
| Glyph Size | Double | Scales the glyphs in all directions. The default is automatically computed based on your input data. |
| Priority | Choice: Maximum, Minimum | Minimum reverses the scaling so that the smallest sample values have the largest size. |
| Minimum Scale Factor | Double | Scales the sample values with the least Priority. |
| Maximum Scale Factor | Double | Scales the sample values with the greatest Priority. |
| Use Log Data | Boolean | Bases the size of the glyph on the log10 of the selected data. |
| Generated Glyph | Choice: Sphere, Cube, Cone, Cylinder, Polygon, Disk | The type of glyph that is automatically generated when no Sample Glyph is connected. |
| Sphere Subdivisions | Integer | How finely the sample spheres are rendered. Higher values mean smoother spheres but at a higher memory cost. |
| Glyph Resolution | Integer | The resolution for generated cone, polygon, cylinder, and disk glyphs. |
| Primary Axis Factor | Double | The scale factor for the primary axis of the glyph. |
| Secondary Axis Factor | Double | The scale factor for the secondary axis of the glyph. |
| Heading Dip | Heading/Dip | Aligns the glyphs to a constant orientation. |
| Roll | Double | The roll of the glyph along its primary axis. |
Subsetting Settings
| Property | Type | Description |
|---|---|---|
| Drop Samples Below | Double | Removes any sample below the set value. |
| Drop Samples Above | Double | Removes any sample above the set value. |
| Subset By Expression | Boolean | Enables subsetting the samples using the Control Expression. |
| Control Expression | Expression | The expression used to subset the samples when Subset By Expression is on. Supports the variables {CoordinateX}, {CoordinateY}, {CoordinateZ}, {BoringName}, and {Value}. |
Geology Settings
| Property | Type | Description |
|---|---|---|
| Min Thickness | Double | The smallest thickness, in user coordinate units, that a geological layer can have. |
| Explode | Double | The explode distance, which can be set here or referenced by connection. For .geo files, the samples will be exploded based upon their layer designations unless a different geology is imported into the module. |
| Reverse Hierarchy | Boolean | Reverses the hierarchy of the geology. Normal hierarchy will push down any layer that tries to rise through the one above it. Reverse hierarchy will pull up any layer that dips into the one below it. |
| Screen Refine Distance | Double | Shows how lithology screens can be sampled in indicator modules. At minimum (refine distance of zero) there is a sample at the top and bottom of each layer; the refine distance adds samples between the top and bottom until no sample is more than the refine distance apart. |
| Max Points Per Interval | Integer | Caps the number of points created between samples in PGF data. |
| Color Data Component | Choice: Layer, Material, Elevation | The data used to color the sample spheres: the geologic layer, the material value of that layer, or the elevation of the spheres. |
Time Settings
| Property | Type | Description |
|---|---|---|
| File Is Time Domain | Boolean | Turns on date interpolation for time domain analyte (e.g. chemistry) files. |
| Specify Date By Component | Boolean | Ignores the Date and selects the date using the Data Component. |
| Date | Date | The date being interpolated to. For example, if you have an analyte value of 2 on 1/01/05 and a value of 4 on 1/03/05 and the date is set to 1/02/05 with Direct Interpolation Only, the value will be 3. The Date can be set here or passed in via the Input Date port. |
| Analyte Name | String | The analyte name for AIDV and APDV time files, since the dates take up the positions in these files usually reserved for analyte names. |
| Default Analyte Units | String | The default units for the analyte data. |
| Interpolation Method | Choice: Direct Interpolation Only, Interpolate Only, Interpolate and Extrapolate Beyond, Interpolate and Extrapolate | Defines how to interpolate when given Missing values in a file. See Interpolation Methods below for full details. |
| Use Nearest Measured | Boolean | Gives the sample at the interpolated date the value of the nearest measured date instead of an interpolated value. |
Interpolation Methods
Each interpolation method defines how to interpolate when given Missing values in a file. Non-Detect values are equal to either the Detection Limit or the Pre Clip Min. If the Date is set to the same time as a Non-Detect in the file, the sample will be a Non-Detect and not an interpolated value.
- Direct Interpolation Only: The most basic interpolation method, and the most accurate in terms of representing the data as it has been entered. Looks at the two dates surrounding the input Date. If either date, or both dates, have Missing as values, the value for that sample will be Missing and no interpolation will occur.
- Interpolate Only: Looks through the date columns both before and after the set Date for values that are not Missing, then interpolates between those numbers. If it fails to find a non-Missing value before and after the set date, it sets the data to Missing. Useful for files with a small amount of Missing values.
- Interpolate and Extrapolate Beyond: Looks through the date columns both before and after the set Date for the first instance of a value that is not Missing. If it does not find a valid non-Missing date after the input Date, it extrapolates beyond the last useable date to the input Date.
- Interpolate and Extrapolate: Looks through the date columns both before and after the set Date for the first instance of a value that is not Missing. If it fails to find one, it extrapolates the first value backwards to the input Date. If the date after the input Date is Missing, it looks forward through the time columns until it finds a date that is not Missing. It also extrapolates beyond the last valid date in the file.
Screen Settings
| Property | Type | Description |
|---|---|---|
| Display Screens As | Choice: Tubes, Wires | Controls how the well screens are displayed. Tubes displays each well screen as a tube from the top of the screen to the bottom. Wires displays each well screen as a line from the top of the screen to the bottom. |
| Screen Ratio | Double | The percentage of the Glyph Size used for the screen tube size. For example, with a Glyph Size of 10 and a Screen Ratio of 70%, the size of each tube will be 7. |
| Screen Tube Resolution | Integer | The number of divisions used to make each well screen tube. The higher the resolution the smoother or more circular each tube will be. |
| Close Screen Tubes | Boolean | Places a disc, of the same resolution as the tube, inside the top and bottom of each screen tube, giving the well screen tubes a more solid appearance. |
| Connect Screen Lines | Boolean | Used for non-vertical intervals. Separate cells are created between successive screens, and their ends may not be coincident, especially where the angle changes sharply. When on, the separate ends are averaged to merge these cells into a single, slightly distorted but more efficient and seamless tube. |
Boring Tube Settings
| Property | Type | Description |
|---|---|---|
| Display As | Choice: Tubes, Wires | Displays the boring as a tube or as a wire. |
| Tube Ratio | Double | The percentage of the sample sphere minimum size used for the tube size. For example, with sample spheres with a minimum size of 10 and a Tube Ratio of 70%, the size of each tube will be 7. |
| Tube Resolution | Integer | How many faces are used to create each tube. Increasing this number results in rounder tubes, but uses more memory. The minimum value is 2, which creates plane like tubes; 3 creates triangular tubes, 4 square, etc. |
| Tube Top | Double | The top elevation for each tube. If this value has been specified in the file, the file value is used instead. |
| Main Color | Color | Each boring tube is divided using two colors; the Main Color sets the first of these. |
| Secondary Color | Color | Each boring tube is divided using two colors; the Secondary Color sets the second of these. |
| Color Separation | Double | The length each of the Main Color and the Secondary Color extends before switching to the other. This can be used as a visual clue to the vertical scale of the model. |
| Phase | Double | Controls the apparent rotation of tubes, in degrees. |
| Close Tubes | Boolean | Caps the top and bottom of each tube at the same resolution as the tube, giving each tube a solid look. |
| Connect Lines | Boolean | Used for non-vertical borings. Separate cells are created between successive samples, and their ends may not be coincident, especially where the angle changes sharply. When on, the separate ends are averaged to merge these cells into a single, slightly distorted but more efficient and seamless tube. |
Color Tube Settings
| Property | Type | Description |
|---|---|---|
| Display As | Choice: Tubes, Wires | Displays the color tube as a tube or as a wire. |
| Tube Ratio | Double | The percentage of the sample sphere minimum size used for the tube size. For example, with sample spheres with a minimum size of 10 and a Tube Ratio of 70%, the size of each tube will be 7. |
| Tube Resolution | Integer | How many faces are used to create each tube. Increasing this number results in rounder tubes, but uses more memory. The minimum value is 2, which creates plane like tubes; 3 creates triangular tubes, 4 square, etc. |
| Max Variation | Double | Corrects color blending between samples. |
| Phase | Double | Controls the apparent rotation of tubes, in degrees. |
| Close Color Tubes | Boolean | Caps the top and bottom of each tube at the same resolution as the tube, giving each tube a solid look. |
| Connect Color Tube Lines | Boolean | Used for non-vertical borings. Separate cells are created between successive samples, and their ends may not be coincident, especially where the angle changes sharply. When on, the separate ends are averaged to merge these cells into a single, slightly distorted but more efficient and seamless tube. |
Label Settings
| Property | Type | Description |
|---|---|---|
| Label Subsetting | Choice: None, Blank Labels, Boring Min/Max | Restricts the number of labels in a rectangular region by using label blanking, or restricts the number of labels along a boring based on the analytical value. |
| Blank Factor | Double | A scale used when determining the bounds of a label for overlap avoidance. The scale is based on the height of the label. Available when Label Subsetting is Blank Labels. |
| Favor Min Value | Boolean | Used for label subsetting. When overlaps occur, or Boring Min/Max is selected, keeps the lowest value. |
| Title | Expression | The template the title (well) labels are generated with. Supports the variables {Well}, {X}, {Y}, and {Z}. |
| Title Position | Choice: Top of Boring, Bottom of Boring, Top and Bottom | Places the title label at the top of the boring, below the last sample of the boring, or both. |
| Title Label Settings | Label Settings | Aligns and sizes the well/title labels independently from the sample and screen labels. |
| Features | Expression | The template the feature (sample) labels are generated with. Supports the variables {X}, {Y}, {Z}, {Depth}, {Distance}, {Flag}, {Value}, and {Material}. |
| Default Top | Choice: First Sample, Tube Top | If the ground elevation is not defined in the file, sets the top to either the first sample in a boring or the Tube Top value. This affects how labels that use the top value are displayed. |
| Well Label Radial Offset | Choice: None, Offset | Controls whether the Radial Offset is applied to well labels. By default, well labels are placed directly above/below the boring. Offset applies the same Radial Offset used for sample labels. |
| Screen Labeling | Choice: At sample, At mid-interval | Specifies where each feature label occurs for screens. |
| Label Type | Choice: TrueType Fonts, Line Fonts | Selects between two font types. TrueType fonts are standard fonts. Line fonts are low impact fonts which perform better when large numbers of labels are generated. |
| TrueType Font Style | Font | Alters the basic look of the font. Available when Label Type is TrueType Fonts. |
| Sample Label Settings | Label Settings | Controls the alignment, angle, and height of sample and screen labels. |
| Label Color | Color | The color for every label. |
| Top Offset | Double | A vertical offset from the top of the boring, for well labels only. |
| Radial Offset | Double | The sample label offset from the sample’s center, in sphere diameter units, for sample labels only. A value of 1.0 is one sample diameter. |
| Z Offset | Double | A vertical offset from the sample’s Z coordinate, for sample labels only. |
Esri Export
| Property | Type | Description |
|---|---|---|
| Package File | File | The ArcGIS Pro layer package (*.lpkx) output; setting the filename writes the package. The package bundles the sample points, well screens, color tubes, borings, and labels as feature classes in a file geodatabase, together with a layer file styled to match the display, into one portable file. |
| Translate By Origin | Boolean | Writes the output in the user’s coordinate space. When turned off, the output is written around the origin. |
| Z Scale | Double | The vertical exaggeration applied as each exported layer’s display-side Vertical Exaggeration in ArcGIS; the coordinates themselves stay at true elevation. For a profile exported in XY, the exaggeration is instead baked into the profile’s vertical axis, since 2D maps have no elevation settings. |
| Features To Export | Multi-select: Samples, Well Screens, Boring Tubes, Color Tubes, Well Labels, Sample Labels | Selects which feature classes are included in the package. Each output must also be enabled by the matching toggle (Samples, Screens, Boring Tubes, Color Tubes, Well Labels, Sample Labels). |
| Target Number Of Breaks | Integer | The target number of legend class breaks for continuously colored layers. Exact for linear data; for log processed data with Break Log Data By Decades on, it instead determines the breaks per decade (rounded up), so the total may exceed the target. |
| Break Log Data By Decades | Boolean | Places the legend breaks of log processed data at rounded levels aligned to log decades (e.g. 1, 3, 10, 30) instead of evenly in log space, matching the EVS legend’s logarithmic decades. |
| Export Profile In XY | Boolean | Writes the profile in XY plan orientation: X is the distance along the transect, Y is the elevation (times the Z Scale), and Z is 0. When off, the output keeps the section profile (world-recovered) coordinates. |