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, a raster catalog, 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 type	Data type	Description	Domain
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

OBJECTID	CAMERAID	FOCALLENGTH	PRINCIPALX	PRINCIPALY	A0	A1	A2	B0	B1	B2	SRS
1	[0]	55173.140478	-476.641812	-14.823294	-18529.301232	6.598754	0	12352.867488	0	-6.598754	3261