EOIMPORT

Description

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

Parameters

eoimport (oeproji, tfile, eoformat, mapunits, eovdatum, angunits, xyzerr, opkerr, rotkappa, oeprojo, breakang, opkthr)

Name	Type	Caption	Length	Value range
OEPROJI *	str	OrthoEngine project file	1 -
TFILE *	str	Name of input text file	1 -
EOFORMAT *	List[int]	Format of EO data	1 - 1
MAPUNITS	str	Map units	0 - 16	Pixel, UTM, Meter, SPCS, Long/Lat, Meter, Foot
EOVDATUM *	str	EO vertical datum	3 -	ELLIPS \| MSL Default: MSL
ANGUNITS	str	Input angle units	0 - 8	Degrees, Radians, Grads, DMS Default: Degrees
XYZERR	List[float]	Estimate of positional error	0 - 3
OPKERR	List[float]	Estimate of orientation error	0 - 3
ROTKAPPA	List[float]	Rotate kappa	0 - 1
OEPROJO	str	Output OrthoEngine Project File	0 -
BREAKANG	List[float]	Flight-line-break angle	0 - 1	Default: 22.5
OPKTHR	List[float]	Threshold of OPK warning	0 - 1	Default: 5

* Required parameter

Parameter descriptions

OEPROJI

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

TFILE

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

EOFORMAT

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.

To specify a value for this parameter, enter the integer that corresponds to the string in the following list. For example, to specify ImageID omega phi kappa , enter 2 .

The available options are:

1 - ImageID X Y Z
2 - ImageID omega phi kappa
3 - ImageID X Y Z omega phi kappa
4 - ImageID X Y Z eX eY eZ
5 - ImageID omega phi kappa eO eP eK
6 - ImageID X Y Z omega phi kappa eX eY eZ eO eP eK
7 - ImageID / X Y Z omega phi kappa / eX eY eZ eO eP eK (3 lines)
8 - USGS GIANT bundle adjustment (lat/long)
9 - USGS GIANT bundle adjustment (non-lat/long)
10 - OEGPS-ERIO_Albany: ERIO Technologies Albany file
11 - JFK RABATS/BRATS file
12 - PATB
13 - BINGO
14 - ImageID X Y Z phi omega kappa
15 - ImageID GPSTime X Y Z omega phi kappa eO eP eK
16 - ImageID X Y Z (compute kappa)
17 - ImageID Y X Z (compute kappa)
18 - ImageID X Y Z roll pitch yaw
19 - ImageID Y X Z roll pitch yaw
20 - ImageID X Y Z yaw pitch roll
21 - ImageID Y X Z yaw pitch roll

MAPUNITS

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 .

EOVDATUM

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

Supported values are:

MSL: mean sea level (default)
ELLIPS: ellipsoid

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.

ANGUNITS

The input angle units. The following options are available:

Degrees
Radians
Grads
DMS

The default is Degrees .

With commercial EO formats, this option is ignored.

XYZERR

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.

OPKERR

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.

ROTKAPPA

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.

OEPROJO

The name of the output OrthoEngine project file that to which to write the imported EO data. If no value is specified for this parameter, the imported EO data is written to the input project file.

BREAKANG

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.

OPKTHR

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.

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

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.

Note: All images in the specified OrthoEngine project file are processed, regardless of whether they are active or inactive.

Example

The EO data in the input text file named EOExport.txt in data format 2 (ImageID Omega Phi Kappa) is imported into the OrthoEngine project file named airphoto_model.prj , which is written to the output project file named airphoto_EO.prj .

The following is an example of EOExport.txt.

ID                Easting      Northing      Height     Omega      Phi      Kappa
Hi-RGB_00001    -72443.361    223412.968    1452.537    0.295     0.039     0.138
Hi-RGB_00002    -72308.791    223418.477    1452.762    0.2705    0.0215    0.3309
Hi-RGB_00003    -72181.651    223424.643    1453.092    0.3056    0.0496    0.1133
Hi-RGB_00004    -72061.177    223431.109    1453.187    0.3001    0.0349   -0.0845
Hi-RGB_00005    -71940.513    223436.98     1453.39     0.3099    0.0133    0.0786
Hi-RGB_00006    -71820.072    223442.094    1453.703    0.3181    0.0265    0.0046
Hi-RGB_00007    -71707.167    223445.903    1454.265    0.2603    0.0091    0.1159
Hi-RGB_00008    -71590.944    223448.884    1455.048    0.2895    0.0624   -0.0741

from pci.eoimport import eoimport

oeproji  = 'airphoto_model.prj' # input OrthoEngine project file
tfile    = 'EOExport.txt'       # input text file
eoformat = [2]                  # input data format is 2
mapunits = 'UTM 11 E000'        # projection will be same as that of
                                # the input project
eovdatum = "MSL"
angunits = 'DEG'                # use degrees for input angle units
xyzerr   = [0,0,0]              # x,y,z error values  are all zeros.
opkerr   = [0,0,0]              # o,p,k error values are all zeros.
oeprojo  = 'airphoto_EO.prj'    # output project file
rotkappa = [90]
breakang = [30.0]
opkthr   = [5.0]

eoimport(oeproji, tfile, eoformat, mapunits, eovdatum, angunits, xyzerr, \
         opkerr, rotkappa, oeprojo, breakang, opkthr)

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