EOIMPORT

Description

With EOIMPORT , you can import your exterior-orientation (EO) data from a text file into a CATALYST Professional OrthoEngine project file.

Parameters

Name	Type	Length	Value range
Input: OrthoEngine project file  *	Text port	1 -
Output: OrthoEngine project file	Text port	0 -
Exterior-orientation file *	String	1 -
Data format *	Integer	1 - 1
Map projection	String	0 - 1	Pixel, UTM, Meter, SPCS, Long/Lat, Meter, Foot
Exterior-orientation vertical datum	String	3 -	ELLIPS | MSL Default: MSL
Angle units	String	0 - 1	Degrees, Radians, Grads, DMS Default: Degrees
Positional-error estimate	Float	0 - 3
Orientation-error estimate	Float	0 - 3
Rotate kappa	Float	0 - 1
Flight-line-break angle	Float	0 - 1	Default: 22.5
OPK-warning threshold	Float	0 - 1	Default: 5
Report	String	0 - 192	See parameter description

* Required parameter

Parameter descriptions

Input: OrthoEngine project file

The name of the OrthoEngine project containing valid image information to which to add the EO data.

Output: OrthoEngine project file

The OrthoEngine project file to create with the imported EO data.

Exterior-orientation file

The name of the input text file that contains the OrthoEngine data to import. The file must exist and should contain valid EO data.

Data format

The format of the data in the input text file, where ImageID is the base file name of the image without the path, it may contain the file name extension.

Map projection

The projection or units of the output. If no value is specified for this parameter, the projection in the math-model segment of your project will be used.

The standard definitions are:

• Pixel: pixel and line
• UTM: Universal Transverse Mercator
• SPCS: State Plane Coordinate System
• Long/Lat: longitude and latitude
• Meter: image along-row and along-column meters
• Foot: image along-row and along-column feet

For a complete list of supported projections and Earth models, see Understanding map projections . For information on the format of the map units string, see Output units .

Exterior-orientation vertical datum

The flying height (vertical datum) of the airphoto camera when the imagery was acquired.

If the vertical datum of the digital elevation model (DEM) and the height of the flying camera differ, the EGM2008 geoid model will be used for the conversions during orthorectification.

Angle units

With commercial EO formats, this option is ignored.

Positional-error estimate

If not specified in the input text file, you can specify the positional-error estimate with this parameter. The parameter uses the projection specified for the Map projection ( MAPUNITS ) parameter. With longitude and latitude values, the projection assumes the error estimate is expressed in meters.

The default is 0,0,0 , which is equivalent to fixing the position.

Orientation-error estimate

If not specified in the text file, you can specify the orientation-error estimate with this parameter. The expression of the estimate is in degrees.

The default is 0,0,0 , which is equivalent to fixing the orientation.

Rotate kappa

The angle of rotation to add to the input kappa values in the units specified by the Angle units ( ANGUNITS ) parameter. In some cases, you must rotate the kappa values in the EO file; for example, by 90, -90 or 180 degrees. You apply the correction by specifying the angle of rotation.

This parameter is optional.

Flight-line-break angle

The break angle of a flight line, which is used to determine the end of the flight line. The vector angles between image centers are calculated, and if the vector angle between two image centers is greater than the break-angle threshold, this is determined to be the end of the flight line, and the point at which a new one begins.

The default value is 22.5 (22.5 degrees).

This parameter is optional.

OPK-warning threshold

The threshold that determines when to indicate a warning on the OPKDiff value within a flight line. The OPKDiff value is the maximum difference in degrees among the values of the omega, phi, and kappa angles in the flight line. The default value for the threshold is 5 (5 degrees). The default may not be suitable for all applications. That is, you may need to change it according to the application: Standard AirBorne or UAV.

Report

Specifies where to direct the generated report.

Available options are:

• LOG: generates a report on the terminal (default)
• <modulename.RPT>: appends a report to the module's RPT file
• DISK: generates a report on file "IMPRPT.LST"

Details

Based on the input values, EOIMPORT imports EO data from a text file into an OrthoEngine project. If the output project file is not specified, the modified project is written to the input project file.

In most cases, the EO data in the text file is mean sea level (MSL), but the EO can also be in ellipsoid height.

If the EO data is calculated from ground control points (GCP), the elevation of the GCPs and the DEM must have the same vertical datum during orthorectification.

If you specify your own EO data, the altitude value (z) of the EO and the DEM must have the same vertical datum.

EOIMPORT separates the images into individual flight lines, and creates a summary report. For each flight line, the report includes the following:

• Line: Flight-line number, starting from 1.
• #Images: Number of images in the flight line.
• Angle: The median value of the change of flight-line direction at an image; that is, the angle in degrees between the lines from the previous image to the current image, and from the current image to the next.
• OPKDiff: The maximum difference in degrees among values of the omega, phi, and kappa angles in the flight line.
• Index: The image number in the flight line, starting from 1, of the image for which the maximum OPK difference with its immediate successor was found.
• Start Image: The ID of the first image in the flight line.
• End Image: The ID of the last image in the flight line.