视频元数据至要素类 (影像分析)

获得 Image Analyst 许可后可用。

摘要

从兼容 FMV 的视频中提取平台、帧中心、帧轮廓和属性元数据。 输出几何和属性将保存为要素类。

使用情况

  • 此工具可将兼容 FMV 的视频元数据导出为要素类,其中所有的元数据都将作为属性表中的字段导出。 可将这些要素用于传感器位置、视频帧轮廓和视频帧中心,以验证正确的数据范围、执行空间查询以及执行属性查询,以便快速查找感兴趣的视频帧。

  • 该工具仅接受将存档视频文件而非实时视频流作为输入。

  • 该工具要求将兼容 FMV 的视频文件用作输入。 如果视频不包含视频流中的元数据,或如果该流不包含元数据包,则该工具将运行失败。

  • 该工具支持四种类型的输出,您必须至少指定一种输出。 如果全部四种输出均留空,则该工具将运行失败。

参数

标注说明数据类型
输入视频

兼容 FMV 的输入视频文件,其中包含对应视频数据中每一帧的基本元数据。 受支持的视频文件类型包括 PS、TS、MPG、MPEG、MP2、MPG2、MPEG2、MP4、MPG4、MPEG4、H264、VOB 和 M2TS。

File
输出元数据文件
(可选)

逗号分隔值 (CSV) 文件,其中包含有关特定时间的视频帧的元数据。

此元数据文件的格式与视频多路复用器工具所使用的格式相同。

File
输出飞行路径要素类
(可选)

包含传感器飞行路径信息的要素类。

Feature Class
飞行路径要素类类型
(可选)

用于指定飞行路径的要素类类型。

  • 点要素类。
  • 折线折线要素类。 这是默认设置。
String
输出影像路径要素类
(可选)

包含影像路径信息的输出要素类。

Feature Class
影像路径要素类类型
(可选)

用于指定影像路径的要素类类型。 如果您所使用的是点输出,则每个视频帧图像的中心都将显示在地图上。

  • 点要素类。
  • 折线折线要素类。 这是默认设置。
String
输出影像轮廓线要素类
(可选)

包含视频影像轮廓线信息的输出要素类。

Feature Class
元数据捕获开始时间
(可选)

记录视频开头的开始时间的元数据。 输入格式为 d.hh:mm:ss,且默认开始时间为 0.00:00:00。 此字段中不使用元数据时间戳;将使用视频文件中的时间。

Time Unit; Date
元数据捕获停止时间
(可选)

记录结束时间的元数据。 其输入格式为 d.hh:mm:ss。 如果未进行设置,则该值将默认为视频结尾的时间。 此字段中不使用元数据时间戳。

Time Unit; Date
要素间最小距离
(可选)

连续视频帧中要素之间的距离。 如果将其留空,则将提取每个元数据要素并将其添加到要素类中。

Linear Unit
要素间最小时间
(可选)

连续视频帧中要素之间的时间间隔。 如果将其留空,则将提取每个元数据要素并将其添加到要素类中。

Time Unit

VideoMetadataToFeatureClass(in_video, {csv_file}, {flightpath}, {flightpath_type}, {imagepath}, {imagepath_type}, {footprint}, {start_time}, {stop_time}, {min_distance}, {min_time})
名称说明数据类型
in_video

兼容 FMV 的输入视频文件,其中包含对应视频数据中每一帧的基本元数据。 受支持的视频文件类型包括 PS、TS、MPG、MPEG、MP2、MPG2、MPEG2、MP4、MPG4、MPEG4、H264、VOB 和 M2TS。

File
csv_file
(可选)

逗号分隔值 (CSV) 文件,其中包含有关特定时间的视频帧的元数据。

此元数据文件的格式与视频多路复用器工具所使用的格式相同。

File
flightpath
(可选)

包含传感器飞行路径信息的要素类。

Feature Class
flightpath_type
(可选)

用于指定飞行路径的要素类类型。

  • POINT点要素类。
  • POLYLINE折线要素类。 这是默认设置。
String
imagepath
(可选)

包含影像路径信息的输出要素类。

Feature Class
imagepath_type
(可选)

用于指定影像路径的要素类类型。 如果您所使用的是点输出,则每个视频帧图像的中心都将显示在地图上。

  • POINT点要素类。
  • POLYLINE折线要素类。 这是默认设置。
String
footprint
(可选)

包含视频影像轮廓线信息的输出要素类。

Feature Class
start_time
(可选)

记录视频开头的开始时间的元数据。 输入格式为 d.hh:mm:ss,且默认开始时间为 0.00:00:00。 此字段中不使用元数据时间戳;将使用视频文件中的时间。

Time Unit; Date
stop_time
(可选)

记录结束时间的元数据。 其输入格式为 d.hh:mm:ss。 如果未进行设置,则该值将默认为视频结尾的时间。 此字段中不使用元数据时间戳。

Time Unit; Date
min_distance
(可选)

连续视频帧中要素之间的距离。 如果将其留空,则将提取每个元数据要素并将其添加到要素类中。

Linear Unit
min_time
(可选)

连续视频帧中要素之间的时间间隔。 如果将其留空,则将提取每个元数据要素并将其添加到要素类中。

Time Unit

代码示例

VideoMetadataToFeatureClass 示例 1(Python 窗口)

此示例将从兼容 FMV 的视频中提取和保存平台、帧中心、帧轮廓和属性元数据。

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 示例 2(独立脚本)

此示例将从兼容 FMV 的视频中提取和保存平台、帧中心、帧轮廓和属性元数据。

import arcpy

arcpy.CheckOutExtension("ImageAnalyst")

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)