OEBUNDLEOPT

Description

OEBUNDLEOPT updates a CATALYST Professional OrthoEngine project file with new bundle options.

Parameters

oebundleopt(oeproji, oeprojo, trimode, absopt, maxiter, xyzthr, angthr, refract, radearth)

Name	Type	Caption	Length	Value range
OEPROJI *	str	Input OrthoEngine project file	1 -
OEPROJO *	str	Output OrthoEngine project file	1 -
TRIMODE	str	Triangulation method	0 - 6	TRAD\|ENFIT\|RELABS\|REL\|ABS\|FN Default: TRAD
ABSOPT	str	Absolution-orientation options	0 - 6	3DTR\|LINEAR\|POLY2\|POLY3\|POLY3D Default: 3DTR
MAXITER	List[int]	Maximum number of adjustment-computation iterations	0 - 1	1 - 999 Default: 100
XYZTHR	List[float]	Threshold of convergence on camera position	0 - 1	0.0 - Default: 0.10
ANGTHR	List[float]	Convergence threshold of EO angles	0 - 1	0.0 - Default: 0.50
REFRACT	str	Apply atmospheric refraction correction	0 - 3	Default: ""
RADEARTH	List[float]	Earth radius to use in curvature correction	0 - 1	6000000 - 23000000

* Required parameter

Parameter descriptions

OEPROJI

The path and file name of the input OrthoEngine project file.

OEPROJO

The path and file name of the output OrthoEngine project file.

TRIMODE

The triangulation method to use.

You can choose from the following options:

Trad: Uses the ground control points (GCP) and tie points (TP), and bases the adjustment on the weight assigned by the defined input accuracy of each point. The default GCP accuracy is one half of a pixel in space on disk and 1 meter in object space. The model bases the calculation on a simultaneous use of both GCPs and TPs. In this mode, math model is recalculated several times to find the best possible solution. This option is recommended for most situations.
Enfit: Uses the GCPs and TPs; however, the GCPs and TPs do not carry the same weight. The weight of the TPs is assigned by the input accuracy whereas the weight of the GCPs is unlimited (contains no error).
You can use this mode when you are collecting GCPs for a high-resolution image from a lower-resolution source, provided the GCP source is accurate and reliable. In some cases, the residual error or root mean square (RMS) error produced by using this mode can be lower than the Traditional block bundle mode; however, the results may not be as accurate.
RelAbs: In this mode, both TPs and Stereo GCPs are used to perform the adjustment. The TPs are used first in the calculation followed by the GCPs to adjust the model.
An example of when to use this method is when the confidence in the accuracy of GCPs is not high or is unknown, but confidence in the TPs is higher.

The residual error or RMS error produced in this mode can sometimes be lower than that of Trad; however, the results may not be as accurate.
Rel: In this mode you can separate the calculation of the model into two distinct steps.
Only TPs are used in the bundle-adjustment calculation. GCPs are required, but excluded from the calculation of the model. After computing the relative orientation, you can inspect the residuals, make adjustments, as necessary, and then recalculate.

This mode functions similarly to Relative-absolute orientation, except without the application of the GCPs into the model. You can select this mode when confidence in the GCPs is not as high as with using the Trad or Enfit modes.
Abs: In this mode, both Stereo GCPs and TPs exist in the project. The model must have been computed previously by running a bundle adjustment in Relative orientation mode before using this mode. The GCPs are used to adjust the relative-orientation model computed previously. This mode functions similarly to RelAbs, except that the model is computed in two distinct steps instead of one. You can calculate both components (TPs and Stereo GCPs separately). You can select this mode when confidence in the GCPs is not as high as with using the Trad or Enfit modes.
FN: Select this mode when confidence in the Global Positioning System (GPS), inertial measurement unit (IMU) or both of the sensor is low.
In this mode, the accuracy of the camera position and angles will be discarded and replaced by default values. OEBUNDLEOPT will adjust the solution using a larger space.

ABSOPT

The options for absolute orientation when the triangulation mode is either Abs (absolute) or RelAbs (relative absolute).

You can choose from the following options:

3DTR: This is the default option and uses seven parameters: scale, translation (x, y, and z), and rotation (omega, phi, and kappa). It is the most conservative option to select when the GCP error is unknown or has lower accuracy. If the GCPs are inaccurate or the GCP error is not known, the stereo model will not be affected significantly by using this option.
Linear: This option can provide results that are closer to enforced fitting; however, if the GCP error is unknown or is large, then 3-D conformal transformation provides a more conservative approach
POLY2: If the GCP error is zero, or close to zero, this option provides results that are nearer to the Enfit method; however, choosing this option contains a higher risk if the GCPs contain and error.
POLY3: If the GCP error is zero, or close to zero, this option provides results that are nearer to the Enfit method; however, choosing this option contains a higher risk if the GCPs contain and error.
POLY3D: Select this option for aerial projects that contain only a single (potentially) long strip of data. If your block bundle contains more than one strip of data (more than one flight line), this option is not recommended.

Note: This parameter is optional; however, if you do not specify a value, the 3DTR option applies by default.

MAXITER

The maximum number of iterations that the adjustment computation can perform before finishing. The default value is 100.

XYZTHR

The criteria for bundle-adjustment convergence for the camera positions. The units are in meters or feet, depending on the map projection defined in the project file. The default value is 0.1.

ANGTHR

The convergence threshold, in degrees, for the EO angles. The default value is 0.5.

REFRACT

Specifies whether to apply atmospheric refraction correction when doing bundle adjustment. Available options are:

"" : Do not change the Apply atmospheric refraction correction setting (default option)
YES : Apply atmospheric refraction correction
NO : Do not apply atmospheric refraction correction

It is well known that density and hence of refraction of the atmosphere decreases with increased altitude. Because of this condition, light rays do not travel in straight lines though the atmosphere, but rather are bent according to Snells law. Refraction causes all imaged points to be displaced outward from their correct positions.To correct for refraction, the following formula is used:

dref = K(r + r3/c2 )

where K = (( 2410 * H / (H * H) - 6 * H + 250) - (2410 * ((h * h) / ((h * h) - 6 * h + 250) * H )) 10e-6

These equations are based on a model atmosphere defined by the US Air Force. The flying height H and the ground elevation h must be in units of kilometers.

RADEARTH

Specifies the radius value, in meters, of the Earth in the working area.

If this parameter is not specified, errors caused by the curvature of the Earth are not corrected. This is the default.

An average value of 6,372,200 meters can be used, depending on the GCP unit.

Return Value

Returns: program execution status

Type: PCI_INT

The return value is 0. This function returns a result only if it runs successfully; otherwise, processing stops, and an error message is displayed.

Details

OEBUNDLEOPT updates an OrthoEngine project file with new bundle options; typically, after running CRPROJ.

Example

from pci.oebundleopt import oebundleopt

oeproji = 'airphoto_model.prj' # input project file
oeprojo = 'out.prj' # output project file
trimode = 'trad'
absopt = 'linear'
maxiter = [10]    # iterate the adjustment a maximum of 10 times
xyzthr = []		  # use the default camera position ...
angthr = []		  # ... and orientation-angle-convergence criteria
refract = ""
radearth = []
oebundleopt(oeproji, oeprojo, trimode, absopt, maxiter, xyzthr, angthr, refract, radearth)

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