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 the ones that control interior orientation (IO).
The cameras table can be stored in several formats: a geodatabase table, feature class table, raster catalog, or as a *.csv file. The possible fields within the cameras table is shown below. There is a sample cameras table at the bottom of this topic.
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 is in 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 is in microns. A1 represents the change of scale in x direction. | |
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 is in microns. A2 represents the skewing of the x direction. | |
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 is in 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 is in microns. B1 represents the change of scale in y direction. | |
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 is in microns. B2 represents the skewing of the x direction. | |
BlockName | Optional | String | The name of the block (project) that the image belongs in. | |
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 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—Account 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 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 that the third and fifth powers of the radial distances are applied on the Konrady coefficients towards deriving the final correction. | ||||
Radial—Indicates that 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 camera 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 |