Skip to main content

Add Images To Oriented Imagery Dataset (Oriented Imagery Tools)

Summary

Adds images to an oriented imagery dataset from multiple input sources, including a file, folder, table, list of image paths, or a point feature layer.

Usage

  • The images that are added are not managed by the oriented imagery dataset; the dataset points to where the images are stored. If an image is deleted or moved, it won't be loaded on the oriented imagery viewer.

  • Based on the Input Data parameter value, the tool identifies metadata required for loading data into the oriented imagery dataset. The oriented imagery functionality depends on the metadata information.

  • All input data options support the JPEG format. In the following cases, the images must be added using a .csv file following the oriented imagery table schema, a feature layer following the oriented imagery attribute table schema, or an oriented imagery layer:

    • The image format is GeoTIF or MRF.

    • The image metadata is stored separately from the image files or needs to be edited before being added.

    • You are including camera orientation, which enables more accurate image-to-ground and ground-to-image transformations.

  • If data is added directly from image files, a folder containing images, or a text file with a list of image paths, the metadata information is extracted from the image EXIF and XMP data. At a minimum, the EXIF data must contain geographic location information.

Parameters

Label Explanation Data type

Oriented Imagery Dataset

The path and name of the oriented imagery dataset where the images will be added.

Oriented Imagery Layer

Imagery Category

Specifies the type of input images that will be used and sets the default properties of the oriented imagery dataset. The default property will be used if the equivalent attribute is not found in the oriented imagery dataset attribute table.

  • Horizontal—Images in which the exposure is parallel to the ground and looking to the horizon will be used.

  • Oblique—Images in which the exposure is at an angle to the ground, typically at about 45 degrees so sides of objects can be seen will be used.

  • Nadir—Images in which the exposure is perpendicular to the ground and looking straight down will be used. Only the top of the objects can be seen.

  • 360—Images taken using specialized cameras that provide 360-degree spherical surround views or have been stitched together as 360-degree views from multiple cameras will be used.

  • Inspection—Close-up imagery of assets (less than five meters from the camera) will be used.

  • AeriaFrameVideo—Video captured by a drone or aircraft with the camera pointing downward towards the ground.

  • TerrestrialFrameVideo—Video captured using handheld devices, such as dashboard cameras.

  • Terrestrial360Video—A 360-degree video captured using devices such as GoPro or Insta360.

String

Input Data

The path and name of the input data. The following are supported:

Folder; Oriented Imagery Layer; Table; Raster Layer; File

Include sub folders

(Optional)

Specifies whether subfolders will be recursively explored for data.

  • Checked—All subfolders will be recursively explored for data. This is the default.

  • Unchecked—Only the top-level folder will be explored for data.

Boolean

Input Folder Filter

(Optional)

An expression that will be used to filter and add images in the input folder.

For example, to only add images that contain a particular string, add percentage signs before and after the string value (%value%).

String

Input Table Filter

(Optional)

An SQL expression that will be used to select a subset of records. For more information about SQL syntax, see SQL reference for query expressions used in ArcGIS.

SQL Expression

Include all fields from input table

(Optional)

Specifies whether all fields from the input table, apart from the required schema, will be added to the dataset's attribute table.

  • Checked—All fields from the input table will be added to the dataset's attribute table.

  • Unchecked—Only oriented imagery schema-specific fields will be added to the dataset's attribute table. This is the default.

Boolean

Input Video File

(Optional)

A video file stored on a public cloud location. The video file must be compatible with standard web browsers. See Common codecs for more information on supported video types (formats and codecs). For TerrestrialFrameVideo and Terrestrial360Video inputs, the tool automatically extracts the sensor location and timestamp field when the video includes valid KLV metadata.

File

Metadata file

(Optional)

A .csv file containing the metadata of the video.

For AerialFrameVideo, each aerial frame video must be accompanied by a local .csv file containing the following fields for every frame: Precision Timestamp, Sensor Latitude, Sensor Longitude, Sensor Ellipsoid Height or Sensor True Altitude, Platform Heading Angle, Platform Pitch Angle, Platform Roll Angle, Sensor Relative Roll Angle, Sensor Relative Elevation Angle, Sensor Relative Azimuth Angle, Sensor Horizontal Field of View, Sensor Vertical Field of View. All fields are required and must include valid values.

For TerrestrialFrameVideo and Terrestrial360Video, the .csv file is optional. When included, the file must be local and contain at least the following fields: X,Y and AcquisitionDate (formatted as yyyy-mm-dd HH:MM:SS).

File

Minimum Frame Interval

(Optional)

The minimum time interval required between consecutive video frames. Only frames that are separated by at least this amount of time will be added to the oriented imagery dataset. The default value is 1 second.

Time Unit

Minimum Sensor Position Change

(Optional)

The minimum distance in meters the sensor must move between frames. Only frames where the sensor position has changed by at least this value will be included in the oriented imagery dataset.

Double

Minimum Frame Overlap

(Optional)

The minimum overlap in percentage required between consecutive frames. Only frames with an overlap greater than this value will be included in the oriented imagery dataset. The default value is 0. A valid value for CameraHeading must be provided to ensure this parameter is correctly applied.

Double

Distance to Compute Overlap

(Optional)

The distance in meters used to compute the image footprint (frustum) for overlap calculations. If not provided, the default value is FarDistance / 2. For more information about FarDistance, see Oriented imagery table fields.

Double

Compute Heading

(Optional)

Specifies whether the tool will generate CameraHeading values.

Note:

The footprint computation will fail if the CameraHeading values are absent.

  • Checked—The tool will generate the CameraHeading values. These computed values take precedence even if the video already contains values for CameraHeading.

  • Unchecked—The tool will not generate the CameraHeading values.

Boolean

Heading Offset

(Optional)

An offset applied to the CameraHeading to account for the mounting position of the camera. This is useful when the camera is not forward-facing, such as when mounted on the side of a vehicle. The default value is 0.

Double

Derived output

Label Explanation Data type

Updated Oriented Imagery Dataset

The updated oriented imagery dataset.

Oriented Imagery Layer

Environments

Output Coordinate System, Geographic Transformations, Extent

Licensing information

  • Basic: No
  • Standard: Yes
  • Advanced: Yes