THMROVR

Description

Takes two or more thematic rasters, overlays them, and produces a new output thematic raster.

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 channels	2 -
DBIB	Integer	Input bitmap mask segment	0 - 1
DBOC	Integer	Output thematic raster channel	0 - 1
OMETHOD	String	Overlay method	0 - 12	UNION \| INTERSECTION Default: UNION
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 input PCIDSK file that contains the thematic rasters to overlay. All input thematic rasters must have the same projection/datum and pixel size.

FILO

Specifies the name of the PCIDSK image file to receive the output thematic raster, which is a combination of all of the input channels.

DBIC

Specifies the channels of thematic raster data to combine. At least two input raster channels must be specified.

All input thematic rasters must have the same projection/datum and pixel size.

Ranges of channels or segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}. When you are not specifying a range in this way, only 48 numbers can be specified explicitly.

DBIB

Specifies the segment that contains the input area mask, which indicates the area to process. Only the area under the bitmap will be processed. The bitmap must have the same projection/datum and pixel size as the input thematic rasters.

DBOC

Specifies the channel to receive the output thematic raster, which is a combination of all of the input channels.

OMETHOD

Specifies the method to use for the overlay processing.

Available options are:

UNION: union of input data. Overlays all the shapes from all the input channels. This is the default value
INTERSECTION: intersection of input data. Restricts the overlay to the common areas shared by all the shapes of the input channels.

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

THMROVR overlays data from input thematic raster layers. Available combination methods include:

Union of input data: overlays all the shapes from all the input channels
Intersection of input data: restricts the overlay to the common areas shared by all the shapes of the input channels

For example, if you overlay a shape on an area of 'No_Data', the UNION option will output the shape while the INTERSECTION option will not because 'No_Data'is not a valid shape and there is no intersection of shapes.

All the attributes from all the input channels are passed to the resulting thematic raster. The function appends an underscore 1, 2, etc. to each channel's attributes, ensuring that each input channel's attributes remains unique in the output. For example:

input channel 1 has attributes user1, user2
input channel 2 has attributes user1, user2
resulting thematic raster attributes would have user1_1, user2_1, user1_2 and user2_2

The output thematic raster gets a new area calculated for the new resultant overlay.

Example

The following example produces a new output thematic raster in "output.pix", based on the two input thematic rasters in irvine.pix.

EASI>fili	=	"irvine.pix"	! input file
EASI>filo	=	"output.pix"	! output file will be created
EASI>dbic	=	6,7	! input thematic raster channels
EASI>dbib	=		! no bitmap mask 
EASI>dboc	=	                
EASI>omethod	=		! default, "UNION"

EASI>RUN THMROVR

Environments	PYTHON :: EASI :: MODELER
Quick links	Description :: Parameters :: Parameter descriptions :: Details :: Example

THMROVR

Overlay thematic raster channels

Description

Parameters

Parameter descriptions

Details

Example