TPEXPORT

Description

TPEXPORT exports Tie Point (TP) data from an OrthoEngine project and writes the data to a specified text file.

Parameters

tpexport(tfile, tpformat, oeproj, tpprefix)

Name	Type	Caption	Length	Value range
TFILE *	str	Output text file name	1 -
TPFORMAT	str	Tie Point data format	0 - 7	2D, 2DERR, 3D, 3DERR, 3DXYZ Default: 3DERR
OEPROJ *	str	Input OrthoEngine project file name	1 -
TPPREFIX	str	Tie Point identifier prefix	0 - 60

* Required parameter

Parameter descriptions

TFILE

Specifies the path and file name of the text file to which the Tie Point data will be written. If a file with the specified name already exists when TPEXPORT attempts to create it, the function throws an exception.

TPFORMAT

Specifies the format in which the Tie Point data will be written to the output text file. [Status] is only written as "I" if the TP is inactive.

Supported formats provide the following information:

2D: [Tie_Point_ID] [Image_ID] [Pixel] [Line] [Status]
2DERR: [Tie_Point_ID] [Image_ID] [Pixel] [Line] [Pixel_Error] [Line_Error] [Status]
3D: [Tie_Point_ID] [Image_ID] [Pixel] [Line] [Elevation] [Status]
3DERR: [Tie_Point_ID] [Image_ID] [Pixel] [Line] [Pixel_Error] [Line_Error] [Elevation] [Elevation_Error] [Status].
3DXYZ: [Tie_Point_ID] [Image_ID] [Pixel] [Line] [GROUND X] [GROUND Y] [Elevation] [Status]

OEPROJ

Specifies the name of the OrthoEngine project file that contains the Tie Point data to export.

TPPREFIX

Specifies a prefix string that will be added to the Tie Point identifiers read from the input OrthoEngine project file. The new Tie Point IDs will appear in the text file in the [Tie_Point_ID] field. See the TPFORMAT (TP File Format) parameter for more information.

Return Value

Returns: execution status

Type: PCI_INT

The return value is 0. This function returns only if it executes successfully; otherwise, it throws an exception.

Details

TPEXPORT reads Tie Point data from an OrthoEngine project file, creates a text file, and writes the data to that text file.

Use the TPFORMAT (TP File Format) parameter to specify the Tie Point data to export. TPPREFIX specifies the prefix to add to the Tie Point identifiers in the text file.

Note: If the specified OrthoEngine project includes any inactive images, they are excluded from processing.

Example

Read Tie Points from the OrthoEngine project file "irvine.prj" and write them to the text file "tp.txt" using the "3D" format.

from pci.tpexport import tpexport

tfile="tp.txt"
tpformat="3D"
oeproj="irvine.prj"
tpprefix=""

tpexport(tfile, tpformat, oeproj, tpprefix)

Environments	PYTHON :: EASI :: MODELER
Quick links	Description :: Parameters :: Parameter descriptions :: Return Value :: Details :: Example :: Related