IMAGEINV

Description

Finds the inverse of the input raster channel(s).

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 channel(s)	1 -
DBOC	Integer	Output raster channel(s)	0 -
EMPTYVL	Float	Replacement for invalid numeric value	0 - 1	0.0001 - 100000.0 Default: 1.0
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 channels to process.

FILO

Specifies the name of the PCIDSK image file to receive the output channels. If this parameter is not specified, it will be assumed to be the same as FILI. If FILO exists, its projection must be the same as FILI.

If FILO does not exist, a new PCIDSK file will be created. By default, the georeferencing information from the input file is copied to the new output file.

DBIC

Specifies the input raster channel(s) to be processed.

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.

DBOC

Specifies the output raster channel(s) to receive the image produced by taking the inverse of the input image channels (DBIC).

If the output file already exists, the output channels (DBOC) must be specified, the output channel type must be CHN_32R, and the number of output channels must be the same as the number input channels (DBIC).

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.

EMPTYVL

Specifies the number used as replacement for invalid numerical values.

The default value is 1.0.

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

IMAGEINV takes all the pixel values from the input channel(s) and calculates the inverse value, placing those values in the output channel(s). If an invalid value exists, the value specified in the Replacement Value parameter is used instead.

Example

This example demonstrates the use of IMAGEINV in taking the inverse of input raster channels.

EASI>fili	=	"irvine.pix"	! input file
EASI>filo	=	"output.pix"	! output file (will be created)
EASI>dbic	=	1, -5	! input channels
EASI>dboc	=	1, -5	! output channels
EASI>emptyvl	=		! use default of 1.0

EASI>RUN IMAGEINV