- See also
- python.analyzeDEM
Aim of module
Analyzes a Digital Terrain Model (distribution of elevation,slope, exposition, curvature and openness).
General description
Additionally, given the Digital Surface Model (DSM), analysis of the corresponding normalized Digital Surface Model (nDSM) can be performed.
Statistics and visualizations of the products are stored in one report. Specific areas of the Raster Files can be chosen by providing polygon SHP files. Due to the limitations of raster processing, by default a rectangular bounding box is taken instead of the exact polygons. Taking the true boundaries is also possible at the cost of a higher processing time.
ATTENTION! In case of Cutting Areas of Interest from a Shapefile, half-pixel offsets can occur changing the raster files. They can be avoided by switching the rounding mode between center and corner.
- See also
- Python script analyzeDEM
Parameter description
Elevation Model inputs
Settings concerning the input Terrain/Surface models.
-terrainModel File or path containing Digital Terrain Model(s).
Type : PathArgument
Remark : Mandatory
Description:
-surfaceModel Path(s) to the DSM(s)
Type : PathArgument
Remark : Optional
Description: File or wildcard path containing Digital Surface Model(s) [optional]. Attention! All filename parts replaced by a wildcard symbol have to correspond with the replaced parts of the DTM filenames.
Example for input of terrain and surface models
-t C:\Data\TerrainModel\DTM_*.tif -s C:\Data\SurfaceModel\DSM_*.tif ('*' has to represent exactly the same string for corresponding files! DTM_4380_5270.tif and DSM_4380_5270.tif would be recognized as a pair.)
Zone specification
Settings concerning definition and cutting of the analyzed zone.
-zone Polygon Shape file or point list (x1 y1 x2 y2 ... - see below) defining zone polygon(s) [optional].
Type :
Remark : Optional
Description:
-attribute Name of the Shape file attribute used as a zone name.
Type :
Remark : Optional, default: id
Description:
-exactBorder Use exact border or a rectangular bounding box.
Type : Boolean
Remark : Optional, default: Boolean(False)
Description: By default, non-rectangular zones are also used as a rectangular bounding boxes for performance reasons. With this parameter, the processing is limited to the real polygons what is more time-consuming. [True=exact polygons | False=rectangular bounding box]
Possible values:
| 1 | 1 |
| 0 | 0 |
| true | true |
| false | false |
| yes | yes |
| no | no |
| Boolean(True) | Boolean(True) |
| Boolean(False) | Boolean(False) |
| True | True |
| False | False |
-pickPoly Manual Selection of polygons within the Shape file [optional].
Type :
Remark : Optional
Description: Polygons are selected by their names of the attribute specified under -attribute.
-centerCorner Options for rounding the results to exakt pixel positions ["corner" | "center"
Type :
Remark : Optional, default: corner
Description:
Example of giving a polygon through point coordinates using the -zone flag
-zone "0 100 20 100 20 110 0 110" (The result would be a 20x10 rectangle.) Attention: Only use the " quotation mark!
Processing options
Settings for the processing of DEM-derivation products using
opalsGridFeature.
-kernelSize Kernel size for the grid feature derivation. More values can be passed separated by a comma (e.g. "-r 2,3,5").
Type :
Remark : Optional, default: 1
Description:
-kernelShape Specification of one kernel shape from the opals-supported types [square | circle | diamond]. Circle and diamond can only be used for a kernel size of 2 or higher.
Type :
Remark : Optional, default: square
Description:
Output options
Settings concerning the intermediate products and the final report.
-outFolder Existing directory to store the generated files. [default = CWD]
Type :
Remark : Optional
Description:
-visualize Add Shadings and colored maps to the report [True | False]
Type : Boolean
Remark : Optional, default: Boolean(True)
Description:
Possible values:
| 1 | 1 |
| 0 | 0 |
| true | true |
| false | false |
| yes | yes |
| no | no |
| Boolean(True) | Boolean(True) |
| Boolean(False) | Boolean(False) |
| True | True |
| False | False |
-histogramFile Decision if an additional histogram plot file (SVG) shall be stored. [True | False]
Type : Boolean
Remark : Optional, default: Boolean(False)
Description:
Possible values:
| 1 | 1 |
| 0 | 0 |
| true | true |
| false | false |
| yes | yes |
| no | no |
| Boolean(True) | Boolean(True) |
| Boolean(False) | Boolean(False) |
| True | True |
| False | False |
-deleteFiles All intermediate results not contained in the report can be automatically deleted to save memory. [True | False]
Type : Boolean
Remark : Optional, default: Boolean(False)
Description:
Possible values:
| 1 | 1 |
| 0 | 0 |
| true | true |
| false | false |
| yes | yes |
| no | no |
| Boolean(True) | Boolean(True) |
| Boolean(False) | Boolean(False) |
| True | True |
| False | False |
-skipIfExists Skip processing if result already exists. [True | False]
Type : Boolean
Remark : Optional, default: Boolean(True)
Description:
Possible values:
| 1 | 1 |
| 0 | 0 |
| true | true |
| false | false |
| yes | yes |
| no | no |
| Boolean(True) | Boolean(True) |
| Boolean(False) | Boolean(False) |
| True | True |
| False | False |
02:49:00 warning: Switching to DEMO mode 02:49:00 warning: Switching to DEMO mode 02:49:00 warning: Switching to DEMO mode 02:49:00 warning: Switching to DEMO mode 02:49:01 warning: Switching to DEMO mode 02:49:01 warning: Switching to DEMO mode 02:49:01 warning: Switching to DEMO mode 02:49:01 warning: Switching to DEMO mode 02:49:01 warning: Switching to DEMO mode 02:49:01 warning: Switching to DEMO mode
Examples
To be written.
1.8.17