Video Metadata To Feature Class (Image Analyst Tools)

Summary

Extracts one or all of the following from a geospatial video with the correct metadata: the platform position, frame center, frame outline, and the video's metadata. The output geometry and attributes are saved as feature classes.

Usage

This tool exports video metadata as feature classes, with all the metadata as fields in an attribute table. These features can be used for platform position, video frame outline, and video frame center to verify proper data coverage, perform spatial queries, and perform attribute queries to quickly find video frames of interest.
This tool works with archived video files only. Live stream videos are not supported.
A metadata compliant video file must be used as input. The tool will fail if the video does not contain metadata in the video stream.
The tool can have five types of outputs, and you must specify at least one output. The tool will fail if all five outputs are left empty.

Label	Explanation	Data type
Input Video	The metadata compliant input video file containing essential metadata for each frame of the video data. The supported video file types are `.av1`, `.m2ts`, `.mkv`, `.mov`, `.mp2`, `.mp4`, `.mpeg`, `.mpeg2`, `.mpeg4`, `.mpg`, `.mpg2`, `.mpg4`, `.ps`, `.ts`, `.vob`, and `.wmv`.	File
Output Metadata File (Optional)	An output `.csv` or `.json` file containing metadata about the video frames for specific times. The metadata file is in the same format used by the Video Multiplexer tool.	File
Output Flight Path Feature Class (Optional)	The feature class containing the platform's flight path information.	Feature Class
Flight Path Feature Class Type (Optional)	Specifies the feature class type that will be used for the flight path. Point—A point feature class will be used for the flight path. Polyline—A polyline feature class will be used for the flight path. This is the default.	String
Output Image Path Feature Class (Optional)	The output feature class containing the image path information.	Feature Class
Image Path Feature Class Type (Optional)	Specifies the feature class type that will be used for the image path. If you're using a point output, the center of each video frame image will appear on the map. Point—A point feature class will be used for the image path. Polyline—A polyline feature class will be used for the image path. This is the default.	String
Output Image Footprint Feature Class (Optional)	The output feature class containing the video image footprint information.	Feature Class
Metadata Capture Start Time (Optional)	The metadata recording start time from the beginning of the video. The input format is d.hh:mm:ss, and the default start time is 0.00:00:00. Metadata time stamps are not used in this field; the time of the video file is used.	Time Unit; Date
Metadata Capture Stop Time (Optional)	The metadata recording end time. The input format is d.hh:mm:ss. If no value is provided, the value will default to the end of the video. Metadata time stamps are not used in this field.	Time Unit; Date
Minimum Distance Between Features (Optional)	The distance between the features in sequential video frames. If no value is provided, every metadata feature will be extracted and added to the feature class.	Linear Unit
Minimum Time Between Features (Optional)	The time interval between the features in sequential video frames. If no value is provided, every metadata feature will be extracted and added to the feature class.	Time Unit
Output VMTI Feature Dataset (Optional)	The output feature dataset containing the video VMTI information.	Feature Dataset

VideoMetadataToFeatureClass(in_video, {csv_file}, {flightpath}, {flightpath_type}, {imagepath}, {imagepath_type}, {footprint}, {start_time}, {stop_time}, {min_distance}, {min_time}, {vmti})

Name	Explanation	Data type
in_video	The metadata compliant input video file containing essential metadata for each frame of the video data. The supported video file types are `.av1`, `.m2ts`, `.mkv`, `.mov`, `.mp2`, `.mp4`, `.mpeg`, `.mpeg2`, `.mpeg4`, `.mpg`, `.mpg2`, `.mpg4`, `.ps`, `.ts`, `.vob`, and `.wmv`.	File
csv_file (Optional)	An output `.csv` or `.json` file containing metadata about the video frames for specific times. The metadata file is in the same format used by the Video Multiplexer tool.	File
flightpath (Optional)	The feature class containing the platform's flight path information.	Feature Class
flightpath_type (Optional)	Specifies the feature class type that will be used for the flight path. `POINT`—A point feature class will be used for the flight path. `POLYLINE`—A polyline feature class will be used for the flight path. This is the default.	String
imagepath (Optional)	The output feature class containing the image path information.	Feature Class
imagepath_type (Optional)	Specifies the feature class type that will be used for the image path. If you're using a point output, the center of each video frame image will appear on the map. `POINT`—A point feature class will be used for the image path. `POLYLINE`—A polyline feature class will be used for the image path. This is the default.	String
footprint (Optional)	The output feature class containing the video image footprint information.	Feature Class
start_time (Optional)	The metadata recording start time from the beginning of the video. The input format is d.hh:mm:ss, and the default start time is 0.00:00:00. Metadata time stamps are not used in this field; the time of the video file is used.	Time Unit; Date
stop_time (Optional)	The metadata recording end time. The input format is d.hh:mm:ss. If no value is provided, the value will default to the end of the video. Metadata time stamps are not used in this field.	Time Unit; Date
min_distance (Optional)	The distance between the features in sequential video frames. If no value is provided, every metadata feature will be extracted and added to the feature class.	Linear Unit
min_time (Optional)	The time interval between the features in sequential video frames. If no value is provided, every metadata feature will be extracted and added to the feature class.	Time Unit
vmti (Optional)	The output feature dataset containing the video VMTI information.	Feature Dataset

Code sample

VideoMetadataToFeatureClass example 1 (Python window)

This example extracts and saves the platform, frame center, frame outline, and attribute metadata from an FMV-compliant video.

import arcpy
arcpy.ia.VideoMetadataToFeatureClass(
    r"C:\test\input_video.ts", r"C:\output\outmeta.csv",
    r"C:\test\meta.gdb\flight_path", "POLYLINE", r"C:\test\meta.gdb\image_path",
    "POINT", r"C:\test\meta.gdb\image_footprint")

VideoMetadataToFeatureClass example 2 (stand-alone script)

This example extracts and saves the platform, frame center, frame outline, and attribute metadata from an FMV-compliant video.

import arcpy

in_video = "c:\\test\\drone_vid.ts"
out_metadata = "c:\\output\\outmeta.csv"
flight_path = "C:\\test\\meta.gdb\\flight_path"
flight_path_type = "POLYLINE"
image_path = "C:\\test\\meta.gdb\\image_path"
image_path_type = "POINT"
image_footprint = "C:\\test\\meta.gdb\\image_footprint"
start_time = "1 Seconds"
stop_time = "60 Seconds"
distance_between = "2 Meters"
min_time_between = "20 Seconds"

arcpy.ia.VideoMetadataToFeatureClass(
    in_video, out_metadata, flight_path, flight_path_type, image_path,
    image_path_type, image_footprint, start_time, stop_time, distance_between,
    min_time_between)

Environments

Output has Z values

Licensing information