CNTGTHMR

Description

CNTGTHMR converts a raster to a thematic raster that has contiguous areas, and assigns a unique group value to the pixels.

Parameters

Name	Type	Caption	Length	Value range
FILI *	String	Input file name	1 - 192
FILO	String	Output file name	0 - 192
DBIC *	Integer	Input raster image channel	1 - 1
DBOC	Integer	Output thematic raster channel	0 - 1
DIAGONAL	String	Diagonal method	0 - 15	One Group | Separate Groups Default: One Group
REPORT	String	Report mode	0 - 192	Quick links
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILI

Specifies the name of the PCIDSK file that contains the raster channel to process.

FILO

Specifies the name of the PCIDSK file to receive the output thematic raster layer.

If FILO is not specified, FILI is used for the new thematic raster layer. If FILO is specified but does not exist, a new file is created.

DBIC

Specifies the raster channel that contains the image for which the thematic raster will be constructed.

DBOC

Specifies the channel to receive the output thematic raster with its associated raster attributes.

If FILO is an existing file, DBOC must be specified with a CHN_32R type. If FILO does not exist, DBOC is ignored.

DBOC cannot be the same as DBIC (input layer).

DIAGONAL

Specifies how to combine two or more pixels with the same value that are joined anywhere at a diagonal.

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

MONITOR

The program progress can be monitored by printing the percentage of processing completed. A system parameter, MONITOR, controls this activity.

Available options are:

• ON: Turns the monitor ON (default)
• OFF: Turns the monitor OFF (recommended if running in batch or background mode)

Details

CNTGTHMR converts a normal thematic raster or a regular raster into a contiguous thematic raster. A contiguous thematic raster is is a raster where only contiguous pixel regions have the same value.

For example, all the lake pixels for a classified image have the same value. Although the lakes are disconnected (because they have the same pixel value), they point to the same record when they become thematic (that is, an attribute table is generated).

In some cases, an analysis should be performed on contiguous areas only. For example, if all lakes that have more than a specified Area are found, a normal thematic raster cannot be used. After running CNTGTHMR, all lakes have separate records and the Area values are given for each lake.

Example

Read raster channel 6 from "irvine.pix" and store the output thematic raster channel in a new file named "oirvine.pix". DBOC is 1 for the new file and the "One Group" method is used.

EASI>FILI     = "irvine.pix"
EASI>FILO     = "oirvine.pix"    ! specifies the new output file
EASI>DBIC     = 6                ! uses input raster channel 6
EASI>DBOC     =                  ! uses output channel 1 for the new file
EASI>DIAGONAL = ""               ! defaults to "One Group"
EASI>REPORT   = "DISK"           ! sends the report to a disk
EASI>MONITOR  = "ON"             ! turns the progress counter on

EASI>run cntgthmr