TPREFN

Tie point refinement


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

Back to top

Description


TPREFN automatically refines tie points (TP) in a CATALYST Professional OrthoEngine project file by eliminating those with large residual errors, based on various modeling methods.
Back to top

Parameters


Name Type Caption Length Value range
OEPROJI * String Input OrthoEngine Project 1 - 192  
REJECT Float Rejection method 0 - 6 See parameter description
OEPROJO String Output OrthoEngine Project 0 - 192  
POINTOPT * String Input OrthoEngine point option 3 - 192 INACT | DEL
Default: INACT
IMSTAT Float Output TPREFN statistics 0 - 48  
REPORT String Report mode 0 - 192 Quick links

* Required parameter
Back to top

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>
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:

REPORT

Specifies where to direct the generated report.

Available options are:

Back to top

Details

TPREFN eliminates TPs that have the highest residuals, based on the calculation of the math model for an image. You can run the algorithm on any OrthoEngine project file that contains TPs. Details, such as orbit information or RPCs, are read from the project file. TPREFN uses the math model derived from the supplied project to compute the residuals of existing TPs.

TPs that are deemed undesirable can be rejected by using various rejection methods. For more information see the REJECT .

TPREFN saves an updated project file with a refined set of tie points and with updated math-model parameters.

Note: Any inactive points in the specified OrthoEngine project are copied to the output project file.
Note: If the specified OrthoEngine project includes any inactive images, they are excluded from processing.
Important: The system DEM file gmted2010 must be installed as part of the CATALYST Professional distribution. This file is used to compute approximate ground coordinates of the TPs.
Back to top

Example

Eliminate TPs that have suspect residuals in airphoto_model.prj.

EASI>OEPROJI	=	"airphoto_model.prj"
EASI>REJECT	=	1, 5, 5
EAS>OEPROJO	=	"a.prj"

EASI>R TPREFN

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