- See also
- python.packages.analyzeDEM
Aim of module
Analyzes a Digital Terrain Model (distribution of elevation,slope, exposition, curvature and openness).
General description
- 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. (default: id)
Type :
Remark : optional, default: id
Description:
-exactBorder Use exact border or a rectangular bounding box. (default: Boolean(False))
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" (default: corner)
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"). (default: 1)
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. (default: square)
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] (default: Boolean(True))
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] (default: Boolean(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] (default: Boolean(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] (default: Boolean(True))
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:38:31 warning: Switching to DEMO mode 02:38:31 warning: Switching to DEMO mode 02:38:31 warning: Switching to DEMO mode 02:38:31 warning: Switching to DEMO mode 02:38:31 warning: Switching to DEMO mode 02:38:31 warning: Switching to DEMO mode 02:38:31 warning: Switching to DEMO mode 02:38:31 warning: Switching to DEMO mode 02:38:31 warning: Switching to DEMO mode 02:38:31 warning: Switching to DEMO mode
Examples
To be written.
1.8.17