Camera orientation

In the oriented imagery dataset attribute table, the CameraOrientation field is used to support precise image-to-ground and ground-to-image transformations using metadata such as camera focal length, lens distortion parameters, and so on. If the camera orientation string is provided, these values will be used in place of corresponding field values in the attribute table.

To include a CameraOrientation field in your oriented imagery dataset, use an oriented imagery table with a CameraOrientation field as input to the Add Images to Oriented Imagery Dataset geoprocessing tool.

The camera orientation parameter is a string that stores pipe (|) separated values. Oriented imagery supports four types of camera orientation strings. The first number in the string defines the type of camera orientation.

The camera orientation schema for each type is described below.

Type 1: Heading, pitch, roll

Camera heading, camera pitch and camera roll are used as the rotation angles.

Schema

1|H_WKID|V_WKID|X|Y|Z|RA1|RA2|RA3 OR

1|H_WKID|V_WKID|X|Y|Z|RA1|RA2|RA3|A0|A1|A2|B0|B1|B2|FL|PPX|PPY|K1|K2|K3|P1|P2

Parameters

The following describe the parameters.

Coordinate system information

  • H_WKID: The WKID value for the horizontal coordinate system.
  • V_WKID: The WKID value for the vertical coordinate system.

Perspective point

  • X: The x-coordinate of the camera location. The units are in the coordinate system units defined in H_WKID.
  • Y: The y-coordinate of the camera location. The units are in the coordinate system units defined in H_WKID.
  • Z: The z-coordinate of the camera location. The units are in the coordinate system units defined in V_WKID.

Rotation angles

  • RA1: Camera heading in degrees
  • RA2: Camera pitch in degrees
  • RA3: Camera roll in degrees

Affine transformation parameters

The coefficient of affine transformation that establish the relationship between film space and image space.

  • A0,A1,A2: Represents the translation in x direction.
  • B0,B1,B2: Represents the translation in y direction.

A0 and B0 are offset in columns and rows.

Camera parameters

  • FL: Focal length of the lens
  • PPX: Principal point offset in X from camera center
  • PPY: Principal point offset in Y from camera center
  • K1, K2, K3: Radial distortion coefficients
  • P1,P2: Tangential distortion coefficients

Note:

Affine transformation parameters, FL, PPX, and PPY must have the same units. Units can be in microns, pixels, or millimeters.

Type 2: Omega, phi, kappa

Omega, phi, and kappa are used as rotation angles.

Schema

2|H_WKID|V_WKID|X|Y|Z|RA1|RA2|RA3 OR

2|H_WKID|V_WKID|X|Y|Z|RA1|RA2|RA3|A0|A1|A2|B0|B1|B2|FL|PPX|PPY|K1|K2|K3|P1|P2

Parameters

The parameters are the same as defined in the Type 1 schema except for the rotation angles.

Rotation angles

  • RA1: Omega in degrees
  • RA2: Phi in degrees
  • RA3: Kappa in degrees

All the angle rotations are measured in positive counterclockwise direction and the sequence must be omega first, then phi, and then kappa.

Type 3: Yaw, pitch, roll

Yaw, pitch, and roll are used as rotation angles. Type 3 is only supported for 360-degree images.

Note:

The oriented imagery viewer does not support 360-degree imagery in ArcGIS Pro 3.2 or Map Viewer.

Schema

3|H_WKID|V_WKID|X|Y|Z|RA1|RA2|RA3

Parameters

The parameters are the same as defined in the Type 1 schema except for the rotation angles.

Rotation angles

  • RA1: Yaw in degrees
  • RA2: Pitch in degrees
  • RA3: Roll in degrees

Type 4: Local tangent plane

Local Tangent Plane (LTP) with East North Up (ENU) Cartesian coordinate system is used to represent the camera point.

Schema

4|LTP_Lat|LTP_Lon|Ellipsoid_Rad|Ellipsoid_EE|RA_Type|V_WKID|LTPX|LTPY|LTPZ|RA1|RA2|RA3 OR

4|LTP_Lat|LTP_Lon|Ellipsoid_Rad|Ellipsoid_EE|RA_Type|V_WKID|LTPX|LTPY|LTPZ|RA1|RA2|RA3|A0|A1|A2|B0|B1|B2|FL|PPX|PPY|K1|K2|K3|P1|P2

Parameters

The following describe the parameters.

LTP information

  • LTP_Lat: Latitude in degrees of the LTP coordinate system origin
  • LTP_Lon: Longitude in degrees of the LTP coordinate system origin
  • Ellipsoid_Rad: Earth's equatorial
  • Ellipsoid_EE: Eccentricity squared
  • V_WKID: The WKID of the vertical coordinate system

Rotation angle type

  • RA_Type: The number specifies the type of rotation angles used
    • 1— RA1, RA2, and RA3 will have camera heading, pitch, and roll values respectively.
    • 2— RA1, RA2, and RA3 will have omega, phi, and kappa values respectively.
    • 3— RA1, RA2, and RA3 will have yaw, pitch, and roll values respectively.

Affine transformation parameters and camera parameters are not supported if RA_Type is 3.

Perspective point

  • LTPX: The x-coordinate of the camera center in LTP space
  • LTPY: The y-coordinate of the camera center in LTP space
  • LTPZ: The z-coordinate of the camera center in LTP space

All other parameters follow the same definition as described in the Type 1 schema.