Update Interior Orientation (Data Management)

Summary

Refines the interior orientation for each image in the mosaic dataset by constructing an affine transformation from a fiducial table.

Usage

  • The input fiducial table is the output from the Compute Fiducials tool.

  • This tool can be used to update the film coordinate system of the images in a mosaic dataset, for example, when the images are rotated incorrectly after adding them to a mosaic dataset.

Parameters

LabelExplanationData Type
Input Mosaic Dataset

The mosaic dataset that is created from scanned aerial photos using the scanned raster type or frame camera raster type.

Mosaic Layer
Query Definition
(Optional)

A query definition string that defines a subset of rasters for computing fiducials.

SQL Expression
Fiducial Table

The fiducial table created using the Compute Fiducials tool.

Table View
Film Coordinate System

Defines the film coordinate system of the scanned aerial photograph. It is used in computing fiducial information and affine transformation construction.

  • No changeMaintain 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 upThe origin of the scanned photo's coordinate system is the center, and positive X points right and positive Y points up.
  • X up, Y leftThe origin of the scanned photo's coordinate system is the center, and positive X points up and positive Y points left.
  • X left, Y downThe origin of the scanned photo's coordinate system is the center, and positive X points left and positive Y points down.
  • X down, Y rightThe origin of the scanned photo's coordinate system is the center, and positive X points down and positive Y points right.
String
Update Footprints
(Optional)

Generates or updates the footprints of the digital photos in the mosaic dataset.

  • Checked—The footprints will be generated or updated.
  • Unchecked—The footprints will not be generated or updated. This is the default
Boolean

Derived Output

LabelExplanationData Type
Output Mosaic Dataset

The updated mosaic dataset.

Mosaic Layer

arcpy.management.UpdateInteriorOrientation(in_mosaic_dataset, {where_clause}, fiducial_table, film_coordinate_system, {update_footprints})
NameExplanationData Type
in_mosaic_dataset

The mosaic dataset that is created from scanned aerial photos using the scanned raster type or frame camera raster type.

Mosaic Layer
where_clause
(Optional)

A query definition string that defines a subset of rasters for computing fiducials.

SQL Expression
fiducial_table

The fiducial table created using the Compute Fiducials tool.

Table View
film_coordinate_system

Defines the film coordinate system of the scanned aerial photograph. It is used in computing fiducial information and affine transformation construction.

  • NO_CHANGEMaintain 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_UPThe origin of the scanned photo's coordinate system is the center, and positive X points right and positive Y points up.
  • X_UP_Y_LEFTThe origin of the scanned photo's coordinate system is the center, and positive X points up and positive Y points left.
  • X_LEFT_Y_DOWNThe origin of the scanned photo's coordinate system is the center, and positive X points left and positive Y points down.
  • X_DOWN_Y_RIGHTThe origin of the scanned photo's coordinate system is the center, and positive X points down and positive Y points right.
String
update_footprints
(Optional)

Generates or updates the footprints of the digital photos in the mosaic dataset.

  • UPDATEThe footprints will be generated or updated.
  • NO_UPDATEThe footprints will not be generated or updated. This is the default
Boolean

Derived Output

NameExplanationData Type
out_mosaic_dataset

The updated mosaic dataset.

Mosaic Layer

Code sample

UpdateInteriorOrientation example 1 (Python window)

This is a Python sample for the UpdateInteriorOrientation tool.

import arcpy
arcpy.UpdateInteriorOrientation_management(
          "c:\\Test\\ortho.gdb\\orthoMD", "", "c:\\test\\fidducial.csv", 
          "X_DOWN_Y_RIGHT", "UPDATE")
UpdateInteriorOrientation example 2 (stand-alone script)

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

import arcpy

in_mosaic_dataset = "c:\\Test\\ortho.gdb\\orthoMD"
whereClause = ""
fiducialTable = "c:\\test\\fidducial.csv"
film_coordsys = "X_DOWN_Y_RIGHT"
update_footprints = "UPDATE"

arcpy.UpdateInteriorOrientation_management(in_mosaic_dataset, whereClause,
fiducialTable, film_coordsys, update_footprints)

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics