CPMMSEG

Description

CPMMSEG copies the math model from a specified image segment in a CATALYST Professional OrthoEngine project file to a math model layer in the input file.

Parameters

Name	Type	Caption	Length	Value range
OEPROJ *	String	OrthoEngine project file name	1 - 192
FILE	String	Input file name	0 - 192
MMSEG	Integer	Output math model segment	0 - 1	Default: -999999999

* Required parameter

Parameter descriptions

OEPROJ

Specifies the name of the input OrthoEngine project file containing the math model to copy.

FILE

Specifies the name of the input image file for which the math model will be copied. FILE must be contained within the OrthoEngine project specified by OEPROJ. If FILE is not specified, all images contained within the project are copied.

The FILE parameter expects a valid Image ID that can be found in the project file. If no path is specified, the working directory is used.

The following formats are acceptable for this parameter:

FILE = "S129.pix"
FILE = "S129"
FILE = "C: \pci\s129.pix"

MMSEG

Specifies the segment to receive the copied math model. If the segment exists, overwrites the existing segment. If this parameter is not specified, CPMMSEG creates a new segment.

Details

CPMMSEG copies the math model segments of one or more files based on the computed math models contained in an OrthoEngine project file. It may either create new math model segments or overwrite existing segments. This algorithm is useful for transferring the math models from a manual OrthoEngine project to the images to be used in standalone functions where a math model is required. CPMMSEG is generally run after the OEMODEL, RSMODEL, RFMODEL, or APMODEL tasks, or from the OrthoEngine UI.

If an input file is in a format other than PCIDSK (pix) and the model segment cannot be added, CPMMSEG creates a linked pix file with the same base name as the input file, and adds the math model segment to the new file.

Important: The OrthoEngine project file contains the parameters and information required to compute a satellite math model. Due to the number of parameters, however, the project file does not explicitly store the entire math model. The binary math model segment stores the explicit math model parameters. To export a satellite model within CPMMSEG, it is therefore necessary for the model to be recomputed on the fly.

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

Example

An OrthoEngine project file named 'spotdemo.prj' contains valid math models. Export the model to every file in the project file.

EASI>OEPROJ  =   "spotdemo.prj"
EASI>FILE    =   "spotleft.pix"
EASI>MMSEG   =
EASI>REPORT  =

EASI>R CPMMSEG

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