Frames table schema

This is a description of the frames table of the frame camera raster type with a list of supported fields. A frame camera refers to a single-perspective imaging camera with an optical lens that can be modeled as a pinhole. The frame camera raster type allows you to manage frame camera imagery in a mosaic dataset.

Frames table

To use frame camera imagery in a mosaic dataset, you must provide detailed camera parameters and frame information that define the mathematical relationship between the image coordinate system, camera coordinate system, and ground coordinate system. Image points in the camera coordinate system are related to corresponding points in the ground coordinate system based on the exterior orientation parameters defined in the frames table and a suitable DEM. The following diagram shows how pixels are transformed between the coordinate systems:

Transformations for frame camera imagery

The frames table contains the camera exterior orientation information that is specific to each frame, such as frame camera image path, perspective x-, y-, and z-coordinates, and omega, phi, and kappa values. The table format can be a geodatabase table, a feature class table, or a .csv file. You can also use the Build Frames and Cameras Tables tool to create the frames table in a guided process.

Frames table fields

The supported frames table fields are listed below. Note that a parameter definition in the frames table takes precedence over any duplicate definitions in the cameras table.

Fields supported in the frames table

Field name Field typeData typeDescription

ObjectID

Required

Numeric

The unique number identifier for each image.

Raster

Required

String

The path to the image file.

CameraID

Required

String

The primary key identifying the camera parameters. This must match the CameraID value from the cameras table for the corresponding camera.

PerspectiveX

Required

Numeric

The x-coordinate of the perspective center in the ground coordinate system. The units are in the coordinate system units.

Geographic coordinate system units are not supported. Specify the PerspectiveX value in projected coordinate system units.

PerspectiveY

Required

Numeric

The y-coordinate of the perspective center in the ground coordinate system. The units are in the coordinate system units.

Geographic coordinate system units are not supported. Specify the PerspectiveY value in projected coordinate system units.

PerspectiveZ

Required

Numeric

The z-coordinate value of the perspective center in the ground coordinate system. The z-coordinate units should be consistent with the x- and y-coordinate units.

The z-coordinates are typically expressed as orthometric heights, which means elevation above sea level. This is appropriate if you'll be inputting a DEM that is also using orthometric heights. If you have z-coordinates that are using ellipsoidal heights, your DEM should also be in ellipsoidal heights.

When z-units are ellipsoidal and the DEM is orthometric, the Geoid flag can be used to enable an approximate correction.

Omega

Required*

Numeric

The rotational angle of the camera's x-axis in degrees. The units are in decimal degrees.

Phi

Required*

Numeric

The rotational angle of the camera's y-axis in degrees. The units are in decimal degrees.

Kappa

Required*

Numeric

The rotational angle of the camera's z-axis in degrees. The units are in decimal degrees.

Matrix

Required*

String

The matrix describing the transformation from image space to map space.

The matrix is specified as nine floating-point values, which are delimited by spaces or semicolons.

Shape

Optional

Geometry

The polygon identifying the region containing valid image data. This polygon becomes the footprint of the corresponding mosaic dataset item.

Name

Optional

String

An alias name to identify the image. If this is left blank, the image file name is used.

Tag

Optional

String

A tag that allows the image to participate in a function template.

GroupName

Optional

String

An optional categorization for images. All images with the same group name participate together in a function template.

SRS

Optional

String

The coordinate system associated with the perspective point as a file path or WKID (EPSG code). For EPSG code, the coordinate system for x,y, and z are separated by a semicolon (;), for example 26918;5773. If not defined, it defaults to the data-specified or mosaic dataset SR. The spatial reference can be defined for each image item in the mosaic dataset as well. If the SRS field is defined in the cameras table and the frames table, the value in the frames table takes precedence.

ImageFiducials

Optional

String

Stores film fiducial image coordinates (as measured for each unique image in the frame table) separated by semicolons.

The image coordinate system has an origin in the upper left corner, and the order of the coordinates is clockwise.

The unit is pixel.

For example: "108 111;5014.0 113;5012.0 5010.0;109 5013.0".

Note: In most instances, the measured fiducial coordinates will be computed automatically in the ortho mapping workspace.

FCS

Optional

Numeric

Values of 1, 2, 3, or 4, where 1 represents X_Right_Y_Up, 2 represents X_Up_Y_Left, 3 represents X _Left_Y_Down, and 4 represents X_Down_Y_Right.

StripName

Optional

String

The identification number of a flight strip.

Note:

Required*—The frames table must have either the Omega, Phi, and Kappa fields or the Matrix field for the data to be added to the mosaic dataset. If both types of EO exist in the table, the transformation matrix value will be used.

Frames table example

A frames table stored as a geodatabase table is shown below, where only a selection of the available fields are being used. Since four frames (images) are used in this example, there are four rows in the table.

Sample frames table

OBJECTIDCAMERAIDRASTERPERSPECTIVEXPERSPECTIVEYPERSPECTIVEZOMEGAPHIKAPPA

1

[0]

//rs/r1.jpg

512435.5404

3974985.555

958.42006

-4.485

-0.545

171.598

2

[0]

//rs/r2.jpg

512234.9366

3974978.869

961.96833

-0.834

-0.785

172.683

3

[0]

//rs/r3.jpg

512016.6162

3974971.704

969.68074

-1.177

0.994

171.427

4

[0]

//rs/r4.jpg

511799.7245

3974972.277

976.05905

-0.996

-1.061

171.542

Related topics