IMAGESUM

Description

Performs an arithmetic summation of raster data, and saves the result to the specified output channel.

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	0 - 1
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(s) to process.

FILO

Specifies the name of the PCIDSK image file to receive the summed channel. If the output file is not specified, it is 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 FILI will be copied to the new FILO.

DBIC

Specifies the input 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 one output raster channel to receive the image produced by the summation of the input image channel(s).

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

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.

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

IMAGESUM takes all the pixel values from the specified input channel(s) and adds them up, then places the sum values in the output channel.

Example

This example demonstrates the use of IMAGESUM in generating an arithmetic summation channel from 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	! output channel	

EASI>RUN IMAGESUM