| Etiqueta | Explicación | Tipo de datos |
Archivo de vídeo de entrada | Archivo de vídeo de entrada que se convertirá en un archivo de vídeo compatible con FMV. Se admiten los siguientes tipos de archivos de vídeo: .avi, .h264, .h265, .mp2, .mp4, .m2ts, .mpeg, .mpeg2, .mpeg4, .mpg, .mpg2, .mpg4, .ps, .ts y vob. | File |
Archivo de metadatos | Archivo de valores separados por comas (CSV) que contiene metadatos sobre los fotogramas de vídeo correspondientes a momentos específicos. Cada columna representa un campo de metadatos y una de las columnas debe ser una referencia de tiempo. La referencia de tiempo es la marca de tiempo Unix (segundos pasados desde 1970) multiplicado por un millón, que se almacena como un entero. El tiempo se almacena como tal para que se pueda hacer referencia a cualquier instante en el tiempo (hasta un millón de segundos) con un entero. Por consiguiente, una diferencia de tiempo entre dos entradas de 500.000 representa una mitad de un segundo en el tiempo transcurrido. La primera fila contiene los nombres de campo correspondientes a las columnas de metadatos. Estos nombres de campo figuran en el archivo FMV_Multiplexer_Field_Mapping_Template.csv de C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo, pero los nombres de campo personalizados también pueden asociarse a sus correspondientes nombres de campo FMV utilizando la plantilla. Cada fila posterior contiene los valores de metadatos correspondientes a un tiempo concreto, denominado marca de tiempo. Los nombres de los campos de metadatos pueden estar en cualquier orden y deberían nombrarse exactamente como aparecen en la plantilla FMV_Multiplexer_Field_Mapping_Template.csv para correlacionar los nombres de campos de metadatos con los nombres de campos de metadatos FMV adecuados. | File |
Archivo de video de salida | Nombre del archivo de vídeo de salida, incluida la extensión del archivo. El archivo de vídeo de salida admitido es .ts solamente. | File |
Archivo de asignación de metadatos (Opcional) | Archivo CSV que contiene 5 filas y 87 columnas y se basa en el archivo de plantilla FMV_Multiplexer_Field_Mapping_Template.csv obtenido de C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo. Este archivo CSV coteja el nombre del campo de metadatos con el nombre del campo FMV. Cada fila representa uno de los parámetros de metadatos estándar, como la latitud del sensor. Las dos primeras columnas contienen la información de la etiqueta y el nombre del parámetro MISB ya proporcionado en el formulario. La tercera columna contiene el nombre de campo como aparece en el parámetro Archivo de metadatos de entrada. Cuando se rellena la tercera columna, la herramienta puede emparejar con los nombres de campos de metadatos con las etiquetas de metadatos FMV adecuadas. | File |
Archivo de desplazamiento de tiempo (Opcional) | Archivo que contiene intervalos de cambio de tiempo definidos. Lo ideal sería que las imágenes de vídeo y los metadatos se sincronicen en el tiempo. En este caso, la huella de la imagen en el vídeo de movimiento completo rodea las entidades que pueden verse en la imagen de vídeo. A veces se produce una discrepancia entre el tiempo del vídeo y el de los metadatos. Esto genera un retraso aparente entre el momento en que una entidad de suelo está rodeada por la huella de la imagen y el momento en que esa entidad de suelo está visible en la imagen de vídeo. Si este cambio de tiempo es observable y consistente, el multiplexor puede ajustar la cronología de los metadatos para que coincidan con el vídeo. Si se produce una discrepancia entre el tiempo del vídeo y los metadatos, especifique el cambio de tiempo en la plantilla FMV_Multiplexer_TimeShift_Template.csv de C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo. El archivo de observación de cambio de tiempo es un archivo CSV que contiene dos columnas (elapsed time y time shift) y una o varias filas de datos. Es opcional tener una fila para nombres de columna. Por ejemplo, si la imagen de vídeo tiene un retraso de 5 segundos durante todo el tiempo, el archivo de observación de cambio de tiempo tendrá una línea: 0:00, -5. El vídeo entero se desplaza 5 segundos. Cuando se produce un retraso de 5 segundos en la marca 0:18 del vídeo y un retraso de 9 segundos en la marca 2:21 del vídeo, el archivo de observación de cambio de tiempo tendrá las dos líneas siguientes: En este caso, el vídeo cambia de manera diferente al principio y al final. Puede definir cualquier cantidad de intervalos de cambio de tiempo en el archivo de observación de cambio de tiempo. | File |
Modelo digital de elevación (Opcional) | Fuente de la elevación necesaria para calcular las coordenadas de las esquinas del fotograma de vídeo. La fuente puede ser una capa, un servicio de imágenes o la elevación media del suelo o la profundidad del océano. El valor de elevación media debe incluir unidades de medida como metros o pies, o cualquier medida de longitud. La precisión de la huella de vídeo y el centro del fotograma depende de la precisión de la fuente de datos de DEM proporcionada. Se recomienda proporcionar una capa DEM o un servicio de imágenes. Si no tiene acceso a los datos de DEM, puede introducir la elevación media y la unidad relativa al nivel del mar, como 15 pies o 10 metros. En el caso de un submarino, pueden introducir -15 pies o -10 metros. Usar la elevación media o la profundidad oceánica no es tan exacto como proporcionar datos de DEM o batimétricos. Para calcular las coordenadas de las esquinas del fotograma, el valor de elevación media siempre debe menor que la altitud o la profundidad del sensor según se registra en los metadatos. Por ejemplo, si el vídeo se ha filmado a la altitud de un sensor de 10 metros o más, una elevación media válida podría ser 9 metros o menos. Si el vídeo se ha filmado bajo el agua a una profundidad de -10 metros o más, la elevación media válida (con respecto al nivel del mar) podría ser -11 o más. Si el valor de Altitud del sensor es menor que el valor de elevación media, no se calcularán las coordenadas de las cuatro esquinas correspondientes a ese registro. Si no conoce la elevación media del área del proyecto, utilice un DEM. | Raster Layer; Image Service; Linear Unit |
Disponible con licencia de Image Analyst.
Resumen
Crea un archivo de vídeo que combine un archivo de transmisión de vídeo archivado y un archivo de metadatos asociado sincronizado por una marca de tiempo.
La herramienta crea un solo archivo de vídeo compatible con FMV a partir de un archivo de transmisión de vídeo y un archivo de metadatos asociado separado. Los metadatos se codifican en el archivo de vídeo mediante una marca de tiempo sincronizada. El proceso de combinar dos archivos que contienen archivos de vídeo y metadatos se denomina multiplexación.
Uso
Esta herramienta está diseñada para archivos de vídeo archivados y no funciona con transmisiones de vídeo en directo.
El formato del archivo de vídeo que se va a multiplexar debe ser uno de los formatos de vídeo admitidos. El archivo de metadatos separado es un archivo de valores separados por comas (CSV) que contiene los encabezados de campo adecuados y valores asociados.
Los formatos de vídeo admitidos como entrada de la herramienta figuran en la tabla siguiente:
Descripción Extensión Archivo MOV
.mov Flujo de transmisión de MPEG-2
.ts Flujo de programa de MPEG-2
.ps Archivo MPEG
.mpg Archivo MPEG-2
.mpg2 Archivo MPEG-2
.mp2 Archivo MPEG
.mpeg VLC (mpeg2)
.mpeg2 Película MPEG-4
.mp4 Archivo MPEG-4
.mpg4 MPEG-Dash
.mpd Archivo de vídeo H264¹
.h264 Archivo de vídeo H265¹
.h265 Archivo de medios VLC (mpeg4)
.mpeg4 Archivo de medios VLC (vob)
.vob HLS (velocidad de bits adaptable [ABR])
.m3u8 ¹ Requiere multiplexación
El formato de salida del archivo de vídeo de la herramienta es .ts solamente.
Los metadatos asociados con el archivo de transmisión de vídeo se utilizan para calcular la ruta de vuelo del sensor de vídeo, el centro del fotograma de imagen de vídeo y las cuatro esquinas de la huella del fotograma de vídeo del mapa.
FMV admite la especificación del Consejo de Estándares de Imágenes en Movimiento (MISB). La especificación MISB completa define muchos más parámetros que los que se requieren para FMV. Los parámetros del MISB facilitados se codificarán en el vídeo final, incluidos todos los parámetros o un subconjunto.
Para calcular y visualizar los puntos de esquina relativos de la huella de la imagen de vídeo como un contorno de cuadro en el mapa, necesita los 12 campos de metadatos esenciales que se enumeran a continuación y se detallan en la descripción del parámetro. Cuando los metadatos sean completos y precisos, la herramienta calculará las esquinas del cuadro de vídeo y el tamaño, la forma y la posición del contorno del cuadro de vídeo que puede visualizarse a continuación en un mapa.
- Marca de hora de precisión
- Latitud de sensor
- Longitud de sensor
- Altura del elipsoide del sensor o altitud verdadera del sensor
- Ángulo de recorrido de plataforma
- Ángulo de inclinación de plataforma
- Ángulo de giro de plataforma
- Ángulo de giro relativo del sensor
- Ángulo de elevación relativa del sensor
- Ángulo azimutal relativo del sensor
- Campo de visión horizontal del sensor
- Campo de visión vertical del sensor
Estos son los metadatos mínimos necesarios para calcular la transformación entre vídeo y mapa, mostrar la huella de vídeo en el mapa y habilitar otras funciones, como digitalizar y marcar en el vídeo y el mapa.
Los valores de los campos de metadatos pueden introducirse en la plantilla de metadatos, FMV_Multiplexer_Field_Mapping_Template.csv, desde C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo.
- El archivo FMV_Multiplexer_Field_Mapping_Template.csv contiene todos los campos de metadatos de MISB.
- Solo se necesitan los 12 parámetros definidos antes para crear el archivo de vídeo compatible con FMV. No necesita proporcionar todos los parámetros definidos en la especificación MISB para crear un archivo de vídeo compatible con FMV. Si se proporcionan parámetros de MISB adicionales, se codificarán en el archivo de vídeo compatible con FMV.
El rendimiento del archivo de vídeo multiplexado resultante depende del tipo y la calidad de los datos contenidos en el archivo de metadatos, así como de la precisión con la que se sincronizan los datos de vídeo y los archivos de metadatos.
- Si el archivo de FMV_Multiplexer_Field_Mapping_Template.csv solo contiene los campos UNIX Time Stamp, Sensor Latitude y Sensor Longitude, la ubicación del sensor se mostrará en el mapa, pero no se mostrará la huella de los fotogramas de vídeo. Algunas funcionalidades no se admitirán, por ejemplo, la digitalización de entidades y la medición de distancias en el vídeo.
- Si la marca de tiempo que vincula el vídeo y los metadatos no se sincroniza con precisión, la huella del vídeo y la ubicación del sensor del mapa se desplazarán de la vista en el reproductor de vídeo. En este caso, utilice la plantilla FMV_Multiplexer_TimeShift_Template.csv para ajustar el tiempo del vídeo y los metadatos.
- La plantilla FMV_Multiplexer_TimeShift_Template.csv está en C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo.
Un conjunto de parámetros del archivo FMV_Multiplexer_Field_Mapping_Template.csv incluye las coordenadas de mapa de las cuatro esquinas del marco de imagen de vídeo proyectadas en el suelo. Si se facilitan las coordenadas del mapa de cuatro esquinas, se utilizarán al crear el vídeo compatible con FMV. Si no se facilitan las coordenadas del mapa de cuatro esquinas, proporcione una fuente para los datos de DEM en el parámetro Modelo de elevación digital y la herramienta calculará la huella de vídeo de los parámetros necesarios que figuran arriba.
La precisión de la huella de vídeo y el centro del fotograma depende de la precisión de la fuente de datos de DEM proporcionada. Si no tiene acceso a los datos de DEM, puede introducir la elevación media y la unidad relativa al nivel del mar, como 15 pies o 10 metros. En el caso de un submarino, pueden introducir -15 pies o -10 metros. Usar la elevación media o la profundidad oceánica no es tan exacto como proporcionar datos de DEM o batimétricos. Se recomienda proporcionar una capa DEM o un servicio de imágenes, si está disponible.
FMV admite datos de indicador de objetivos en movimiento de vídeo (VMTI), basados en métodos de seguimiento de objetos de imágenes en movimiento. Si los datos VMTI se registran en un archivo separado del archivo de vídeo asociado, se pueden codificar en el archivo de vídeo con la herramienta Multiplexor de vídeo. FMV admite el estándar de indicador de objetivos en movimiento de vídeo y rastreo de metadatos de MISB.
Codifique los datos de VMTI en el vídeo suministrando la información de VMTI que se requiere en el fotograma de vídeo adecuado mediante el uso de un archivo de metadatos .csv que contiene datos de los campos:
- LDSVer,TimeStamp,FrameCenterLongitude,FrameCenterLatitude,SensorLongitude,SensorLatitude,vmtilocaldataset
- 5,1546300800231000,-76.1309338,36.91118708,-76.1309338,36.91118708,1 0.9938099 1611919 1815608 1711844;1 0.39056745 1438997 1556213 1496645
La última columna, vmtilocaldataset, contienen el cuadro de delimitación del objeto detectado, en el que cada valor delimitado por espacios se define mediante tres valores: Object_ID Confidence_Level Top_Left_Pixel Bottom_Right_Pixel Center_Pixel.
Puede especificar detecciones de objetos múltiples correspondientes a una marca de tiempo determinada con un delimitador ; (punto y coma) como se muestra en el ejemplo anterior.
Utilice MISB Tag 74 en el archivo FMV_Multiplexer_Field_Mapping_Template.csv.
Parámetros
VideoMultiplexer(in_video_file, metadata_file, out_video_file, {metadata_mapping_file}, {timeshift_file}, {elevation_layer})| Nombre | Explicación | Tipo de datos |
in_video_file | Archivo de vídeo de entrada que se convertirá en un archivo de vídeo compatible con FMV. Se admiten los siguientes tipos de archivos de vídeo: .avi, .h264, .h265, .mp2, .mp4, .m2ts, .mpeg, .mpeg2, .mpeg4, .mpg, .mpg2, .mpg4, .ps, .ts y vob. | File |
metadata_file | Archivo de valores separados por comas (CSV) que contiene metadatos sobre los fotogramas de vídeo correspondientes a momentos específicos. Cada columna representa un campo de metadatos y una de las columnas debe ser una referencia de tiempo. La referencia de tiempo es la marca de tiempo Unix (segundos pasados desde 1970) multiplicado por un millón, que se almacena como un entero. El tiempo se almacena como tal para que se pueda hacer referencia a cualquier instante en el tiempo (hasta un millón de segundos) con un entero. Por consiguiente, una diferencia de tiempo entre dos entradas de 500.000 representa una mitad de un segundo en el tiempo transcurrido. La primera fila contiene los nombres de campo correspondientes a las columnas de metadatos. Estos nombres de campo pueden emparejarse con sus nombres de campo correspondientes mediante el uso del archivo FMV_Multiplexer_Field_Mapping_Template.csv si es necesario. Cada fila posterior contiene los valores de metadatos correspondientes al tiempo indicado en el campo de tiempo. La plantilla FMV_Multiplexer_Field_Mapping_Template.csv está en C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo. | File |
out_video_file | Nombre del archivo de vídeo de salida, incluida la extensión del archivo. El archivo de vídeo de salida admitido es .ts solamente. | File |
metadata_mapping_file (Opcional) | Archivo CSV que contiene 5 filas y 87 columnas y se basa en el archivo de plantilla FMV_Multiplexer_Field_Mapping_Template.csv obtenido de C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo. Cada fila representa una de las etiquetas de metadatos de MISB estándar, como latitud del sensor. Las dos primeras columnas contienen el índice MISB y el nombre de etiqueta MISB. La tercera columna contiene el nombre de campo como aparece en el parámetro in_metadata_file, si está presente. Cuando se rellena la tercera columna, la herramienta puede emparejar con los nombres de campos de metadatos con las etiquetas de metadatos FMV adecuadas. La cuarta y la quinta columnas representan las unidades y las notas asociadas con la etiqueta, respectivamente. | File |
timeshift_file (Opcional) | Archivo que contiene intervalos de cambio de tiempo definidos. Lo ideal sería que las imágenes de vídeo y los metadatos se sincronicen en el tiempo. En este caso, la huella de la imagen en el vídeo de movimiento completo rodea las entidades que pueden verse en la imagen de vídeo. A veces se produce una discrepancia entre el tiempo del vídeo y el de los metadatos. Esto genera un retraso aparente entre el momento en que una entidad de suelo está rodeada por la huella de la imagen y el momento en que esa entidad de suelo está visible en la imagen de vídeo. Si este cambio de tiempo es observable y consistente, el multiplexor puede ajustar la cronología de los metadatos para que coincidan con el vídeo. Si se produce una discrepancia entre el tiempo del vídeo y los metadatos, especifique el cambio de tiempo en la plantilla FMV_Multiplexer_TimeShift_Template.csv de C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo. El archivo de observación de cambio de tiempo es un archivo CSV que contiene dos columnas (elapsed time y time shift) y una o varias filas de datos. Es opcional tener una fila para nombres de columna. Por ejemplo, si la imagen de vídeo tiene un retraso de 5 segundos durante todo el tiempo, el archivo de observación de cambio de tiempo tendrá una línea: 0:00, -5. El vídeo entero se desplaza 5 segundos. Cuando se produce un retraso de 5 segundos en la marca 0:18 del vídeo y un retraso de 9 segundos en la marca 2:21 del vídeo, el archivo de observación de cambio de tiempo tendrá las dos líneas siguientes: En este caso, el vídeo cambia de manera diferente al principio y al final. Puede definir cualquier cantidad de intervalos de cambio de tiempo en el archivo de observación de cambio de tiempo. | File |
elevation_layer (Opcional) | Fuente de la elevación necesaria para calcular las coordenadas de las esquinas del fotograma de vídeo. La fuente puede ser una capa, un servicio de imágenes o la elevación media del suelo o la profundidad del océano. El valor de elevación media debe incluir unidades de medida como metros o pies, o cualquier medida de longitud. La precisión de la huella de vídeo y el centro del fotograma depende de la precisión de la fuente de datos de DEM proporcionada. Se recomienda proporcionar una capa DEM o un servicio de imágenes. Si no tiene acceso a los datos de DEM, puede introducir la elevación media y la unidad relativa al nivel del mar, como 15 pies o 10 metros. En el caso de un submarino, pueden introducir -15 pies o -10 metros. Usar la elevación media o la profundidad oceánica no es tan exacto como proporcionar datos de DEM o batimétricos. Para calcular las coordenadas de las esquinas del fotograma, el valor de elevación media siempre debe menor que la altitud o la profundidad del sensor según se registra en los metadatos. Por ejemplo, si el vídeo se ha filmado a la altitud de un sensor de 10 metros o más, una elevación media válida podría ser 9 metros o menos. Si el vídeo se ha filmado bajo el agua a una profundidad de -10 metros o más, la elevación media válida (con respecto al nivel del mar) podría ser -11 o más. Si el valor de Altitud del sensor es menor que el valor de elevación media, no se calcularán las coordenadas de las cuatro esquinas correspondientes a ese registro. Si no conoce la elevación media del área del proyecto, utilice un DEM. | Raster Layer; Image Service; Linear Unit |
Muestra de código
En este ejemplo se crea un archivo de vídeo que combina una archivo archivado y los metadatos relacionados.
arcpy.ia.VideoMultiplexer(r"C:\input_video.mpeg", r"C:\video_metadata.csv", r"C:\output_video.ts",
r"C:\Video_Multiplexer_MISB_Field_Mapping_Template.csv",
r"C:\Video_Multiplexer_TimeShift_Template.csv", "c:\\test\\dem.tif”)En este ejemplo se crea un archivo de vídeo que combina una archivo archivado y los metadatos relacionados.
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.ts"
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)