- See also
- python.workflows.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
- Script documentation
Parameter description
-attribute Name of the Shape file attribute used as a zone name.
Type : String
Remark : optional, default: id
Elevation Model inputs
Settings concerning the input Terrain/Surface models.
-terrainModel File or path containing Digital Terrain Model(s).
Type : Path
Remark : mandatory
-surfaceModel Path(s) to the DSM(s)
Type : Path
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.)
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!
Output self
Settings concerning the intermediate products and the final report.
-outFolder Existing directory to store the generated files. (default: CWD)
Type : Path
Remark : optional
-visualize Add Shadings and colored maps to the report [True | False]
Type : Boolean
Remark : optional, default: True
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: False
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: False
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: True
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 |
Processing self
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 : String
Remark : optional, default: 1
-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 : String
Remark : optional, default: square
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 : Path
Remark : optional
-exactBorder Use exact border or a rectangular bounding box.
Type : Boolean
Remark : optional, default: 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 : String
Remark : optional
Description: Polygons are selected by their names of the attribute specified under -attribute.
-rounding self for rounding the results to exakt pixel positions "corner" | "center"
Type : String
Remark : optional, default: corner
Logging Options
Settings concerning the verbosity level of logging.
-fileLogLevel Log level in the logfile
Type : LogLevel
Remark : optional, default: info
-screenLogLevel Log level on screen
Type : LogLevel
Remark : optional, default: info
-logger Logger
Type : Logger
Remark : optional
Description: Logger is usually provided by the opals framework.The user may provide their own logger object, but it has to function in the same way as the opals Logger.
02:44:13 warning: Switching to DEMO mode 02:44:13 warning: Switching to DEMO mode 02:44:13 warning: Switching to DEMO mode 02:44:13 warning: Switching to DEMO mode 02:44:13 warning: Switching to DEMO mode 02:44:13 warning: Switching to DEMO mode 02:44:13 warning: Switching to DEMO mode 02:44:13 warning: Switching to DEMO mode 02:44:13 warning: Switching to DEMO mode 02:44:13 warning: Switching to DEMO mode
Examples
To be written.
1.8.17