STAMPJOIN

Description

Overlays two raster or thematic raster channels to generate an output raster which is a combination of the two input channels.

Parameters

Name	Type	Length	Value range
Input1: Primary input raster channel *	Raster port	1 - 1
Input2: Secondary input raster channel *	Raster port	1 - 1
Bitmap: Area mask	Bitmap port	0 - 1
Output: Output raster channel	Raster port	0 - 1
Overlay Function	String	0 - 1	STAMP | JOIN Default: JOIN
Report	String	0 - 192	See parameter description

* Required parameter

Parameter descriptions

Input1: Primary input raster channel

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

Input2: Secondary input raster channel

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

Bitmap: Area mask

Specifies the bitmap segment that defines the area from which to sample data from the input channels.

If this parameter is not specified, the entire channel is processed by default.

Output: Output raster channel

Specifies the output channel to receive the generated raster image combination of the two input channels.

If the specified output file does not exist, a new output channel is automatically created, and this parameter is ignored.

If the specified output file already exists, this parameter must be specified. The specified output channel cannot be the same as the input channel.

Overlay Function

Specifies the method used to generate the output raster channel.

Report

Specifies where to direct the generated report.

Available options are:

• LOG: generates a report on the terminal (default)
• <modulename.RPT>: appends a report to the module's RPT file
• DISK: generates a report on file "IMPRPT.LST"

Details

STAMPJOIN overlays two input raster or thematic raster channels to generate an output raster combination of the two input channels.

The output thematic raster layer contains attributes consisting of all of the input attribute fields. Essentially, a union of the input attribute fields is generated. If there is an attribute in the secondary table with the same name as one in the primary table, a merge of the attributes is performed. For example, stamping a LandCover thematic raster (secondary) with a Lakes (primary) thematic raster. If an attribute named Type exists in both tables, the output will have a field named Type and the entries from the secondary values will be copied and inserted appropriately in the output table. When an attribute exists only in one of the input channels, the output will contain "No Data" entries for that field.

The output raster type (8U, 16S, 16U, or 32R) is dependent on the raster type of the input channels. In general, the output raster type will be the highest of the input raster types; therefore, combining an 8U channel with a 16S channel will result in a 16S output channel. In some cases, a further check is required, involving the range of values. The output raster type should only be as large as required. Combining an 16S with a 16U could result in a 16S if the output values are between -32K and 32K, a 16U if output values are between 0 and 64K, and a 32R if nothing else is sufficient. In the case of Stamp, extra care must be taken because the output values can have a range of more than either of the inputs.

There must be exactly two input channels: a primary and a secondary. The primary input sets the projection and pixel size for the output raster. The secondary raster will be resampled, if necessary, to match the pixel size of the master input. The primary raster channel must contain a "No Data" value.

You may also specify an optional bitmap mask input. If a mask is specified, only pixels under the mask are processed.