section profile samples

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

DirectionNameTypeDescription
InputTransectFieldA transect line determining the path for the section profile.
InputInput FilenameStringFile used to display data.
InputInput Geologic FieldFieldThe geologic field to use for exploding output.
InputInput DateDateDate used for interpolating between dates in a time domain file format.
InputInput Refine DistanceNumberThe value used for refining PGF files.
InputSample GlyphFieldA field containing a glyph that can be placed at sample locations.
OutputOutput FilenameStringFile used to display data.
OutputOutput Refine DistanceNumberThe value used for refining PGF files.
OutputAnalyte NameStringText containing the name of the current analyte.
OutputBoring TubesFieldA field containing the boring tubes. This can be exported as a shapefile or EFB (with EnterVol) for use in ArcGIS.
OutputColor TubesFieldA field containing the color tube lines. This can be exported as a shapefile or EFB (with EnterVol) for use in ArcGIS.
OutputBoring DataFieldA 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).
OutputOutput DateDateDate used for interpolating between dates in a time domain file format.
OutputSample DataRenderableA renderable object displaying the sample data.

Properties

PropertyTypeDescription
Distance To ProfileDoubleThe 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 RunBooleanThis toggle can prevent the module from running, allowing the user to make changes to large data sets without waiting for updates.
ExecuteButtonThis 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.
FilenameFileThe file name to process for display. Supports .apdv, .aidv, .pgf, .geo, .gmf, .lpdv, .lsdv, .dg, and .ldg files.
Data ComponentIntegerSelects which file data component to process for display.
SamplesBooleanPrevents or allows samples from being created or displayed.
ScreensBooleanPrevents or allows screens from being created or displayed.
Boring TubesBooleanPrevents or allows boring tubes from being created or displayed.
Color TubesBooleanPrevents or allows color tubes from being created or displayed.
Well LabelsBooleanPrevents or allows well labels from being created or displayed.
Sample LabelsBooleanPrevents or allows sample labels from being created or displayed.
Suppress OutputBooleanPrevents updates and warnings from being output. This is useful if running the module in a loop.

Sample Settings

PropertyTypeDescription
Data ProcessingChoice: Linear Processing, Log ProcessingRuns the module in either linear or log space.
Linear Post ClipRange (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 ClipRange (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.
DatamapRange (Min/Max)The min and max values used by the datamap. This does not change data values from the file.
Detection LimitDoubleAffects 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 MultiplierDoubleThe multiplier applied to any sample with the ‘<’ less than flag.
Default Coordinate UnitsStringThe default coordinate units for the input data.
Sphere Count LimitIntegerThe 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 ThresholdIntegerThe maximum number of samples from the input file to allow. If the file contains more than this amount an error will occur.
Synthetic OnlyBooleanUsed 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

PropertyTypeDescription
Glyph SizeDoubleScales the glyphs in all directions. The default is automatically computed based on your input data.
PriorityChoice: Maximum, MinimumMinimum reverses the scaling so that the smallest sample values have the largest size.
Minimum Scale FactorDoubleScales the sample values with the least Priority.
Maximum Scale FactorDoubleScales the sample values with the greatest Priority.
Use Log DataBooleanBases the size of the glyph on the log10 of the selected data.
Generated GlyphChoice: Sphere, Cube, Cone, Cylinder, Polygon, DiskThe type of glyph that is automatically generated when no Sample Glyph is connected.
Sphere SubdivisionsIntegerHow finely the sample spheres are rendered. Higher values mean smoother spheres but at a higher memory cost.
Glyph ResolutionIntegerThe resolution for generated cone, polygon, cylinder, and disk glyphs.
Primary Axis FactorDoubleThe scale factor for the primary axis of the glyph.
Secondary Axis FactorDoubleThe scale factor for the secondary axis of the glyph.
Heading DipHeading/DipAligns the glyphs to a constant orientation.
RollDoubleThe roll of the glyph along its primary axis.

Subsetting Settings

PropertyTypeDescription
Drop Samples BelowDoubleRemoves any sample below the set value.
Drop Samples AboveDoubleRemoves any sample above the set value.
Subset By ExpressionBooleanEnables subsetting the samples using the Control Expression.
Control ExpressionExpressionThe expression used to subset the samples when Subset By Expression is on. Supports the variables {CoordinateX}, {CoordinateY}, {CoordinateZ}, {BoringName}, and {Value}.

Geology Settings

PropertyTypeDescription
Min ThicknessDoubleThe smallest thickness, in user coordinate units, that a geological layer can have.
ExplodeDoubleThe 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 HierarchyBooleanReverses 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 DistanceDoubleShows 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 IntervalIntegerCaps the number of points created between samples in PGF data.
Color Data ComponentChoice: Layer, Material, ElevationThe data used to color the sample spheres: the geologic layer, the material value of that layer, or the elevation of the spheres.

Time Settings

PropertyTypeDescription
File Is Time DomainBooleanTurns on date interpolation for time domain analyte (e.g. chemistry) files.
Specify Date By ComponentBooleanIgnores the Date and selects the date using the Data Component.
DateDateThe 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 NameStringThe 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 UnitsStringThe default units for the analyte data.
Interpolation MethodChoice: Direct Interpolation Only, Interpolate Only, Interpolate and Extrapolate Beyond, Interpolate and ExtrapolateDefines how to interpolate when given Missing values in a file. See Interpolation Methods below for full details.
Use Nearest MeasuredBooleanGives 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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

PropertyTypeDescription
Display Screens AsChoice: Tubes, WiresControls 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 RatioDoubleThe 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 ResolutionIntegerThe 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 TubesBooleanPlaces 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 LinesBooleanUsed 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

PropertyTypeDescription
Display AsChoice: Tubes, WiresDisplays the boring as a tube or as a wire.
Tube RatioDoubleThe 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 ResolutionIntegerHow 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 TopDoubleThe top elevation for each tube. If this value has been specified in the file, the file value is used instead.
Main ColorColorEach boring tube is divided using two colors; the Main Color sets the first of these.
Secondary ColorColorEach boring tube is divided using two colors; the Secondary Color sets the second of these.
Color SeparationDoubleThe 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.
PhaseDoubleControls the apparent rotation of tubes, in degrees.
Close TubesBooleanCaps the top and bottom of each tube at the same resolution as the tube, giving each tube a solid look.
Connect LinesBooleanUsed 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

PropertyTypeDescription
Display AsChoice: Tubes, WiresDisplays the color tube as a tube or as a wire.
Tube RatioDoubleThe 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 ResolutionIntegerHow 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 VariationDoubleCorrects color blending between samples.
PhaseDoubleControls the apparent rotation of tubes, in degrees.
Close Color TubesBooleanCaps the top and bottom of each tube at the same resolution as the tube, giving each tube a solid look.
Connect Color Tube LinesBooleanUsed 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

PropertyTypeDescription
Label SubsettingChoice: None, Blank Labels, Boring Min/MaxRestricts 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 FactorDoubleA 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 ValueBooleanUsed for label subsetting. When overlaps occur, or Boring Min/Max is selected, keeps the lowest value.
TitleExpressionThe template the title (well) labels are generated with. Supports the variables {Well}, {X}, {Y}, and {Z}.
Title PositionChoice: Top of Boring, Bottom of Boring, Top and BottomPlaces the title label at the top of the boring, below the last sample of the boring, or both.
Title Label SettingsLabel SettingsAligns and sizes the well/title labels independently from the sample and screen labels.
FeaturesExpressionThe template the feature (sample) labels are generated with. Supports the variables {X}, {Y}, {Z}, {Depth}, {Distance}, {Flag}, {Value}, and {Material}.
Default TopChoice: First Sample, Tube TopIf 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 OffsetChoice: None, OffsetControls 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 LabelingChoice: At sample, At mid-intervalSpecifies where each feature label occurs for screens.
Label TypeChoice: TrueType Fonts, Line FontsSelects 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 StyleFontAlters the basic look of the font. Available when Label Type is TrueType Fonts.
Sample Label SettingsLabel SettingsControls the alignment, angle, and height of sample and screen labels.
Label ColorColorThe color for every label.
Top OffsetDoubleA vertical offset from the top of the boring, for well labels only.
Radial OffsetDoubleThe 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 OffsetDoubleA vertical offset from the sample’s Z coordinate, for sample labels only.

Esri Export

PropertyTypeDescription
Package FileFileThe 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 OriginBooleanWrites the output in the user’s coordinate space. When turned off, the output is written around the origin.
Z ScaleDoubleThe 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 ExportMulti-select: Samples, Well Screens, Boring Tubes, Color Tubes, Well Labels, Sample LabelsSelects 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 BreaksIntegerThe 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 DecadesBooleanPlaces 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 XYBooleanWrites 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.