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).

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.

#### 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. , 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. , 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 | B1 represents the change of scale in y direction. , 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 | B2 represents the skewing of the x direction. , 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 |