| Environments | PYTHON :: EASI |
| Quick links | Description :: Parameters :: Parameter descriptions :: Details :: Example :: Related |
| Back to top |
| Back to top |
tbtvecatt(fili, dbvs, fili_ref, dbvs_ref, fldnme, tolerance, filo)
| Name | Type | Caption | Length | Value range |
|---|---|---|---|---|
| FILI * | str | Input vector file | 1 - | |
| DBVS | List[int] | Input vector segment list | 0 - | |
| FILI_REF * | str | Input reference file | 1 - | |
| DBVS_REF | List[int] | Input reference vector segments | 0 - | |
| FLDNME | str | Input field name list | 0 - | |
| TOLERANCE * | str | Tolerance value | 1 - | |
| FILO * | str | Output filename | 1 - |
| Back to top |
FILI
The name of the input vector file to compare with the reference file FILI_REF.DBVS
Specifies the input vector segments which will be tested. If the value is empty; all vector segment number will be default value.FILI_REF
The reference file against which input file is compared.DBVS_REF
Specifies the vector segments of reference file. If the value is empty; all vector segments will be default value.FLDNME
Specifies Field name list that comparison will be applied. Field name should exist in input and reference vector layer. And Fields should have same data type. If the value is empty; all fields will be used as default value.TOLERANCE
Tolerance values will be used to compare with reference data.FILO
Specify the name of file in which the results of test will be write to. The output file is always PIX (PCIDSK) format.| Back to top |
This function uses the tolerance value to validate data in two vector attribute tables which from input file and reference file. Output result file will include two vector segments.
First is data status vector segment. Each attribute field value present data class of status comparing input data and reference data with tolerance.
Second is data different vector segment. It will show the different between two attribute table where error happen.
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 input file and reference file must be formats supported by GDB and must have same georeference.
The each field in input field list must exist in vector segment attribute table of both input and reference files. And corresponding field mush have same data type.
If input field name list is empty; two vector segment attribute table of input and reference file must have same field list.
| Back to top |
Measure two vector segment attribute data with a tolerance value.
from pci.tbtvecatt import tbtvecatt
fili = 'testdata.pix'
dbvs = []
fili_ref = 'reference.pix'
dbvs_ref = []
fldnme = ''
tolerance = '10'
filo = 'output.pix'
tbtvecatt(fili, dbvs, fili_ref, dbvs_ref, fldnme, tolerance, filo)
© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.