TPIMPORT

Description

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

Parameters

Name	Type	Caption	Length	Value range
TFILE *	String	Input text file name	1 - 192
TPFORMAT	String	Tie Point data format	0 - 7	2D, 2DERR, 3D, 3DERR Default: 3DERR
OEPROJ *	String	Output OrthoEngine project file name	1 - 192
TPPREFIX	String	Tie Point identifier prefix	0 - 60
TPOPT	String	Duplicate Tie Point action	0 - 7	REPLACE | SKIP Default: REPLACE
REPORT	String	Report mode	0 - 192	Quick links

* Required parameter

Parameter descriptions

TFILE

Specifies the path and file name of the text file that contains the Tie Point data. THe Tie Point data in the text file must be in the format specified by TPFORMAT.

TPFORMAT

Specifies the format in which the Tie Point data exists in the input text file. Default for [Status] is active if not specified.

OEPROJ

Specifies the name of the existing OrthoEngine project file that will receive the Tie Point data.

TPPREFIX

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

TPOPT

Specifies the action to perform when a Tie Point record read from the input text file has the same TP ID as a Tie Point record already existing in the OrthoEngine project file.

REPORT

Specifies where to direct the generated report.

Available options are:

• TERM: generates a report on the terminal (default)
• DISK: generates a report on file "IMPRPT.LST"
• OFF: turns off report generation
• <filename>: appends a report to the specified file

Details

TPIMPORT reads Tie Point data from a text file and writes the information to an existing OrthoEngine project file.

The TPFORMAT (TP File Format) parameter specifies the file format for the Tie Point data.

If a Tie Point read from the input text file has the same identifier as one that already exists in the output project file, that Tie Point is either discarded or it replaces the record already existing in the output project file, depending on the value of TPOPT (Duplicate Points).

TPPREFIX specifies the prefix to add to the Tie Point identifiers in the OrthoEngine project file. This prefix helps to avoid matches with the Tie Point indentifiers already existing in the output project file.

Example

Read the Tie Point data from a text file named "tp.txt" and write the data to an OrthoEngine project named "irvine.prj". The Tie Points in the input text file are in "3D" format. If a Tie Point record read from the input text file holds the same identifier as a Tie Point record in the output project file, replace the Tie Point record in the output project file with the one read from the input text file.

EASI>TFILE = "tp.txt"
EASI>TPFORMAT = "3D"
EASI>OEPROJ = "irvine.prj"
EASI>TPPREFIX = 
EASI>TPOPT =     ! uses "REPLACE" by default

EASI>RUN TPIMPORT