IMAGESQR

Description

Finds the square root of the input raster channels and places the value in the specified output file.

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.0 - Default: 0.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 processed output channels. If the output file 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 already 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 output image channels to receive the image produced by taking the square root of the input image channels (DBIC).

If FILO is an existing file, DBOC must be specified, and the output channel type must be CHN_32R.

The number of output channels (DBOC) must be the same as the number of 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

IMAGESQR takes all the pixel values from the input channel(s) and calculates the square root 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 IMAGESQR in taking the square root 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	=	6, -10	! output channels
EASI>emptyvl	=		! use default of 0.0

EASI>RUN IMAGESQR