TBTIMAGE

Measure image data with input tolerance to validate image quality.


EnvironmentsPYTHON :: EASI
Quick linksDescription :: Parameters :: Parameter descriptions :: Details :: Example :: Related

Back to top

Description


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

Parameters


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

* Required parameter
Back to top

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.
Back to top

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:

EQUAL Transparent equal
GOOD Green within tolerance
CLOSEWARN Yellow within and near tolerance
CLOSEFAIL Pink above and near tolerance
FAILED Red above tolerance
NODATA Black one of the values is NoData
NAN Blue one of the values is not a number
INF Purple one of the values is infinity

The two input files must be formats supported by GDB.

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

Back to top

Example

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

EASI>FILI      =   "testdata.pix"
EASI>DBIC      =
EASI>FILREF    =   "reference.pix"
EASI>DBIC_REF  =
EASI>TBTYPE    =   "dem"
EASI>TOLERANCE =   "10"
EASI>FILO      =   "output.pix"

EASI>RUN TBTIMAGE
        

© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.