视频元数据至要素类 (Image Analyst)

获得 Image Analyst 许可后可用。

摘要

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

使用情况

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

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

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

  • 该工具可以具有 4 种类型的输出,并且必须至少指定一种输出。 如果所有 4 种输出均为空,则该工具将失败。

参数

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

兼容 FMV 的输入视频文件,其中包含视频数据每帧的基本元数据。 受支持的视频文件类型包括 PS、TS、MPG、MPEG、MP2、MPG2、MPEG2、MP4、MPG4、MPEG4、H264、H265、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
输出 VMTI 要素数据集
(可选)

输出要素类,其中包含视频 VMTI 信息。

Feature Class

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

兼容 FMV 的输入视频文件,其中包含视频数据每帧的基本元数据。 受支持的视频文件类型包括 PS、TS、MPG、MPEG、MP2、MPG2、MPEG2、MP4、MPG4、MPEG4、H264、H265、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
vmti
(可选)

输出要素类,其中包含视频 VMTI 信息。

Feature Class

代码示例

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)

许可信息

  • Basic: 需要 Image Analyst
  • Standard: 需要 Image Analyst
  • Advanced: 需要 Image Analyst

相关主题