Skip To Content

Cameras table schema

This topic documents the well known and recognized fields in the cameras table of the frame camera raster type. This table enables specification of general camera parameters, including those that control interior orientation (IO). For more details about the Esri frame camera raster type, and frame and camera schemas, please refer to the description document.

The cameras table can be stored in several formats: a geodatabase table, a feature class table, or a *.csv file. The possible fields within the cameras table is shown below. There is a sample cameras table at the end of this topic.

Note:

A camera parameter definition duplicated in the frames table takes precedence over the definition in the cameras table.

List of fields supported in the cameras table

Field name Field typeData typeDescriptionDomain

CameraID

Required

String

The primary key identifying the camera parameters.

FocalLength

Required

Numeric

The focal length of the camera lense, measured in microns.

PrincipalX

Required

Numeric

The x-coordinate of the principal point of the autocollimation, measured in microns.

PrincipalY

Required

Numeric

The y-coordinate of the principal point of the autocollimation, measured in microns.

A0

Required

Numeric

Coefficient of the affine transformation that establishes a relationship between image-space and film-space. The direction of this transformation is indicated using the AffineDirection field. If that field does not exist, the default is image-space to film-space. The units for this are microns.

A0 represents the translation in x direction.

A1

Required

Numeric

Coefficient of the affine transformation that establishes a relationship between image-space and film-space. The direction of this transformation is indicated using the AffineDirection field. If the field does not exist, the default is image-space to film-space. The units for this are microns.

A1 represents the change of scale in x direction.

A1 = mx * cos t
, where mx is the change of scale in x direction, and t is the rotation angle, measured counterclockwise from the x-axis.

A2

Required

Numeric

Coefficient of the affine transformation that establishes a relationship between image-space and film-space. The direction of this transformation is indicated using the AffineDirection field. If the field does not exist, the default is image-space to film-space. The units for this are microns.

A2 represents the skewing of the x direction.

A2 = my * (k * cos t –  sin t)
, where k is the shear factor along the x-axis is equal to tangent of the skew angle. The skew angle is measured from the y-axis.

B0

Required

Numeric

Coefficient of the affine transformation that establishes a relationship between image-space and film-space. The direction of this transformation is indicated using the AffineDirection field. If the field does not exist, the default is image-space to film-space. The units for this are microns.

B0 represents the translation in y direction.

B1

Required

Numeric

Coefficient of the affine transformation that establishes a relationship between image-space and film-space. The direction of this transformation is indicated using the AffineDirection field. If the field does not exist, the default is image-space to film-space. The units for this are microns.

B1 represents the change of scale in y direction.

B1 = my * cos t
, where my is the change of scale in y direction, and t is the rotation angle, measured counterclockwise from the x-axis.

B2

Required

Numeric

Coefficient of the affine transformation that establishes a relationship between image-space and film-space. The direction of this transformation is indicated using the AffineDirection field. If the field does not exist, the default is image-space to film-space. The units for this are microns.

B2 represents the skewing of the x direction.

B2 = my * (k * sin t + cos t)
, where k is the shear factor along the x-axis is equal to tangent of the skew angle. The skew angle is measured from the y-axis.

BlockName

Optional

String

The name of the block (project) where the image belongs.

NRows

Optional

Numeric

The number of rows of pixels in the image.

NColumns

Optional

Numeric

The number of columns of pixels in the image.

NBands

Optional

Numeric

The number of bands of pixels in the image.

PixelType

Optional

Numeric or String

The pixel type for the image, either as a numeric value matching an rstPixelType or a matching string.

Numeric value matching an rstPixelType: PT_U1=0, PT_U2=1, PT_U4=2, PT_UCHAR=3, PT_CHAR=4, PT_USHORT=5, PT_SHORT=6, PT_ULONG=7, PT_LONG=8, PT_FLOAT=9, PT_DOUBLE=10, PT_COMPLEX=11, PT_DCOMPLEX=12, PT_CSHORT=12, PT_CLONG=14.

Matching string: 8_BIT_UNSIGNED, 8_BIT_SIGNED, 16_BIT_UNSIGNED, 16_BIT_SIGNED, 32_BIT_UNSIGNED, 32_BIT_SIGNED, 32_BIT_FLOAT, 1_BIT, 2_BIT, 4_BIT, 64_BIT.

SRS

Optional

String

The coordinate system associated with the perspective point as WKT-PRJ, string, file path, or EPSG code. The default is the user-specified coordinate system or the one defined in the mosaic data spatial reference.

AffineDirection

Optional

String

Specifies the direction in which the IO affine transformation is indicated. If unspecified, a default direction of image-to-film (+1) is assumed.

+1: image-to-film

-1: film-to-image

OrientationType

Optional

String

Specifies how the rotational Exterior Orientation (EO) parameters are described. The default is OPK.

OPK—Indicates the rotational EO parameters are defined as angles in the Omega, Phi, Kappa, Angle Direction, and Polarity fields.

RPY—Indicates the rotational EO parameters are defined as angles in the Roll, Pitch, Yaw, Angle Direction, and Polarity fields.

Matrix—Indicates the rotational EO parameters are defined as a matrix of nine coefficients in the Matrix field.

AverageZ

Optional

Numeric

The average ground height. The default is the value specified in the raster type's orthorectification properties, or zero if that is unspecified.

ApplyECC

Optional

Boolean

Indicates whether to account for Earth curvature when applying transformations with respect to ground coordinates. The default is FALSE.

True—Accounts for the Earth curvature when applying the transformations with respect to ground coordinates

False—Assumes the Earth is flat.

EarthRadius

Optional

Numeric

An alternative value to use in the Earth curvature adjustment. The default value is 6378137.0.

AngleDirection

Optional

String

Specifies the direction the EO angles. The default value is -1.

-1: Indicates the EO angles are specified in the clockwise direction

+1: Indicates the EO angles are specified in the counterclockwise direction

Polarity

Optional

Numeric

Indicates whether the image-plane is presumed to be on the same or the opposite side of the perspective center as the object or ground-plane. The default is-1, which is the opposite side.

-1: Indicates the opposite side of the image-plane.

+1: Indicates the same side of the image-plane.

DistortionType

Optional

String

Specifies how the lens distortion is described. The default is Esri-Konrady.

Esri-Konrady—Indicates the second and fourth powers of the radial distances are applied on the Konrady coefficients towards deriving the final correction for radial distortion. Also indicates the lens distortion is defined using five coefficients in the Konrady field.

USGS-Konrady—Indicates the third and fifth powers of the radial distances are applied on the Konrady coefficients towards deriving the final correction.

Radial—Indicates the distortion is defined as a set of (r, v) pairs indicating radial distance and corresponding distortion value.

Konrady

Optional

String

Specifies the set of Konrady coefficients describing the radial distortion. The five coefficients can be space or colon delimited.

RadialDistances

Optional

String

The radial distances indicating an ordered set of values <r[i]> of length N, where the distance is in microns and the set of values can be space or semicolon delimited. Each r[i] distance value has a corresponding d[i].

RadialDistortions

Optional

String

The distortion values indicating an ordered set of values <d[i]> of length N, where the values are in microns and are either space or semicolon delimited.

Example cameras table schema

Below is a sample cameras table stored as a geodatabase table. This table references the possible fields above. The sample contains only one row, since only one camera was used.

Sample cameras table

OBJECTIDCAMERAIDFOCALLENGTHPRINCIPALXPRINCIPALYA0A1A2B0B1B2SRS

1

[0]

55173.140478

-476.641812

-14.823294

-18529.301232

6.598754

0

12352.867488

0

-6.598754

3261

Related topics