TPREFN

Name	Type	Caption	Length	Value range
OEPROJI *	str	Input OrthoEngine Project	1 -
REJECT	List[float]	Rejection method	0 - 6	See parameter description
OEPROJO	str	Output OrthoEngine Project	0 -
POINTOPT *	str	Input OrthoEngine point option	3 -	INACT \| DEL Default: INACT
IMSTAT	List[float]	Output TPREFN statistics	0 -

Parameter descriptions

OEPROJI

The name of the input CATALYST Professional OrthoEngine project file that contains the TPs to refine.

REJECT

The method to use to reject TPs.

This parameter is defined by the following parameters:

<MODE>, <PARAM1>, <PARAM2>, <MAXPT>, <MINPT>, <REMOVE_BLUNDER>

MODE=1 represents the absolute number of TPs to reject.
With the Absolute Number rejection method:
- PARAM1 represents the number of TPs to reject.
- PARAM2 represents the ratio of weighting between the x and y residuals.
For example, to give twice the weight to the x-residual as the y-residual, enter a rejection weighting of 2. By default, the residual in x and y will have the same weight. Therefore, if you have a point with an x-residual of 0.4 and a y-residual of 0.5, the point will be given an x-residual of 0.8 and a y-residual of 0.5 for the rejection.

To, for example, apply the Absolute Number rejection method (mode 1), reject 10 TPs, and give the x-residual half the weight as that of the y-residual, enter 1, 10, 0.5.

Note: Each removed TP is counted for each image that contains it. Therefore, the actual number of removed TPs might be slightly higher than the number requested or computed.
MODE=2 represents the percentage number of points to reject, starting with the one with the highest residual.
With the Percentage Number rejection method:
- PARAM1 represents the percentage of the number of TPs to reject.
- PARAM2 represents the ratio of weighting between the x and y residuals.
For example, to give twice the weight to the x-residual as the y-residual, enter a rejection weighting of 2. By default, the residual in x and y will have the same weight. Therefore, if you have a point with an x-residual of 0.4 and a y-residual of 0.5, the point will be given an x-residual of 0.8 and a y-residual of 0.5 for the rejection.

To, for example, apply the Percentage Number rejection method (mode 2), reject five percent of GCPs, and give the x-residual twice the weight as that of the y-residual, enter 2, 5 ,2.

Note: Each removed TP is counted for each image that contains it. Therefore, the actual number of removed TPs might be slightly higher than the number requested or computed.
MODE=3 represents the sigma standard deviation of points to reject. This mode determines the points with the largest x and y residuals at each iteration, and computes standard deviations of x and y residuals of all remaining points. A TP is rejected if it has the largest root-mean-square (RMS) residual, and its x-residual or y-residual value is greater than PARAM1 or PARAM2 multiplied by the x-sigma or y-sigma value, respectively.
With the Standard Deviation method:
- PARAM1 represents the minimum standard deviation value of the x-residual to reject.
- PARAM2 represents the minimum standard deviation value of the y-residual to reject.
For example, to reject points with an x-residual value higher than the x-sigma multiplied by two, and to reject points with a y-residual higher than the y-sigma of the remaining points, enter 2 for PARAM1 and 1 for PARAM2.
MODE=4 represents the absolute distance of the points to reject in the residuals. At each iteration, the point with the largest x or y residual is rejected, if the respective residual is greater than PARAM1 or PARAM2, respectively.
With the Absolute Distance rejection method:
- PARAM1 represents the minimum absolute x-pixel residuals to reject.
- PARAM2 represents the minimum absolute y-pixel residuals to reject.
Rejection starts from the point with the largest x or y residual distance.

For example, to apply the Absolute Distance rejection method (mode 4), reject pixels with an x-residual value greater than two pixels, and reject pixels with a y-residual value greater than two pixels, enter 4, 2, 2.

For this mode TPREFN will check deleted points after refinement and repeat again for those points with errors less than 2 times the specified rejection pixels. This is in case good TPs are deleted initially due to other large TP errors.
MODE=5 represents the RMS error of points to reject. Rejection starts from the point with the largest residual error for any point, then recomputes the math model and RMS error. If the RMS error is still above the specified thresholds, the point with the next highest residual is removed and so on, until the x-RMS and y-RMS errors are equal to or less than PARAM1 pixels or PARAM2 pixels.

For example, to apply the RMS Error rejection method (mode 5) and reject points with the highest residuals until the x-RMS and y-RMS values are both less than two pixels, enter 5, 2, 2.
MODE=6 represents automatic RMS-error rejection. In this mode, the TPs are refined in two stages:
1. Typically, with a smaller project, an initial iteration number of 3 is sufficient. With a larger project, an initial iteration number of 1 is typically suitable; however, a smaller number may reduce processing time. With the initial iterations, the objective is to remove points with very large residuals. Points with five standard deviations are removed.
2. With a smaller project, an initial iteration number of 10 is sufficient, and with a larger project, 5. Points with three standard deviations are removed.
MAXPT is the maximum number of TPs to remove in each iteration before recomputing the model. A positive value specifies explicitly the number of TPs that can be removed. A value of 0 removes the number of TPs relative to the number of images in the project. With a negative value, its absolute value specifies the percentage of TPs that can be removed. Regardless of the value you specify, at least one point per iteration is always allowed to be removed.

Note: MAXPT is for use only with modes 1 through 5.
MINPT is the minimum number of points per image to preserve. That is, this ensures that on completion of processing each image has at least the minimum number of TPs remaining that you specify.

You can specify MINPT as an optional second value with mode 6.
REMOVE_BLUNDER specifies whether to use use RANSAC or initial model to remove large blunders before refinement. 0: NO, 1: RANSAC, >1: INITIAL_MODEL. If REMOVE_BLUNDER is INITIAL_MODEL, it should be a blunder threshold in which large blunders are to be removed using initial model.

Default values are 5.0, 2.0 ,2.0, 0.0, 0.0 ,1. [RMS-error rejection].

OEPROJO

The name of the output OrthoEngine project file that contains the refined TPs.

If no value is specified for this parameter, the changes are written to the input project file.

POINTOPT

Whether to delete (DEL) rejected points or render them inactive (INACT). By default, points are rendered inactive.

IMSTAT

On completion of processing, TPREFN updates IMSTAT with information that may be useful in a scripting environment, as follows:

first IMSTAT array element: original total number of points.
second IMSTAT array element: number of deleted or deactivated points.
third IMSTAT array element: total number of retained points.
fourth IMSTAT array element: original x-RMS error of accepted TPs.
fifth IMSTAT array element: original y-RMS error of accepted TPs.
sixth IMSTAT array element: new x-RMS error of accepted TPs.
seventh IMSTAT array element: new y-RMS error of accepted TPs.
eighth IMSTAT array element: x-RMS error of rejected TPs.
ninth IMSTAT array element: y-RMS error of rejected TPs.
tenth IMSTAT array element: original total number of TPs.
eleventh IMSTAT array element: total number of retained TPs.

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

TPREFN

Tie point refinement

Description

Parameters

Parameter descriptions

Return Value

Details

Example