Convert Video Metadata (Image Analyst Tools)

Summary

Prepares a video metadata file for further processing in geospatial video workflows by field matching and converting unit types. Possible fields that require field matching and unit conversion include coordinates, time formats, telemetry data, and elevation information.

Usage

This tool is designed for archived video metadata files and does not work with livestreams.
The input metadata format is a Comma-Separated Values (.csv) file.
Only fields with an unrecognized name or incorrect format need to be matched. All correct data will be copied to the new metadata file.
The output .csv metadata and mapping files are correctly structured to be used in workflows with the Video Multiplexer tool and the ArcGIS Video Server.

The possible fields to convert and match are listed in the following table with the required units and format:


Field Name	Unit and Format
Precision Timestamp	`Microseconds`
Sensor Latitude	`Degrees`
Sensor Longitude	`Degrees`
Sensor Ellipsoid Height Extended	`Meters`
Sensor True Altitude	`Meters`
Platform Heading Angle	`Degrees`
Platform Pitch Angle	`Degrees`
Platform Roll Angle	`Degrees`
Sensor Relative Roll Angle	`Degrees`
Sensor Relative Elevation Angle	`Degrees`
Sensor Relative Azimuth Angle	`Degrees`
Sensor Horizontal Field of View	`Degrees`
Sensor Vertical Field of View	`Degrees`

Label	Explanation	Data type
Input Metadata File	The input metadata file for field mapping and conversion. The only supported file type is a `.csv`.	File
Output Metadata File	The name of the output metadata file, including the `.csv` file extension.	File
Output Metadata Mapping File (Optional)	The `.csv` file that cross references the metadata field name to the video field name. Each row represents one of the standard metadata parameters, such as sensor latitude. The first two columns contain the information for the tag and MISB parameter name provided in the form. The third column contains the field name as it appears in the source metadata file. When the third column is populated, the tool can match the metadata field names to the proper video metadata tags.	File
Input Field Matching (Optional)	A multi-column input parameter that allows users to field match and convert fields in the input metadata file to the desired output file. To match or convert input metadata fields, select the desired metadata field, the input metadata field, and input field unit type. Value table columns: Target Fields—The metadata field name used in the motion imagery tools. Source Fields—The field name coming from the input video metadata that matches the target field. Source Unit—The unit and format of the source field such as feet or meter.	Value Table

ConvertVideoMetadata(in_metadata_file, out_metadata_file, {out_mapping_file}, {input_field_matching})

Name	Explanation	Data type
in_metadata_file	The input metadata file for field mapping and conversion. The only supported file type is a `.csv`.	File
out_metadata_file	The name of the output metadata file, including the `.csv` file extension.	File
out_mapping_file (Optional)	The `.csv` file that cross references the metadata field name to the video field name. Each row represents one of the standard metadata parameters, such as sensor latitude. The first two columns contain the information for the tag and MISB parameter name provided in the form. The third column contains the field name as it appears in the source metadata file. When the third column is populated, the tool can match the metadata field names to the proper video metadata tags.	File
input_field_matching [input_field_matching,...] (Optional)	A multi-column input parameter that allows users to field match and convert fields in the input metadata file to the desired output file. To match or convert input metadata fields, select the desired metadata field, the input metadata field, and input field unit type. Value table columns: `Target Fields`—The metadata field name used in the motion imagery tools. `Source Fields`—The field name coming from the input video metadata that matches the target field. `Source Unit`—The unit and format of the source field such as feet or meter.	Value Table

Code sample

ConvertVideoMetadata example 1 (Python window)

This example converts and field matches video metadata.

en\tool-reference\image-analyst\includes\code-samples\convertvideometadata_sample_1.py

ConvertVideoMetadata example 2 (stand-alone script)

This example converts and field matches video metadata.

en\tool-reference\image-analyst\includes\code-samples\convertvideometadata_sample_2

Environments

This tool does not use any geoprocessing environments.

Licensing information