OEMODEL

Computes block adjustment


EnvironmentsPYTHON :: EASI :: MODELER
Quick linksDescription :: Parameters :: Parameter descriptions :: Return Value :: Details :: Example :: Related

Back to top

Description


OEMODEL computes the block adjustment for a CATALYST Professional OrthoEngine project file. It uses the math model computation appropriate to the model specified in the OrthoEngine project file.
Back to top

Parameters


oemodel(oeproj, tfile)

Name Type Caption Length Value range
OEPROJ * str Input OrthoEngine Project File 1 - 191  
TFILE str Output Text File Name 0 - 191  

* Required parameter
Back to top

Parameter descriptions

OEPROJ

Specifies the name of the OrthoEngine project file. Images in this project file must have math model information. The model computed will be a block adjustment of all images in the project file.

The updated math model is automatically saved to a math model segment of each image in the project. If the image files are not in PCIDSK format, a linked PCIDSK file with the same name is created in the same folder to store the math model segment. This linked PCIDSK file can be used as input data for other functions.

TFILE

If specified, the following information will be output to the file:

['PATH\FILE.PIX'];[DBIC];[MMSEG]

The text file format is delimited by semi-colons and is in the same order as MFILE parameter specifications (see ORTHO). The TFILE parameter, therefore, can be used as input for the ORTHO parameter MFILE. The DBIC parameter is left empty to reset all channels.

An example of the TFILE output format is as follows:

'C:\pci\S129.pix'; ; 4
'C:\pci\S130.pix'; ; 4

If no path is stored in the project file, the working directory is used to fill in the path information for the text file output. If the text file already exists, the user is prompted to cancel or overwrite it.

Back to top

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 instead of returning.

Back to top

Details

OEMODEL calculates the mathematical model required for orthorectifying a set of images contained in an OrthoEngine project file. The GCPs and orbit information are taken from the project file. The appropriate math model calculation task is called depending on the math model specified in the project file.

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

Example

Export the math model of an OrthoEngine project file called 'airphoto_model.prj'.

from pci.oemodel import oemodel

oeproj = "airphoto_model.prj"   # input project file
tfile = "out.txt"	# log all the processed
# images  information

oemodel(oeproj, tfile)

OEMODEL computes the model that will be a block adjustment of all images in the project file. The updated math models are automatically saved into the math model segment of each image in the project. The images processed and the corresponding math model segment number, are directed to an output text file named 'out.txt'.

© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.