QLTY2MASK

Description

From a quality image, QLTY2MASK creates a bitmap mask, which can be used as an exclusion mask in color balancing and collection of ground control points (GCP) and tie points (TP).

Parameters

Name	Type	Caption	Length	Value range
FILI *	String	Input file name	1 - 192
FILO *	String	Output file name	1 - 192
REPORT	String	Report mode	0 - 192	Quick links

* Required parameter

Parameter descriptions

FILI

The name of the GDB-supported file that contains the quality image.

FILO

The path and name of the PCIDSK file to which to write the bitmap mask.

If an output file does not exist, a new file is created. If you want to write the bitmap layer to the input file, you can enter the name of the input file as that of the output.

If an output file of the same name exists already in the specified folder, it must have the same projection and extents as the input file; however, the resolution can differ. For example, with an input quality image of 30 meters, an output file with a 15-meter bitmap can be created.

REPORT

Specifies where to direct the generated report.

Available options are:

• TERM: generates a report on the terminal (default)
• DISK: generates a report on file "IMPRPT.LST"
• OFF: turns off report generation
• <filename>: appends a report to the specified file

Details

QLTY2MASK creates a bitmap mask from a quality image.

A quality image is classified to denote land-cover types, water, clouds, and so forth. The image can be created by running the SPECL algorithm or the SPECLASS algorithm. Some products, such as Landsat and Sentinel-2, provide a quality image as a layer.

Classes suitable for neither color balancing nor GCP and TP collection will be converted to a bitmap mask, which can then be used as an exclusion mask in these processes.

Example

The following example creates a bitmap mask from a Landsat-8 quality image into a Landsat-8 panchromatic data set.

EASI> FILI = "landsat8_MS.pix"
EASI> FILO = "panchromatic.pix"
EASI> RUN qlty2mask