generate-contours-from-points
See this command in the command table.
To access this command:
- Report ribbon > Contours > Generate Contours .
-
Display the Find Command screen, locate
generate-contours-from-pointsand click Run. -
Enter "generate-contours-from-points" into the Command Line.
Command Overview
Generate contours from loaded point data.
Displays the Generate Controls from Points screen.
Command Automation
You can automate by passing this command and parameters into oDmApp.ParseCommand(), using any COM-aware scripting language.
Note: For more information on scripting in Studio NPVS+, please refer to your Scripting Tutorial (Help > Scripting Tutorial).
Example Parameter String (JS):
oDmApp.ParseCommand("generate-contours-from-points
'PointsInput=PTS;
AttributeColumn=AU;
StringOutput=AU_CONTOURS;
GridOutput=AU_GRID;
SurfaceOutput=AU_SURFACE;
FaultsInput=FAULTS;
ClippingInput=CLIP;
KeepInsideClipping=true;
Azimuth=0;Dip=0;
GriddingAlgorithm=MinimumCurvature;
GriddingEstimation=Slope;
SmoothingMethod=Biharmonic;
SmoothingPasses=1;
AutoExtent=true;
Margin=0;
CustomCellSize=false;
CellsAcrossX=100;CellsAcrossY=100;
UseSearchEllipse=false;
SearchRotation=0;
RotationMajor=1;RotationMinor=1;RotationMinSamples=1;
UseCustomContourExtents=false;
ContourStringMode=Fixed;ContourStringIntervals=10;ContourStringOffset=0;
ContourElevationMode=Attribute;
ContourRefinement=5;
ContourUpToFaults=false;ContourFaultRefinement=5;
UseCustomGridElevation=false;GridFaultRefinement=1;
GridLegendMode=FromContours;GridLegendSchemeName=;
GridLegendDistributionMode=Linear;GridLegendBinCount=100;
SurfaceFaultRefinement=1;SurfaceTolerance=0'";
Where:
-
PointsInput=PTSis thePointsInput: Object name. The object must resolve in the current project and is used as the source points data. The command does not run gridding unless this object is found. -
AttributeColumn=AUis theAttributeColumn: Numeric column name from PointsInput. If the value is the Z coordinate column name, the command uses Z coordinates directly. -
FaultsInput=FAULTSis theFaultsInput: Object name. When supplied and found, the object is used as fault input during gridding and output refinement. -
ClippingInput=CLIP;KeepInsideClipping=trueis theClippingInput: Object name. When supplied and found, the object is used as clipping polygon input. KeepInsideClipping controls which side of the clipping polygons is kept. -
Azimuth=0is theAzimuth: Numeric angle in degrees. It defines the contouring plane rotation about the Z axis. -
Dip=0is theDip: Numeric angle in degrees. It defines the contouring plane dip rotation. -
StringOutput=AU_CONTOURS;GridOutput=AU_GRID;SurfaceOutput=AU_SURFACEis theOutput target parameters: Select what the command creates. At least one output target must be supplied to create output. -
GriddingAlgorithm=MinimumCurvature;GriddingEstimation=Slope;SmoothingMethod=Biharmonic;SmoothingPasses=1is theGridding algorithm parameters: Control how the input values are interpolated, including gridding algorithm, estimation, smoothing method, smoothing passes, and trend polynomial order. -
AutoExtent=true;Margin=0;CustomCellSize=false;CellsAcrossX=100;CellsAcrossY=100is theGrid extent and resolution parameters: Define the generated grid area and cell size, including automatic extents, margin, custom cell size, and cell counts or widths. -
UseSearchEllipse=false;SearchRotation=0;RotationMajor=1;RotationMinor=1;RotationMinSamples=1is theSearch ellipse parameters: Control optional search ellipse behaviour for non-trend gridding. -
UseCustomContourExtents=false;ContourStringMode=Fixed;ContourStringIntervals=10;ContourStringOffset=0;ContourElevationMode=Attribute;ContourRefinement=5;ContourUpToFaults=false;ContourFaultRefinement=5is theContour-string output parameters: Used when StringOutput is supplied. These include contour extents, contour mode, intervals, offsets, elevation mode, fault handling, and refinement settings. -
UseCustomGridElevation=false;GridFaultRefinement=1;GridLegendMode=FromContours;GridLegendSchemeName=;GridLegendDistributionMode=Linear;GridLegendBinCount=100is theGrid output parameters: Used when GridOutput is supplied. These include custom grid elevation limits, fault refinement, and grid legend settings. -
SurfaceFaultRefinement=1;SurfaceTolerance=0is theSurface output parameters: Used when SurfaceOutput is supplied. These include surface fault refinement and surface tolerance settings.
Parameters Table
| Parameter | Description | Reqd? | Example Syntax |
|---|---|---|---|
PointsInput
|
Object name. The object must resolve in the current project and is used as the source points data. The command does not run gridding unless this object is found. | Y | PointsInput=PTS
|
AttributeColumn
|
Numeric column name from PointsInput. If the value is the Z coordinate column name, the command uses Z coordinates directly. | N | AttributeColumn=AU
|
FaultsInput
|
Object name. When supplied and found, the object is used as fault input during gridding and output refinement. | N | FaultsInput=FAULTS
|
ClippingInput
|
Object name. When supplied and found, the object is used as clipping polygon input. KeepInsideClipping controls which side of the clipping polygons is kept. | N | ClippingInput=CLIP;KeepInsideClipping=true
|
Azimuth
|
Numeric angle in degrees. It defines the contouring plane rotation about the Z axis. | N | Azimuth=0
|
Dip
|
Numeric angle in degrees. It defines the contouring plane dip rotation. | N | Dip=0
|
Output target parameters
|
Select what the command creates. At least one output target must be supplied to create output. | Y | StringOutput=AU_CONTOURS;GridOutput=AU_GRID;SurfaceOutput=AU_SURFACE
|
Gridding algorithm parameters
|
Control how the input values are interpolated, including gridding algorithm, estimation, smoothing method, smoothing passes, and trend polynomial order. | N | GriddingAlgorithm=MinimumCurvature;GriddingEstimation=Slope;SmoothingMethod=Biharmonic;SmoothingPasses=1
|
Grid extent and resolution parameters
|
Define the generated grid area and cell size, including automatic extents, margin, custom cell size, and cell counts or widths. | N | AutoExtent=true;Margin=0;CustomCellSize=false;CellsAcrossX=100;CellsAcrossY=100
|
Search ellipse parameters
|
Control optional search ellipse behaviour for non-trend gridding. | N | UseSearchEllipse=false;SearchRotation=0;RotationMajor=1;RotationMinor=1;RotationMinSamples=1
|
Contour-string output parameters
|
Used when StringOutput is supplied. These include contour extents, contour mode, intervals, offsets, elevation mode, fault handling, and refinement settings. | N | UseCustomContourExtents=false;ContourStringMode=Fixed;ContourStringIntervals=10;ContourStringOffset=0;ContourElevationMode=Attribute;ContourRefinement=5;ContourUpToFaults=false;ContourFaultRefinement=5
|
Grid output parameters
|
Used when GridOutput is supplied. These include custom grid elevation limits, fault refinement, and grid legend settings. | N | UseCustomGridElevation=false;GridFaultRefinement=1;GridLegendMode=FromContours;GridLegendSchemeName=;GridLegendDistributionMode=Linear;GridLegendBinCount=100
|
Surface output parameters
|
Used when SurfaceOutput is supplied. These include surface fault refinement and surface tolerance settings. | N | SurfaceFaultRefinement=1;SurfaceTolerance=0
|
More Information
- The parser only recognizes fields written as exactly one
key=valuepair separated by semicolons. Unknown keys are ignored. - Boolean parsing is case-insensitive through lower-casing;
trueandyesare true, and other values are false. - The source parser accepts
AttributeColumnandKeepInsideClipping; shorter names such asAttributeorKeepInsideare not parsed by this command.
Related topics and activities
