THMRMER

Description

Creates a new thematic raster based on merging pixel values by attributes.

Parameters

Name	Type	Caption	Length	Value range
FILI *	String	Input file name	1 - 192
FILO	String	Output file name	0 - 192
DBIC *	Integer	Input thematic raster channel	1 - 1
DBOC	Integer	Output thematic raster channel	0 - 1
ADJSHP	String	Shape merging method	0 - 15	ADJACENT | ALL Default: ADJACENT
JOINDGL	String	Join polygons at diagonal	0 - 3	YES | NO Default: YES
ATTRLIST	String	Attribute names	0 - 660
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 thematic raster image channel.

FILO

Specifies the name of the PCIDSK image file to receive the processed thematic raster channel. If the output file is not specified, it will be assumed to be the same as FILI. If the specified output file already exists, its projection must be the same as that of the input file.

If FILO is specified but does not already exist, a new PCIDSK file will be created. By default, the projection information from FILI will be copied to the new FILO.

DBIC

Specifies the input channel that contains the input raster or thematic raster.

DBOC

Specifies the output channel to receive the generated thematic raster.

If the specified output file (FILO) exists, this parameter must be specified.

ADJSHP

Specifies the method to use for merging shapes.

JOINDGL

Specifies whether to join polygons at diagonals.

ATTRLIST

Specifies the list of attributes to use for merging.

This parameter can list 10 attributes, separated by blank spaces.

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

THMRMER merges classes within a thematic raster to create a new thematic raster with aggregated classes. The classes to be merged are based on the attribute(s) specified. For two classes to be merged, the value within the specified attribute(s) must be the same for those two classes. The location of the pixels that form the classes can also be taken into account, if desired. You can specify that only adjacent (neighboring) pixels are to be merged, or that all of the classes that are attribute matches should be merged.

For example, suppose you have detailed data at the county level for a whole country, but are only interested in information at the state/provincial level. If the county data has an attribute indicating the state/province to which it belongs, you can use THMRMER to aggregate the county classes together to a state/provincial level.

If you want more control over the attributes that you want in the output thematic raster, you can use the Dissolve tool in CATALYST Professional Focus.

Example

This example demonstrates the use of THMRMER to generate a thematic raster layer based on attributes.

EASI>fili	=	"thmrcover.pix"	! input file
EASI>filo	=	"output.pix"	! output file
EASI>dbic	=	1	! input thematic raster channel
EASI>dboc	=	1	! output channel
EASI>adjshp	=	"ADJACENT"	! adjacent shapes
EASI>joindgl	=	"YES"	! join at diagonal
EASI>attrlist	=	"Perimeter theme1"	! field names(attributes)

EASI>RUN THMRMER