Vr Mapping |
ON-LINE REFERENCE DOCUMENTATION CARDINAL SYSTEMS, LLC |
Set DTM Parameters (SetDtm)
Type: Parameter application
Sets parameters for DTM processing.
Detailed Description
Sets the parameters for the DTM (Digital Terrain Modeling) application. These parameters will be used by the Run Dtm application. Parameters may be recorded and loaded.
NOTE: The key-in ParFilDTM may be used to load a DTM parameter file from a key-in which will make the saved parameters set here in effect during subsequent DTM processing with RunDtm. Example: ParFilDTM c:\jobs\BigJob\DtmRun.dtm
Available Key-ins
None
Parameters for Set DTM
Layer containing points
Defines the layers to search for points (VrOne symbols) to use for DTM processing. A number line may be used.
Layer containing break lines
Defines the layers to search for break lines to use for DTM processing. A number line may be used.
Input minimum Z
Any points with Z values below this amount will be excluded from the DTM. This does apply when processing existing surface files.
Input maximum Z
Any points with Z values above this amount will be excluded from the DTM. This does apply when processing existing surface files.
Workspaces to consider
Defines the workspaces to consider when searching for DTM points and break lines. Options are Current only and All open workspaces.
Area to model
The entire data area or a smaller area may be modeled. Options are:
All |
All – The entire data area will be modeled. |
Current view window |
Current view window – Only the current view window will be modeled. This is useful when editing in an area to make regeneration of contours faster. |
User-defined area |
User-defined area – Models a user-defined polygon. The “Id User- Defined Area” button is used to select the user-defined area. |
Id User-Defined Area (Not defined or Defined)
Pressing this button will allow a line to be selected from any currently open VrOne workspace. Once a line has been selected, it will be used if “User-Defined Area” is selected for the Area to model option. The button label will change to indicate whether a user-defined area has been selected or not. NOTE: Just selecting a user-defined area does not mean it will be used, the Area to model option must also be set to “User-Defined Area”.
User Area Offset Distance
If using a User-Defined Area, the size of the user-defined area will be increased by this amount. This allows points outside the user-defined area to be used when computing the TIN, which helps when matching one DTM area to another. The resulting contours are always trimmed to the exact user-defined area.
Maximum edge triangle leg length
Triangles will not be created if they contain a leg that is on the edge of the DTM that is longer than this length. This parameter may be set to 0 if all edge triangles should be created.
Maximum inside triangle leg length
Triangles will not be created if they contain a leg that is not on the inside of the DTM that is longer than this length. This parameter may be set to 0 if all inside triangles should be created.
Contour Layer
Layer to place intermediate contours into. The range of this parameter is 1 to 10001. This parameter may be left blank if intermediate contours are not to be stored.
Index contour layer
Layer to place index contours into. The range of this parameter is 1 to 10001. This parameter may be left blank if index contours are not to be stored.
Legs layer
Layer to place DTM surface triangles into. This parameter may be left blank if triangles are not to be stored.
Boundary layer
Layer to place DTM boundary line into. This line represents the smallest enclosing polygon that contains all of the DTM points. This parameter may be left blank if the DTM boundary is not to be stored.
Depression Contour Graphic Pointer
Depression contours will be flagged using this graphic pointer. This parameter may be set to 0 if no depression contours should be flagged.
Depression Contour Maximum Area
Depression contours with areas larger than this amount will not be flagged.
Create Depression Contours on Closed Lines Only
If set to Yes, then only contours that are physically closed will be considered for flagging.
Create Depression on Bottom Contours Only
If set to Yes, then only contours that are at the bottom of a depression area will be considered for flagging.
Boundary layer
Layer to place DTM boundary line into. This line represents the smallest enclosing polygon that contains all of the DTM points. This parameter may be left blank if the DTM boundary is not to be stored.
Contour interval
Defines the intermediate contour interval. This parameter is entered in ground units. If zero is entered for this parameter, it will be set to one.
Index contour interval
Defines the index contour interval. This parameter is entered in ground units. If zero is entered for this parameter, it will be set to five times the contour interval.
Spline mode
Contour lines generated by Run Dtm may be splined using this parameter. Options include:
None Set to line mode 1 |
No splining will be done on contour lines. |
Spline Set to line mode 2 |
Set contour lines mode to Line mode 2, which is the VrOne cubic spline display mode. A cubic spline specifies that the line pass through all data points. This splining mode normally performs well for some planimetric features and manually digitized contours. However, it does not always produce cartographically correct contour lines. |
B Spline Add points to line |
Fits a B-spline through the contour line. The spline points will be placed on the line and stored in the VrOne file. This algorithm creates a cartographically correct line for contour lines from the DTM. |
Notes on the resulting lines from splining:
Spline Set to line mode 2 - This sets the contours to VrLine Mode 2, which displays a line with a cubic spline. This is a spline in which the line passes through all points. The resulting contour lines may be aesthetically pleasing but may not be as statistically correct as no splining.
B Spline Add points to line- This is a spline in which the line is approximated through the triangle edge contour points. The line may not pass through all points. The resulting contour lines may be aesthetically pleasing but may not be as statistically correct as no splining.
B spline increment (1-10)
Defines the smoothness of B-splined lines. For example, if a contour line began with 100 points as an un-splined line a B spline increment of 4 would result in a line of 400 points. A B spline increment of 4 is normally adequate for most contouring.
Delete target layers?
If this parameter is set to Yes then the Contour, Index contour and Legs layers will be deleted before a new DTM surface is generated.
Pack file?
If this parameter is set to Yes then the active VrOne workspace will be packed before a new DTM surface is generated.
Verbose reporting?
During DTM processing the progress will be reported in detail in a dialog box if this parameter is set to yes.
Free DTM after use?
If this parameter is set to No then the DTM surface generated will be retained in memory for later use. Retaining the surface in memory makes the DTM surface active for draping operations such as determining the DTM surface Z from the current Xy cursor location.
Save DTM to file?
If yes, then Run Dtm (RUNDTM) will save the DTM to the file specified in the “DTM Save file name” parameter. A DTM file contains the exact triangles that were created during DTM processing. After using RUNDTM once, Quick Dtm (QUIDTM) can then be used to create the DTM directly from the previously saved DTM file, resulting in much faster processing on large DTMs. This option is ideal if running the DTM engine multiple times on a large dataset that is not changing.
DTM Save file name
If “Save DTM to file?” is set to Yes, then the file will be saved to this file name. The file will have a default extension of vrdtm.
Excluded points file name
If a filename is specified, then any points that fall outside the minimum and maximum Z range will be written to this file. The format is a space delimited ASCII file with one point per line, in X Y Z order.