RECALC

Description

If necessary, RECALC recomputes the math models of an existing OrthoEngine project and writes the result to the output OrthoEngine project file.

Parameters

recalc (oeproji, force, oeprojo)

Name	Type	Caption	Length	Value range
OEPROJI *	str	Input OrthoEngine project	1 -
FORCE	str	Force math model recalculation	0 - 3	Yes \| No Default: No
OEPROJO *	str	Output OrthoEngine project name	1 -

* Required parameter

Parameter descriptions

OEPROJI

The name of the OrthoEngine project in which to recalculate the math models.

FORCE

Control whether to force recalculation of the math models.

Supported values are:

YES: always recalculate the math models.
NO: Only recalculate the math models only when necessary, i.e. when they are stale. This is the default value.

OEPROJO

The path and file name of the output OrthoEngine project.

If you specify your input project as your output project, then the input OrthoEngine project is updated with the recalculated math models.

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

RECALC reads the input OrthoEngine project and determines if it is necessary to recalculate the bundle-adjusted math models. When set up to force the recalculation, RECALC recalculates the math models regardless of whether it is needed; otherwise, RECALC performs the recalculation only when necessary. After recalculating the math models, RECALC writes the results to the OrthoEngine project specified as output.

RECALC can be used with OrthoEngine projects that use the following math-model types:

ADS
Airphoto
Rational Polynomial Coefficients (RPC)
Toutin's Model (SRIT)

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

Example

Recalculate the math model of an OrthoEngine project.

from pci.recalc import recalc

oeproji = "airphoto_model.prj"
force = "YES"
oeprojo = "airphoto_model_recalced.prj"
recalc(oeproji, force, oeprojo)

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