DEM optimization

Command line

The DEM optimization operation can be directly executed by typing one of the following expressions on the command line of the Main window:

  

OUTMAP

=

MapDemOptimization(InputMapName, InputSegmentMap)

OUTMAP

=

MapDemOptimization(InputMapName, InputSegmentMap, InputTable)

OUTMAP

=

MapDemOptimization(InputMapName, InputSegmentMap, InputTable, ColumnNameBufferDistance, ColumnNameSmoothDrop, ColumnNameSharpDrop)

OUTMAP

=

MapDemOptimization(InputMapName, InputSegmentMap, , ColumnNameBufferDistance, ColumnNameSmoothDrop, ColumnNameSharpDrop)

OUTMAP

=

MapDemOptimization(InputMapName, InputSegmentMap, BufferDistanceValue, SmoothDropValue [, SharpDropValue])

OUTMAP

=

MapDemOptimization(InputMapName, InputPolygonMap, PolygonDropValue)

where:

OUTMAP

is the name of the output raster map.

MapDemOptimization

is the command to start the DEM optimization operation.

InputMapName

is the name of the input raster map (value domain); the input raster map is expected to be a Digital Elevation Model (DEM).

InputSegmentMap

is the name of an input segment map (class or ID domain); the input segment map is expected to be a drainage map or a watershed-divide map.

 

InputTable

is the name of an attribute table belonging to the input segment map with the drainage or watershed classes or IDs. In the attribute table, you can indicate the amount that (each) drainage class should be dropped into the DEM, or the amount that (each) watershed-divide class should be raised on the DEM.

  • If the name of the attribute table is specified without specifying any further column names, then the attribute table is expected to contain the following value columns: Buffer_dist, Smooth_drop, Sharp_drop.
  • If the attribute table is linked to the segment map (or to the domain of the segment map) and if further column names are specified, then the attribute table name can be omitted.

ColumnNameBufferDistance

is the name of a value column containing the buffer distance values.
In the attribute table, buffer distance values can be specified for individual classes/IDs of segments.

ColumnNameSmoothDrop

is the name of a value column containing the smooth drop values.
In the attribute table, smooth drop values can be specified for individual classes/IDs of segments.

ColumnNameSharpDrop

is the name of a value column containing the sharp drop values.
In the attribute table, sharp drop values can be specified for individual classes/IDs of segments.

 

BufferDistanceValue

is a value (m) to indicate the 'area' at either side of the segments that will be affected by the drop or raise; real value > 0.

SmoothDropValue

is a value (m) to indicate the total drop/raise of all segments in the DEM.

  • SmoothDropValue > 0 means that all (drainage) segments will be dropped with this value in the output DEM.
  • SmoothDropValue = 0 means no drop and no raise.
  • SmoothDropValue < 0 means that all (watershed-divide) segments will be raised with this value on the output DEM.

SharpDropValue

is an optional value (m) to indicate an extra drop/raise of all segments in the output DEM on top of the specified SmootDropValue.

  • SharpDropValue > 0 means an extra drop of all segments.
  • SharpDropValue = 0 means no drop and no raise.
  • SharpDropValue < 0 means an extra raise of all segments.

When not specified, a SharpDropValue of 0 will be used.

 

InputPolygonMap

is the name of an input polygon map (any domain).

PolygonDropValue

is a value (m) to indicate the drop/raise of all polygons in the output DEM.

  • PolygonDropValue > 0 means that all polygons will be dropped with this value in the output DEM.
  • PolygonDropValue = 0 means no drop and no raise.
  • PolygonDropValue < 0 means that all polygons will be raised with this value on the output DEM.

When the definition symbol = is used, a dependent output map is created; when the assignment symbol := is used, the dependency link is immediately broken after the output map has been calculated.

The output map will use system domain Value; the value range for the output map is automatically calculated.

See also: