Compute Fiducials (Data Management)—ArcGIS Pro

Summary

Computes the fiducial coordinates in image and film space for each image in a mosaic dataset.

Fiducials are marks, normally four or eight, in aerial photos used as reference. They are an important factor for determining the image transformation from image to film known as interior orientation. This tool is used to automatically find the image coordinates of the fiducials for each images in a mosaic dataset based on a user-provided fiducial template file. A fiducial template file is a table that has required fields for storing either fiducial pictures or paths to the pictures. For more information about fiducials, see Refine Interior Orientation Using Fiducials.

Usage

This tool uses an input fiducial template file to automatically find the image coordinates of every fiducial in every image in a mosaic dataset.
A fiducial template file is a table of fields for storing pictures of fiducials or paths to the pictures.
The film coordinate system, a factor in calculating fiducials, describes the orientation in which the image is scanned. The camera calibration report defines the coordinate system in which the film is exposed from the imaging platform. During scanning, the image might be rotated, so the film coordinate system is used to describe the scanned orientation for computing correct image interior orientation. For example, if the image is acquired in the orientation on the left, and you scanned the image rotated 90 degrees clockwise, the film coordinate system for example will be X_DOWN_Y_RIGHT.
The positions of fiducials in scanned imagery adhere to the following diagram.

The output table created by this tool can be used as an input to the Update Interior Orientation tool.

Output table
Field	Description	Type
CameraID	The camera ID that is linked to the camera definition including fiducial coordinates.	String, required
FiducialPosition	The positions of fiducial marks with values of LL(1), UR(2), UL(3), LR(4), LM(5), RM(6), UM(7), and BM(8). Refer to the diagram above for the fiducial positions.	String, required
FiducialPhoto	Stores the path to the fiducial photo. The fiducial photo can be a stand-alone photo in TIFF, PNG, or JPEG format or a portion within an image, which is defined by the size (width and height) and center location (CenterRow and CenterColumn) in the image. If the image is an item in a mosaic dataset, the path syntax is theMosaicDataPath\objectid=id, where id is the ObjectID value of that image, for example, c:\data\fgdb.gdb\md\objectid=1.	String, required
ScanPixelSize	The pixel size used in the fiducial photo, which is typically the scan pixel size. The unit is microns.	Numeric
Width	The width of the fiducial template in pixel units. This is needed only when the fiducial template is defined by a portion of the image. The value is in image space, and the origin is upper left corner.	Numeric, optional
Height	The height of the fiducial template in pixel units. This is needed only when the fiducial template is defined by a portion of the image. The value is in image space, and the origin is upper left corner.	Numeric, optional
CenterRow	The row of the center of the fiducial template in the entire image. This is needed only when the fiducial template is defined by a portion of the entire image.	Numeric, optional
CenterColumn	The column of the center of the fiducial template in the entire image. This is needed only when the fiducial template is defined by a portion of the entire image.	Numeric, optional
IsSymmetry	A Boolean that indicates whether a template is symmetric.	Numeric, optional

Parameters

Label	Explanation	Data Type
Mosaic Dataset	The mosaic dataset created from scanned aerial photos using scanned raster type or frame camera raster type.	Mosaic Layer
Output Fiducial Table	The output table that stores all the fiducial coordinate information in image and film space.	Table
Query Definition (Optional)	A query definition string that defines a subset of rasters for computing fiducials.	SQL Expression
Fiducial Templates (Optional)	The fiducial template table that contains required fields for storing fiducial pictures and other properties.	Table View; File; String
Film Coordinate System (Optional)	A keyword that defines the film coordinate system of the scanned aerial photograph. It is used in computing fiducial information and affine transformation construction. No change—Maintain the coordinate system of the mosaic dataset. Do not change the film coordinate system of the scanned aerial photograph. Maintain the coordinate system of the mosaic dataset. X right, Y up—The origin of the scanned photo's coordinate system is the center, and positive X points right and positive Y points up. X up, Y left—The origin of the scanned photo's coordinate system is the center, and positive X points up and positive Y points left. X left, Y down—The origin of the scanned photo's coordinate system is the center, and positive X points left and positive Y points down. X down, Y right—The origin of the scanned photo's coordinate system is the center, and positive X points down and positive Y points right.	String

arcpy.management.ComputeFiducials(in_mosaic_dataset, out_fiducial_table, {where_clause}, {fiducial_templates}, {film_coordinate_system})

Name	Explanation	Data Type
in_mosaic_dataset	The mosaic dataset created from scanned aerial photos using scanned raster type or frame camera raster type.	Mosaic Layer
out_fiducial_table	The output table that stores all the fiducial coordinate information in image and film space.	Table
where_clause (Optional)	A query definition string that defines a subset of rasters for computing fiducials.	SQL Expression
fiducial_templates (Optional)	The fiducial template table that contains required fields for storing fiducial pictures and other properties.	Table View; File; String
film_coordinate_system (Optional)	A keyword that defines the film coordinate system of the scanned aerial photograph. It is used in computing fiducial information and affine transformation construction. NO_CHANGE—Maintain the coordinate system of the mosaic dataset. Do not change the film coordinate system of the scanned aerial photograph. Maintain the coordinate system of the mosaic dataset. X_RIGHT_Y_UP—The origin of the scanned photo's coordinate system is the center, and positive X points right and positive Y points up. X_UP_Y_LEFT—The origin of the scanned photo's coordinate system is the center, and positive X points up and positive Y points left. X_LEFT_Y_DOWN—The origin of the scanned photo's coordinate system is the center, and positive X points left and positive Y points down. X_DOWN_Y_RIGHT—The origin of the scanned photo's coordinate system is the center, and positive X points down and positive Y points right.	String

Code sample

ComputeFiducials example 1 (Python window)

This is a Python sample for the ComputeFiducials tool.

arcpy.ComputeFiducials_management(r"c:\test\orthomapping.gdb\orthomosaicdataset",
                       r"c:\test\orthomapping.gdb\out_table", "objectID = 1",
                       r"c:\test\fiducilatemplate.csv", "X_RIGHT_Y_UP")

ComputeFiducials example 2 (stand-alone script)

This is a stand-alone script sample for the ComputeFiducials tool.

import arcpy

in_mosaic_dataset = "c:\\test\\ortho.gdb\\ortho_md"
out_fiducial_table = "c:\\test\\ortho.gdb\\fiducial_table"
where_clause = ""
fiducial_template = "c:\\test\\fiducilatemplate.csv"
film_coordinate_system = "NO_CHANGE"


arcpy.ComputeFiducials_management(in_mosaic_dataset, out_fiducial_table,
where_clause,fiducial_template, film_coordinate_system)

Environments

Current Workspace, Parallel Processing Factor, Scratch Workspace

Licensing information

Basic: No
Standard: Requires ArcGIS Reality for ArcGIS Pro
Advanced: Yes