IMAGESQR

Description

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

Parameters

imagesqr(fili, filo, dbic, dboc, emptyvl)

Name	Type	Caption	Length	Value range
FILI *	str	Input file name	1 -
FILO	str	Output file name	0 -
DBIC *	List[int]	Input raster channel(s)	1 -
DBOC	List[int]	Output raster channel(s)	0 -
EMPTYVL	List[float]	Replacement for invalid numeric value	0 - 1	0.0 - Default: 0.0

* 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.

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).

EMPTYVL

Specifies the number used as replacement for invalid numerical values.

The default value is 1.0.

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.

from pci.imagesqr import imagesqr

fili	=	"irvine.pix"	# input file
filo	=	"output.pix"	# output file (will be created)
dbic	=	list(range(1, 5 + 1))	# input channels
dboc	=	list(range(6, 10 + 1))	# output channels
emptyvl	=	[]	# use default of 0.0

imagesqr( fili, filo, dbic, dboc, emptyvl )