SELFCAL

Description

SELFCAL refines tie points (TP) and ground control points (GCP) in a CATALYST Professional OrthoEngine project file.

Parameters

Name	Type	Caption	Length	Value range
OEPROJI*	String	Input OrthoEngine project file	1 - 192
OEPROJO*	String	Output OrthoEngine project file	1 - 192
FOCALMM	Float	Focal length (mm)	0 - 1	0.1 - 500
CHIPMM	Float	Chip Size in (mm)	0 - 2	0.1 - 100
GCPRES	Float	Maximum GCP residual	0 - 1	0.1 - 1000
TPRES	Float	Maximum TP residual	0 - 1	0.1 - 1000
POINTOPT*	String	Options for rejected points	3 - 192	INACT \| DEL Default: INACT
MINTP	Integer	Minimum number of TPs	0 - 1
SAMPLE	Integer	Sample Count	0 - 1
SAMPLETP	Integer	Sample Count TP	0 - 1
CALOPT	String	Options for rejected points	0 - 192
IMSTAT	Float	Output SELFCAL statistics	0 - 48
REPORT	String	Report mode	0 - 192	Quick links

* Required parameter

Parameter descriptions

OEPROJI

The path and file name of the OrthoEngine project file (*.prj) containing the points you want to refine.

OEPROJO

The path and file name of the output OrthoEngine project file to which to write the refined TPs, GCPs, or both.

You can specify your input project as your output project; however, by doings so, the input file will be overwritten with the new information.

FOCALMM

Option to specify focal length. If focal length is not specified, the program will try to extract it from the image's EXIF tag.

CHIPMM

Option to specify sensor chip width and height in mm If the values are not specified, the program will try to extract it from the image's EXIF tag.

GCPRES

The maximum residual for x and y per GCP.

For example, to refine the OrthoEngine project until all GCPs have a residual of two or less in both the x and y direction, enter 2.

TPRES

The maximum residual for x and y per TP.

For example, to refine the OrthoEngine project until all TPs have a residual of two or less in both the x and y direction, enter 2.

POINTOPT

The disposition of the rejected points.

That is, on completion of refinement, you can elect to either render the rejected points inactive (INACT) or delete (DEL) them.

MINTP

The minimum number of TPs per image.

Images with fewer than the minimum number of TPs before and after refinement will be rendered inactive.

SAMPLE

Optionally to specify the number of photos used for camera self-calibration. A minimum value of 100 is recommended.

SAMPLETP

Optionally to specify the maximum number of TPs must exist in SAMPLE photos. If it does not meet the requirement, SELFCAL would call TIEIMAGE to generate TPs based on SAMPLETP to achieve the target.

CALOPT

Self-calibration options.

IMSTAT

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

first IMSTAT array element: Original number of GCPs.
second IMSTAT array element: Original number of TPs.
third IMSTAT array element: Initial TP x-RMS.
fourth IMSTAT array element: Initial TP y-RMS.
fifth IMSTAT array element: Initial maximum TP x-residual.
sixth IMSTAT array element: Initial maximum TP y-residual.
seventh IMSTAT array element: Refined TP x-RMS.
eighth IMSTAT array element: Refined TP y-RMS.
ninth IMSTAT array element: Refined maximum TP x- residual.
tenth IMSTAT array element: Refined maximum TP y-residual.
eleventh IMSTAT array element: Initial GCP x-RMS.
twelfth IMSTAT array element: Initial GCP y-RMS.
thirteenth IMSTAT array element: Initial maximum GCP x-residual.
fourteenth IMSTAT array element: Initial maximum GCP y-residual.
fifteenth IMSTAT array element: Refined GCP x-RMS.
sixteenth IMSTAT array element: Refined GCP y-RMS.
seventeenth IMSTAT array element: Refined maximum GCP x-residual.
eighteenth IMSTAT array element: Refined maximum GCP y-residual.

REPORT

Specifies where to direct the generated report.

Available options are:

TERM: generates a report on the terminal (default)
DISK: generates a report on file "IMPRPT.LST"
OFF: turns off report generation
<filename>: appends a report to the specified file

Details

SELFCAL refines TPs and GCPs in an OrthoEngine project file.

The algorithm removes points in either a progressive or direct mode according to the specified residual. In progressive mode, large residuals are removed in the following steps:

Remove residuals greater than 1,000 pixels
Remove residuals greater than 500 pixels
Remove residuals greater than 100 pixels
Remove residuals greater than 20 pixels
Remove residuals greater than 10 pixels
Remove residuals according to the specified residual

In direct mode, the specified residual is applied exclusively.

Processing is complete when the specified residual is reached.

Example

In the following example, TPs and GCPs are designated inactive until the x and y residual for each meets the specified GCP and TP residual.


EASI>OEPROJI =       "uav.prj"
EASI>OEPROJO =       "uav_out.prj"
EASI>FOCALMM =       ! option to specify focal length in mm if it cannot be extracted from EXIF tag 
EASI>CHIPMM =        ! option to specify X and Y chip size in mm if it cannot be extracted from EXIF tag 
EASI>GCPRES  =       ! option to refine until remaining GCPs have an x-residual and a y-residual under GCPRES
EASI>TPRES   =       2  ! Refine until remaining TPs have an x-residual and a y-residual under 2
EASI>POINTOPT =      "INACT"        ! Designate refined points inactive
EASI>MINTP   =       10 ! Designate images with fewer than 10 TPs inactive
EASI>SAMPLE  =       ! Option to use only SAMPLE number of images for self-calibration to speed up processing
EASI>SAMPLETP  =     ! Option to set the minimum number of TPs for each SAMPLE image 
EASI>CALOPT  =       ! Selfcal option 
EASI>IMSTAT  =       ! Selfcal results 

EASI>R SELFCAL

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