MERGPROJ

Description

MERGPROJ merges existing OrthoEngine projects to form a single project.

Parameters

mergproj(moeproj, tfile, mergprj, prepend)

Name	Type	Caption	Length	Value range
MOEPROJ	str	List of OrthoEngine project files to merge	0 -
TFILE	str	Input text file	0 -
MERGPRJ *	str	Output OrthoEngine project file name	1 -
PREPEND	str	Add prefix to IDs	0 - 10	GCP, TP, BOTH, NONE, AT_SUBSETS Default: BOTH

* Required parameter

Parameter descriptions

MOEPROJ

Lists the OrthoEngine project files to merge into a single project file. File names may be separated by commas, or defined using a wildcard, such as e:\data\ortho*.prj

TFILE

Specifies the name of the input text file containing the list of OrthoEngine project files to merge.

For example:

TFILE = "file.txt"

where file.txt contains:

"c:\data\west_rhill.prj"
"c:\data\east_rhill.prj"
"c:\data\north_rhill.prj"
"c:\data\south_rhill.prj"

If no path is specified in the text file, the working directory is used.

Either MOEPROJ or TFILE must be specified, but not both. If MOEPROJ is specified, TFILE is ignored.

MERGPRJ

Specifies the name of the output merged OrthoEngine project file. If the file already exists, it is overwritten.

PREPEND

Specifies the type of automatic prefix to be added to the point IDs.

To prevent duplicating point IDs, the GCPs and TPs of the project files to be merged are prefixed with a sequential number. For example, if three OrthoEngine project files are to be merged, the GCPs and TPs are prefixed with "1_ " for the first file, "2_ " for the second, and "3_ " for the third. If the GCP IDs are already unique and stereo GCPs are to be included, only the IDs of the TPs are prefixed.

Supported values are:

GCP: generates unique IDs for Ground Control Points
TP: generates unique IDs for Tie Points
BOTH: generates unique IDs for both GCPs and TPs. This is the default value.
NONE: does not generate unique IDs

Return Value

Returns: Program execution status

Type: PCI_INT

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

Details

MERGPROJ merges existing OrthoEngine project files that have identical math model types, including projection and datum. For airphoto projects, the camera calibration data must be identical. Incompatible files are excluded from the merge.

Either MOEPROJ or TFILE must be specified for the program to run successfully, but not both. If MOEPROJ is specified, TFILE is ignored.

Note: All images in the specified OrthoEngine project file are processed, regardless of whether they are active or inactive.

Example

This example merges the two OrthoEngine project files named 'airphoto_1.prj' and 'airphoto_2.prj' into a single project file named 'MergedProj.prj'.

from pci.mergproj import mergproj

moeproj	=	'airphoto_1.prj,airphoto_2.prj'	# input project files
tfile	=	''	# uses moeproj to specify input files
mergprj	=	'MergedProj.prj'	# output OrthoEngine project file
prepend	=	'BOTH'	# adds prefix to both TP and GCP IDs

mergproj( moeproj, tfile, mergprj, prepend )

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