Доступно с лицензией Image Analyst.
Сводка
Создает FMV-совместимый видео файл, который сочетает архивный видео файл и файл метаданных, синхронизированные по временным меткам.
Инструмент создает единый FMV-совместимый видео файл на основе потокового видео файла и отдельного связанного с ним файла с метаданными. Метаданные кодируются в видео файл и синхиронизируются по временной метке. Процесс комбинации двух файлов, содержащих файлы видео и метаданных, называется мультиплексацией.
Использование
Этот инструмент предназначен для архивных видео файлов и не работает с потоковым видео в реальном времени.
Формат видео файла, который нужно мультиплексировать, должет соответствовать одному из 12 поддерживаемых видео форматов. Отдельный файл метаданных должен быть файлом с разделителями-запятыми (CSV), в котором содержатся корректные заголовки полей и связанные значения.
Поддерживаемые форматы видео перечислены в таблице ниже:
Описание Расширение MPEG-2 Transport Stream
.ts MPEG-2 Program Stream
.ps Файл MPEG
.mpg Файл MPEG-2
.mpg2 Файл MPEG-2
.mp2 Файл MPEG
.mpeg VLC (mpeg2)
.mpeg2 MPEG-4 Movie
.mp4 Файл MPEG-4
.mpg4 Файл видео H264
.h264 Файл VLC Media (mpeg4)
.mpeg4 Файл VLC Media (vob)
.vob Метаданные, связанные с потоковым видео файлом, используются для вычисления пути пролета видео-сенсора, центра кадра изображения видео и четырех углов рамки кадра видео на карте.
FMV поддерживает спецификацию Motion Imagery Standards Board (MISB). Полная спецификация MISB
определяет гораздо больше параметров, чем те, которые необходимы для FMV. Указанные параметры MISB будут закодированы в финальное видео, включая все параметры их поднабора.Чтобы вычислить и показать соответствующие угловые точки рамки кадра видео в виде контура рамки на карте, вам нужно 12 отдельных полей в метаданных, которые указаны ниже с деталями в описании параметров. Если метаданные заполнены точно и полностью, инструмент вычислит углы рамки видео, поэтому размер, форма и расположение рамки кадра видео затем может быть показано на карте. Необходимые поля метаданных, которые нужны для вычисления контура рамки видео на карте, указаны ниже:
- Время в формате Unix
- Широта сенсора
- Долгота сенсора
- Высота сенсора
- Направление платформы
- Тангаж платформы
- Крен платформы
- Относительный поворот сенсора
- Относительная высота сенсора
- Относительный азимут сенсора
- Горизонтальное поле зрения
- Вертикальное поле зрения
Это минимальный набор метаданных, который нужен для вычисления перехода между видео и картой, показать контур видео на карте, а также включить другие функции вроде оцифровки и пометок видео на карте.
Значения для полей метаданных могут быть введены в шаблоне метаданных, FMV_Multiplexer_Field_Mapping_Template.csv, полученном из C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo.
- Файл FMV_Multiplexer_Field_Mapping_Template.csv содержит все поля метаданных MISB.
- Для создания FMV-совместимого видео файла нужно только 12 параметров, указанных выше. Вам не нужно задавать все параметры, указанные в спецификации MISB, чтобы создать FMV-совместимый видео файл. Если заданы дополнительные параметры MISB, они будут встроены в FMV-совместимый видео файл.
Производительность полученного мультиплексированного видео будет зависеть от типа и качества данных, которые содержатся в файле метаданных, и от того, насколько точно синхронизированы файлы метаданных и видео-данные.
- Если в вашем файле FMV_Multiplexer_Field_Mapping_Template.csv содержатся только поля UNIX Time Stamp, Sensor Latitude и Sensor Longitude, то местоположение сенсора будет показано на карте, но рамки кадров видео отобразить не получится. Некоторая функциональность, например, оцифровка объектов и измерение расстояния в видео, не поддерживается.
- Если временная метка, связывающая видео и метаданные, синхронизирована не точно, то контур видео и местоположение сенсора на карте будет смещено относительно вида в видео-проигрывателе. В таком случае используйте шаблон FMV_Multiplexer_TimeShift_Template.csv для выравнивания времени вашего видео и метаданных.
- Шаблон FMV_Multiplexer_TimeShift_Template.csv можно скачать с C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo.
Один набор параметров в файле FMV_Multiplexer_Field_Mapping_Template.csv включает координаты карты для четырех углов рамки кадра видео, спроецированные на поверхность земли. Если указаны координаты карты для четырех углов, то они будут использоваться при создании FMV-совместимого видео. Если координат карты для четырех углов нет, укажите источник данных ЦМР в параметр Цифровая модель рельефа, после чего инструмент вычислит контур видео на основе указанных выше параметров.
Точность контура видео и центра кадра зависит от точности указанного источника данных ЦМР. Если у вас нет данных ЦМР, вы можете ввести среднюю высоту и единицы измерения относительно уровня моря, например, 15 футов или 10 метров. В случае работы под поверхностью вы можете указать -15 футов или -10 метров. Использование среднего значения высоты или океанической глубины не такое точное, как использование данных ЦМР или батиметрии. Рекомендуется указать слой ЦМР или сервис изображений, если он есть.
Синтаксис
VideoMultiplexer(in_video_file, metadata_file, out_video_file, {metadata_mapping_file}, {timeshift_file}, {elevation_layer})| Parameter | Объяснение | Тип данных |
in_video_file | Входной файл видео, который будет конвертирован в FMV-совместимый видео файл. Поддерживаются следующие типы видео файлов: .avi (поддерживает H.264, не H.265), .h264, .mp2, .mp4,.m2ts,.mpeg, .mpeg2, .mpeg4, .mpg, .mpg2, .mpg4, .ps, .ts и vob. | File |
metadata_file | Файл с разделителями в виде запятых (CSV), содержащий метаданные видеокадров для указанного времени. Каждый столбец соответствует одному полю метаданных, а один из столбцов должен содержать временную метку. Временная метка - это Unix Time Stamp (количество секунд после 1970), умноженное на миллион, хранится в целочисленном формате. Время хранится таким образом, что любой момент времени (до одной миллионной секунды), может быть задан целым числом. Соответственно, временное различие 500000 между двумя записями составляет половину секунды. В первой строке должны быть имена полей для столбцов метаданных. Эти имена полей можно сопоставить с соответствующими именами полей, используя при необходимости файл FMV_Multiplexer_Field_Mapping_Template.csv. Каждая последующая строка содержит значения метаданных для указанного времени в поле времени. Шаблон FMV_Multiplexer_Field_Mapping_Template.csv можно скачать с C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo. | File |
out_video_file | Имя выходного видео файла включает расширение файла . Поддерживаются следующие видео файлы: .h264, .mp2, .mp4, .m2ts, .mpeg, .mpeg2, .mpeg4, .mpg, .mpg2, .mpg4, .ps, .ts и vob. | File |
metadata_mapping_file (Дополнительный) | Файл CSV , содержащий 5 столбцов и 87 строк, основан на файле шаблона FMV_Multiplexer_Field_Mapping_Template.csv, полученного из C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo. Каждая строка представляет один из тегов стандартных метаданных MISB, например, высоту сенсора. Первые два столбца содержат индекс MISB и имя тега MISB. Третий столбец содержит имя поля, которое появляется в параметре in_metadata_file, если он есть. Когда третий столбец заполнен, программное обеспечение сможет сопоставить ваши имена поля метаданных с соответствующими тегами метаданных FMV. Четвертый и пятый столбцы представляют единицы измерения и примечания, связанные с тегом. | File |
timeshift_file (Дополнительный) | Файл, содержащий заданные интервалы временного сдвига. В идеале видео изображения и метаданные синхронизируются по времени. Если у вас именно такой случай, контур изображения в видео окружает объекты, которые можно увидеть в изображении видео. Иногда есть невязка между временем в видео и временем в метаданных. Это приводит к явной временной задержке между тем, когда наземный объект окружен контуром изображения, и когда этот наземный объект становится видимым на видео изображении. Если этот временной сдвиг заметен и постоянен, мультиплексор может настроить синхронизацию метаданных, чтобы они соответствовали видео. Если есть невязка между временем в видео и временем в метаданных, укажите временной сдвиг в шаблоне FMV_Multiplexer_TimeShift_Template.csv, полученном с C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo. Файл наблюдений временного сдвига представляет собой файл CSV с двумя столбцами (elapsed time и time shift), а также одну или несколько строк с данными. Строка для названий столбцов не обязательна. Например, если у видео-изображения есть 5-секундное отставание от основного времени, то в файле наблюдений сдвига по времени будет только одна строка: 0:00, -5. Все видео будет сдвинуто на 5 секунд. Если есть 5-секундная задержка на отметке 0:18 видео и 9-секундная задержка на отметке 2:21 видео, то в файле наблюдения сдвигов по времени будет две строки: В этом случае видео смещается по-разному в начале и в конце видео. Вы можете определить любое количество интервалов временного сдвига в файле наблюдения временного сдвига. | File |
elevation_layer (Дополнительный) | Источник высот необходим для вычисления координат углов кадра видео. Этот источник может быть слоем, сервисом изображений или средним значением высоты или глубины. Среднее значение высоты должно учитывать единицы измерения, например, метры или футы, или другие единицы измерения длины. Точность контура видео и центра кадра зависит от точности указанного источника данных ЦМР. Рекомендуется указать слой ЦМР или сервис изображений. Если у вас нет данных ЦМР, вы можете ввести среднюю высоту и единицы измерения относительно уровня моря, например, 15 футов или 10 метров. В случае работы под поверхностью вы можете указать -15 футов или -10 метров. Использование среднего значения высоты или океанической глубины не такое точное, как использование данных ЦМР или батиметрии. Для расчета координат углов кадра среднее значение высоты всегда должно быть меньше высоты или глубины сенсора, записанных в метаданных. Например, если видео было снято на высоте сенсора 10 метров и выше, допустимая средняя высота может составлять 9 метров или меньше. Если видео было снято под водой на глубине -10 метров и глубже, допустимая средняя высота (относительно уровня моря) может быть -11 или больше. Если значение Высоты сенсора меньше среднего значения высоты, координаты четырех углов не будут вычисляться для этой записи. Если вы не знаете среднюю высоту для области проекта, используйте ЦМР. | Raster Layer; Image Service; Linear Unit |
Пример кода
В этом примере создается видео файл, который объединяет архивированное видео и связанные метаданные.
arcpy.ia.VideoMultiplexer(r"C:\input_video.mpeg", r"C:\video_metadata.csv", r"C:\output_video.mpeg",
r"C:\Video_Multiplexer_MISB_Field_Mapping_Template.csv",
r"C:\Video_Multiplexer_TimeShift_Template.csv", "c:\\test\\dem.tif”)В этом примере создается видео файл, который объединяет архивированное видео и связанные метаданные.
import arcpy
from arcpy.ia import *
arcpy.CheckOutExtension("ImageAnalyst")
in_video = "c:\\test\\drone_vid.mpeg"
in_metadata = "c:\\test\\videometadata.csv"
out_video = "c:\\test\\mutiplexer_output.mpeg"
MISB_mapping = "c:\\test\\Field_Mapping_Template.csv"
time_shift_file = "c:\\test\\timeshift.csv"
in_elevation_layer = "c:\\test\\dem.tif"
arcpy.ia.VideoMultiplexer(in_video, in_metadata, out_video, MISB_mapping, time_shift_file, in_elevation_layer)Environments
Информация о лицензиях
- Basic: Требуется Image Analyst
- Standard: Требуется Image Analyst
- Advanced: Требуется Image Analyst