Create and Publish Geospatial Video OIType

Owned by Vicky Duran
Jun 06, 2024
4 min read

This document describes the steps required to create an Oriented Imagery Catalog with a Geospatial Video OIType

Input Data Description

There are three parameters required as input for this OICType. Detailed explanation of the parameters
can be found below.

  • Metadata File: The CSV file with geospatial metadata.

  • Video File: The video file will be used in the Oriented Imagery Catalog.

  • Frames Step (In Seconds): The frame interval to define OIC exposure points.

Create a Metadata File using appropriate tools and a Spreadsheet (Microsoft Excel, Google Sheets, etc.)

The input metadata file must be an ASCII file in CSV (comma-separated variable) format, with the
following minimum fields defined:

UNIX Time Stamp: Coordinated Universal Time (UTC) represented as the number of microseconds elapsed since midnight (00:00:00), January 1, 1970. Derived from the POSIX IEEE 1003.1 standard. Time resolution: 1 microsecond. Note that a recommended time interval for separate metadata records is 1 second
Sensor Latitude: The latitudinal position of the sensor aboard the aircraft, drone, or terrestrial camera in decimal degrees.
Sensor Longitude: The longitudinal position of the sensor aboard the aircraft, drone, or terrestrial camera, in decimal degrees
Sensor True Altitude: The altitude of the sensor Above Mean Sea Level (AMSL – also known as orthometric height)
Platform Heading Angle: Aircraft, drone, or terrestrial camera heading angle. Measured from the forward longitudinal axis relative to True North, it is measured in the horizontal plane, positive clockwise. (0…360, where “due East” would be 90)
Platform Pitch Angle: Aircraft, drone, or terrestrial camera pitch angle. It is determined by the rotation around the side-to-side axis of the collection platform, also described as nose up or nose down, measured positive upward (0…+/- 20). Note that Pitch = 0 means the platform is aimed toward the forward horizon, so for a sensor aimed at nadir (straight down), the Platform Pitch Angle would typically be approximately -90.
Platform Roll Angle: Aircraft, drone, or terrestrial camera roll angle determined by the rotation around the longitudinal axis of the collection platform, measured positive clockwise when viewed from behind.
Sensor Horizontal Field of View: Horizontal field of view of the imaging sensor and lens expressed in degrees (0…180).
Sensor Vertical Field of View: Vertical field of view of the imaging sensor and lens expressed in degrees (0…180).
Sensor Relative Azimuth Angle: Horizontal field of view of the imaging sensor and lens expressed in degrees (0…180).
Sensor Relative Elevation Angle: The Relative Elevation Angle of the sensor specifies the sensor orientation relative to the platform transverse-longitudinal plane, measured in degrees positive upward. A camera aimed toward the direction of flight would show SensorRelativeElevation = 0, whereas a camera aimed out of the floor of the aircraft would show -90. Positive angles would represent viewing above the horizon.
Sensor Relative Roll Angle: Relative roll angle of the sensor relative to the aircraft platform. Rotational angle of the camera about the lens axis. The top of the image is zero degrees. Positive angles are clockwise when looking from behind the camera. Angles are expressed in degrees (0…359.99).

DJI Drones:

DJI drones record video and data about the flight parameters in separate files. The flight data file is encrypted, and then additional software is required to read the flight data and convert it to the metadata csv file format used by ArcGIS pro. A recommended software is LineVision Desktop Ultimate.

Create an Oriented Imagery Catalog using ArcGIS pro

Go to your ArcGIS Pro and Create a New Project

  • Create an empty Map, however, if you already have a map with layers, it can be used as well.

  • Add a Toolbox

  • Select the Oriented Imagery ToolBox

     

  • Activate Catalog Pane

  • Open the recently added toolbox

  • Click on Create Oriented Imagery Catalog

  • Add Images to the Oriented Imagery Catalog

     

  • Select GeospatialVideo as the Input Type and Enter the requested Parameters.

    Metadata File: Eg. D:\project\sample\DJI_0229_2020-10-13_11-52-40_videolog.csv
    NOTE: If you copy and paste the path, make sure not to include a “\” slash at the end and remove any quotation marks.
    Video File: http://.s3.amazonaws.com/videofile/VID_0001.MP4 NOTE: If you copy and paste the path, make sure not to include a “/” backslash at the end and remove any quotation marks.
    Frame Step (in Seconds): Enter a value to sample the metadata file to populate the ‘exposure points’ of the OIC.

    Select GeospatialVideo_Defaults Imagery Type.

  • Publish the Oriented Imagery Catalog

Resources: