TBTIMAGE

Description

Reports status and differences of each pixel for input and reference image data from GDB files.

Parameters

tbtimage(fili, dbic, filref, dbic_ref, tbtype, tolerance, filo)

Name	Type	Caption	Length	Value range
FILI *	str	Input image file	1 -
DBIC	List[int]	Input image channels	0 -	Default: 1
FILREF *	str	Input reference file	1 -
DBIC_REF	List[int]	Input reference image channels	0 -	Default: 1
TBTYPE	str	Tolerance test type	0 - 4	DEM|IMG Default: IMG
TOLERANCE *	str	Tolerance value	1 -
FILO *	str	Output filename	1 -

* Required parameter

Parameter descriptions

FILI

The name of the input file to compare with the reference file FILREF.

DBIC

Specifies the input image channels which will be tested. If there are more than one value; DEM test will use first value only. If the value is empty; DEM test will take first channel and image test will take all channels.

FILREF

The reference file against which input file is compared.

DBIC_REF

Specifies the input image channels of reference file. If there are more than one value; DEM test will use first value only. If the value is empty; DEM test will take first channel and image test will take all channels.

TBTYPE

Which type of tolerance test will be applied. Valid value will be DEM or IMG.

TOLERANCE

Tolerance value will be used during comparing raster data.

FILO

Specify the name of file in which to write the results of the test. The output file is always PIX (PCIDSK) format.

Return Value

Returns: Program execution status

Type:  PCI_INT

The return value is 0.

This function returns only if it executes successfully; otherwise, it throws an exception.

Details

This function uses the tolerance value to measure input and reference image data. If test type is dem; test will use first input channel(or first channel if there is no input). If test type is image; test will use input channel list(or all channels if there is no input). Test will compare image from pixel to pixel. Output result will be write to output PIX file. Two channels will be gerented for each tested channel.

First channel is data status channel. Each pixel of this channel presents data class of status after compare input data with reference data. When user display this channel as pesudocolor; different color will show the classfied data.

Second channel is data different channel. Each pixel of this channel presents acturally data different between input data with reference data.

Data will be classified as:

The two input files must be formats supported by GDB.

The two input channel must have same size, data type and georeference.

Example

Measure two image data from PCIDSK file with a tolerance value.

from pci.tbtimage import tbtimage

fili      =  'testdata.pix'
dbic      = []
filref    =  'reference.pix'
dbic_ref  = []
tbtype    = 'dem'
tolerance = '10'
filo      = 'output.pix'

tbtimage(fili, dbic, filref, dbic_ref, tbtype, tolerance, filo)