IMAGENEG

Description

Multiplies by -1 the raster information in the input file, thereby producing an arithmetic negation of the raster data.

Parameters

imageneg(fili, filo, dbic, dboc)

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 -

* 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 channel. If the output file is not specified, it is assumed to be the same as the input file (FILI). If FILO exists, its projection must be the same as FILI.

If the specified output file 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 image channels to be processed.

DBOC

Specifies the output image channels produced by the negation of the input image channels (DBIC).

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

The number of output channels must be the same as the number of input channels.

Details

IMAGENEG takes all the pixel values from the input channel(s) and multiplies them by -1, placing the resulting values in the specified output channel(s).

Example

This example demonstrates the use of IMAGENEG.

from pci.imageneg import imageneg

fili	=	"irvine.pix"	# input file
filo	=	"output.pix"	# output file (will be created)
dbic	=	list(range(1, 5 + 1))	# input channels
dboc	=	list(range(1, 5 + 1))

imageneg( fili, filo, dbic, dboc )