Aim of module

Derives precision maps (color coded raster maps and histograms) using sigma0 data.

General description

The results are provided per strip and as mosaics (entire project area).

See also: Script documentation

The following table contains a list of all involved modules and their default storage location:

qltPrecision
OPALS Module	Default Directory	Comments
Module Import	.\import	ODM files
Module Grid	.\grid	precision (sigma0) grid files
Module Algebra	.\grid	grid masks
Module Algebra	.\grid	masked grid files
Module Algebra	.\grid	masked/unmasked mosaic grid files
Module ZColor	.\qltPrecision	color coded precision maps (masked and unmasked)
Module Histo	.\histo	precision histograms (masked and unmasked)

Parameter description

-mosaic create mosaics

Type : Boolean
Remark : optional, default: True

possible input	evaluates to
1, true, yes, Boolean(True), True	Boolean(True)
0, false, no, Boolean(False), False	Boolean(False)

-mask create grid masks (sigma0, eccentricity)

Type : String
Remark : optional, default: True

-slopeLimits optional slope limits (in degrees) for slope classes based analyses. e.g. 20 30 will result in three classes: <20, >=20 to <30, >=30

Type : Floating-point number
Remark : optional, default: []

-recalcMaskFiles if True, masked outputfiles will be recalculated.

Type : Boolean
Remark : optional, default: False
Description: This parameter could be used if a new mask is applied and only the masked outputfilesshould be recalculated.

possible input	evaluates to
1, true, yes, Boolean(True), True	Boolean(True)
0, false, no, Boolean(False), False	Boolean(False)

-flatmode for support of opalsQuality flatmode

Type : Boolean
Remark : optional, default: False

possible input	evaluates to
1, true, yes, Boolean(True), True	Boolean(True)
0, false, no, Boolean(False), False	Boolean(False)

Common Package/Script Options

Settings concerning the general options for (package) scripts.

-infile input text file, directory or strip file

Type : Path
Remark : mandatory
Description: As input either the name of an ASCII file (extension .txt) containing the names of the data files (one file per line) or an expression using wildcards to specify the respective data sets are accepted.

-outfile output directory or settings file (.txt)

Type : Path
Remark : optional
Description: Specifies the directory where the final results are stored. If not specified, the results are created in the current working directory.

-tempdir temporary directory

Type : Path
Remark : optional, default: current directory
Description: Specifies the directory where all intermediate results are stored. If not specified, a TEMP subdirectory is created in the current working directory. Additional subdirectories (one per involved module) are created.

-cfg Path to configuration file

Type : Path
Remark : optional, default: $OPALS_ROOT/cfg/qltPrecision.cfg
Description: The name of a configuration file containing all relevant calculation parameters is expected. If not specified, the default cfg files as provided by the OPALS distribution are used.

-projectDir project directory

Type : Path
Remark : optional, default: current directory
Description: The default project directory is the current working directory, but can be easily changed by this parameter. All path parameters, if not specified as absolute paths, are interpreted relative to the project directory.

-skipIfExists skip processing if result already exists

Type : Boolean
Remark : optional, default: True
Description: Skip processing if result already exists. In order to re-run current script it is useful to repeat the processing only if the respective output does not already exist. This allows for incremental processing of large projects.

possible input	evaluates to
1, true, yes, Boolean(True), True	Boolean(True)
0, false, no, Boolean(False), False	Boolean(False)

-distribute determine how many local processes should be used

Type : String
Remark : optional
Description: according to the number chosen as the value, independent processes are being started to parallelise (parts of) the program and therefore enhance the runtime.

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.

Examples

The data used in the following examples can be found in the $OPALS_ROOT/demo/ directory.

Example 1

In the first example, only strip data files are specified as input parameter:

qltPrecision -i strip11.laz strip12.laz strip21.laz

This will result in all parameters being set to default. Masked/unmasked precision grid files and color coded raster maps as well as mosaics will be generated.

Example 2

The second example shows the use of the -slopeLimits parameter:

qltStripDiff -i strip*.laz -slopeLimits 20 30

This command will split the results into three different categories. Firstly, output files containing no slope classification (entire data set). Secondly, output files for the slope class 0% - 20% and finally output files containing all data points with > 20% slope. The output files are named according to their band numbers, in this case band 0, 1, and 2 will be generated. The histograms can be customized to display appropriate bin widths and margins by changing the -binWidth and -sampleRange parameters in the configuration file.

Example 3

In this example we are calling the opalsQuality script directly and using the -activeScripts parameter.

opalsQuality -i strip*.laz -activeScripts qltPrecision -slopeLimits 20

OpalsQuality will only execute qltPrecision, the other subscripts will be ignored.

Table of Contents