RAS2PTATT

Description

RAS2PTATT converts multiple raster channels to a vector file with attributes table.

Parameters

ras2ptatt(fili, dbic, filref, dbic_ref, attname, filo, ftype, foptions, mapunits)

Name	Type	Caption	Length	Value range
FILI *	str	Database input file name	1 -
DBIC	List[int]	Database Input Channel List	0 -
FILREF	str	File containing reference layer	0 -
DBIC_REF	List[int]	Database reference input channel	0 -
ATTNAME	str	Attribute Name Format	0 -
FILO *	str	Output vector points layer with its associated attribute table.	1 -
FTYPE	str	Output file type	0 - 4	PIX|SHP Default: PIX
FOPTIONS	str	Options for output format	0 - 64
MAPUNITS	str	Projection map units	0 -

* Required parameter

Parameter descriptions

FILI

The name of the input PCIDSK (.pix) which contain the displacements or cumulative displacements corresponding to the time intervals bracketed by the temporally ordered acquisition dates.

DBIC

The input channel or channels to be exported.

If not specified, all channels are exported.

FILREF

This parameter specifies the name of the input file containing the bitmap, vector used to sample the input channels from FILI.

If not specified, all valid pixels in FILI are exported.

DBIC_REF

The bitmap or channel number of the reference file.

ATTNAME

• If ATTNAME is "channame", then use the channel description for the output attribute names.
• If ATTNAME is not empty, then use ATTNAME as the key to look up in the channel metadata for the output attribute names.
• If ATTNAME is empty, then use "Ref_Acquisition_DateTime" and "Dep_Acquisition_Time" channel metadata values for the output attribute names.

FILO

Specifies the name of the GDB vector file that will contain the exported points.

Every PSC is represented as a 2D point with XY coordinates in the projection specified by MAPUNITS. The points have X and Y attributes and value attributes for each raster layer. The name of the value attribute is formed using the start and end acqusition dates of the corresponding layer.

FTYPE

Optionally specifies the output file format type, represented by a three- or four-letter code.

FOPTIONS

The options specific to the format to apply when creating the output file. With each, the default of no options is allowed (empty string).

MAPUNITS

Specifies the projection string for the output points.

If not specified, the projection of FILI will be used.

Details

RAS2PTATT reads the stack of displacements for each acquisition time step, and exports a vector layer of points.

Example

The following example exports a displacement at the non-overlapping acquisition intervals into the vector layer of point type.

from pci.ras2ptatt import ras2ptatt

fili = "PSI_Displacements.pix"
dbic = []
filref   = ""
dbic_ref = []
filo = "PSI_Displacements_Vec.pix"
ftype = ""
foptions = ""
mapunits = ""

ras2ptatt(fili, dbic, filref, dbic_ref, filo, ftype, foptions, mapunits)