| 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. Los siguientes tipos de archivo son compatibles: .avi, .csv, .gpx, .h264, .h265, .json, .mp2, .mp4, .m2ts, .mpeg, .mpeg2, .mpeg4, .mpg, .mpg2, .mpg4, .ps, .ts y .vob. | File |
Archivo de metadatos | Una archivo .csv, .json o .gpx que contiene metadatos sobre los fotogramas de vídeo para momentos específicos. Cada columna del archivo de metadatos representa un campo de metadatos, y una de las columnas debe ser una referencia temporal. La referencia de tiempo es la marca de tiempo UNIX (segundos desde 1970) multiplicada por un millón, que se almacena como un número entero. El tiempo se almacena de esta forma para que cualquier instante en el tiempo (hasta una millonésima de segundo) pueda referenciarse con un número entero. En consecuencia, una diferencia de tiempo entre dos entradas de 500.000 representa la mitad de un segundo en el tiempo transcurrido. La primera fila contiene los nombres de campo de las columnas de metadatos. Estos nombres de campo se enumeran en el archivo FMV_Multiplexer_Field_Mapping_Template.csv en C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo o los nombres de campo personalizados se pueden hacer coincidir con sus nombres de campo FMV correspondientes mediante la plantilla. Cada fila posterior contiene los valores de metadatos para una hora específica, denominada marca de tiempo. Los nombres de campo de metadatos pueden estar en cualquier orden y deben tener exactamente el mismo nombre que se indica en la plantilla FMV_Multiplexer_Field_Mapping_Template.csv para asignar los nombres de campo de metadatos a los nombres de campo de metadatos de 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 un archivo .ts. | File |
Archivo de asignación de metadatos (Opcional) | Un archivo .csv que contiene 5 columnas y 87 filas y que 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 proporcionado en el formulario. La tercera columna contiene el nombre de campo tal como aparece en el parámetro Archivo de metadatos de entrada. Cuando se rellena la tercera columna, la herramienta puede hacer coincidir los nombres de campo de metadatos con las etiquetas de metadatos adecuadas de FMV. | File |
Archivo de desplazamiento de tiempo (Opcional) | Archivo que contiene intervalos de cambio de tiempo definidos. Lo ideal es que las imágenes de vídeo y los metadatos se sincronicen en el tiempo. En este caso, la huella de la imagen en FMV rodea las entidades que pueden verse en la imagen de vídeo. A veces existe una falta de coincidencia entre la cronología del vídeo y la cronología de los metadatos. Esto da lugar a un retraso aparente de tiempo entre cuando una entidad de terreno está rodeada por la huella de imagen y el momento en que esa entidad de terreno es visible en la imagen del vídeo. Si este cambio de tiempo es observable y consistente, el multiplexador puede ajustar la cronología de los metadatos para que coincidan con el vídeo. Si existe una falta de coincidencia entre la cronología del vídeo y los metadatos, especifique el cambio de tiempo en la plantilla FMV_Multiplexer_TimeShift_Template.csv en 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. Una fila para los nombres de columnas es opcional. 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 forma distinta al principio del vídeo y al final del vídeo. Puede definir cualquier número de intervalos de cambio de tiempo en el archivo de observaciones de cambio de tiempo. | File |
Modelo digital de elevación (Opcional) | Origen de la elevación necesaria para calcular las coordenadas de la esquina del cuadro del vídeo. El origen puede ser una capa, un servicio de imágenes o una elevación media del terreno o una profundidad del océano. El valor medio de elevación debe incluir las unidades de medida, tales como metros, pies u otra medida de longitud. La precisión de la huella de vídeo y del centro del cuadro depende de la precisión de la fuente de datos DEM proporcionada. Se recomienda que proporcione una capa DEM o un servicio de imágenes. Si no tiene acceso a los datos de DEM, puede proporcionar 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, por ejemplo. El uso de una elevación media o una profundidad del océano no es tan preciso como proporcionar un DEM o datos batimétricos. Para calcular las coordenadas de la esquina del cuadro, el valor de elevación medio debe ser siempre menor que la altitud o la profundidad del sensor según se registra en los metadatos. Por ejemplo, si el vídeo se graba a una altitud de sensor de 10 metros o más, una elevación media válida podría ser de 9 metros o menos. Si un vídeo se graba bajo el agua a una profundidad de -10 metros o más, la elevación media válida (relativa al nivel del mar) podría ser -11 o una profundidad mayor. Si el valor de Altitud del sensor es menor que el valor de elevación promedio, las cuatro coordenadas de esquina no se calcularán para ese registro. Si no conoce la elevación media del área del proyecto, utilice un DEM. | Raster Layer; Image Service; Linear Unit |
Sistema de coordenadas de entrada (Opcional) | El sistema de coordenadas que se utilizará para el valor del parámetro Archivo de metadatos. | Coordinate System |
Disponible con licencia de Image Analyst.
Resumen
Crea un único archivo de vídeo compatible con Full Motion Video (FMV) que combina un archivo de transmisión de vídeo archivado y un archivo separado de metadatos asociado sincronizado por una marca de tiempo. El proceso de combinar los dos archivos que contienen el vídeo y los metadatos se denomina multiplexado.
Uso
Esta herramienta se ha diseñado 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), JSON o formato de intercambio de GPS (GPX) que contiene los encabezados de campo adecuados y valores asociados.
Los formatos de vídeo admitidos como entrada de la herramienta se enumeran en la siguiente tabla:
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 solamente .ts.
Los metadatos asociados al archivo de transmisión de vídeo se utilizan para calcular la ruta de vuelo del sensor de vídeo, el centro del cuadro de la imagen de vídeo y las cuatro esquinas de la huella del cuadro de vídeo en el 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 requeridos para FMV. Los parámetros MISB proporcionados se codificarán en el vídeo final, incluidos todos los parámetros o un subconjunto de ellos.
Para calcular y visualizar los puntos de esquina relativos de la huella de 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 más 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 se puede visualizar 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 el archivo de 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 MISB.
- Solo se necesitan los 12 parámetros definidos anteriormente para crear el archivo de vídeo compatible con FMV. No es necesario que proporcione todos los parámetros definidos en la especificación MISB para crear un archivo de vídeo compatible con FMV. Si se proporcionan otros parámetros MISB, 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 FMV_Multiplexer_Field_Mapping_Template.csv solo contiene los campos UNIX Time Stamp, Sensor Latitude y Sensor Longitude, se mostrará la ubicación del sensor en el mapa, pero la huella de los cuadros de vídeo no se mostrará. Algunas funcionalidades, como la digitalización de entidades y la medición de distancias dentro del vídeo, no se admitirán.
- 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 en C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo para ajustar el tiempo del vídeo y los metadatos.
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 proporcionan las cuatro coordenadas del mapa de esquina, se utilizarán para crear el vídeo compatible con FMV. Si no se proporcionan las cuatro coordenadas del mapa de esquina, proporcione una fuente para los datos DEM en el parámetro Modelo digital de elevación y la herramienta calculará la huella del vídeo a partir de los parámetros requeridos que se enumeraron anteriormente.
La precisión de la huella de vídeo y del centro del cuadro depende de la precisión de la fuente de datos DEM proporcionada. Si no tiene acceso a los datos de DEM, puede proporcionar 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, por ejemplo. El uso de una elevación media o una profundidad del océano no es tan preciso como proporcionar un DEM o datos batimétricos. Se recomienda que proporcione una capa DEM o un servicio de imágenes si están disponibles.
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 es compatible con el estándar MISB Indicador de objetivos en movimiento de vídeo y metadatos de seguimiento.
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, .json o .gpx 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, contiene el cuadro de delimitación del objeto detectado, donde 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 de 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}, {input_coordinate_system})| 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. Los siguientes tipos de archivo son compatibles: .avi, .csv, .gpx, .h264, .h265, .json, .mp2, .mp4, .m2ts, .mpeg, .mpeg2, .mpeg4, .mpg, .mpg2, .mpg4, .ps, .ts y .vob. | File |
metadata_file | Una archivo .csv, .json o .gpx que contiene metadatos sobre los fotogramas de vídeo para momentos específicos. Cada columna del archivo de metadatos representa un campo de metadatos, y una de las columnas debe ser una referencia temporal. La referencia de tiempo es la marca de tiempo UNIX (segundos desde 1970) multiplicada por un millón, que se almacena como un número entero. El tiempo se almacena de esta forma para que cualquier instante en el tiempo (hasta una millonésima de segundo) pueda referenciarse con un número entero. En consecuencia, una diferencia de tiempo entre dos entradas de 500.000 representa la mitad de un segundo en el tiempo transcurrido. La primera fila contiene los nombres de campo de 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 en C:\Program Files\ArcGIS\Pro\Resources\FullMotionVideo si es necesario. Cada fila posterior contiene los valores de metadatos para la hora indicada en el campo de tiempo. | 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 un archivo .ts. | File |
metadata_mapping_file (Opcional) | Un archivo .csv que contiene 5 columnas y 87 filas y que 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 MISB estándar, como la latitud del sensor. Las primeras dos columnas contienen el índice MISB y el nombre de etiqueta MISB. La tercera columna contiene el nombre de campo tal y como aparece en el parámetro in_metadata_file si está presente. Cuando se rellena la tercera columna, la herramienta puede hacer coincidir los nombres de campo de metadatos con las etiquetas de metadatos adecuadas de FMV. La cuarta y quinta columnas representan las unidades y las notas asociadas a la etiqueta, respectivamente. | File |
timeshift_file (Opcional) | Archivo que contiene intervalos de cambio de tiempo definidos. Lo ideal es que las imágenes de vídeo y los metadatos se sincronicen en el tiempo. En este caso, la huella de la imagen en FMV rodea las entidades que pueden verse en la imagen de vídeo. A veces existe una falta de coincidencia entre la cronología del vídeo y la cronología de los metadatos. Esto da lugar a un retraso aparente de tiempo entre cuando una entidad de terreno está rodeada por la huella de imagen y el momento en que esa entidad de terreno es visible en la imagen del vídeo. Si este cambio de tiempo es observable y consistente, el multiplexador puede ajustar la cronología de los metadatos para que coincidan con el vídeo. Si existe una falta de coincidencia entre la cronología del vídeo y los metadatos, especifique el cambio de tiempo en la plantilla FMV_Multiplexer_TimeShift_Template.csv en 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. Una fila para los nombres de columnas es opcional. 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 forma distinta al principio del vídeo y al final del vídeo. Puede definir cualquier número de intervalos de cambio de tiempo en el archivo de observaciones de cambio de tiempo. | File |
elevation_layer (Opcional) | Origen de la elevación necesaria para calcular las coordenadas de la esquina del cuadro del vídeo. El origen puede ser una capa, un servicio de imágenes o una elevación media del terreno o una profundidad del océano. El valor medio de elevación debe incluir las unidades de medida, tales como metros, pies u otra medida de longitud. La precisión de la huella de vídeo y del centro del cuadro depende de la precisión de la fuente de datos DEM proporcionada. Se recomienda que proporcione una capa DEM o un servicio de imágenes. Si no tiene acceso a los datos de DEM, puede proporcionar 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, por ejemplo. El uso de una elevación media o una profundidad del océano no es tan preciso como proporcionar un DEM o datos batimétricos. Para calcular las coordenadas de la esquina del cuadro, el valor de elevación medio debe ser siempre menor que la altitud o la profundidad del sensor según se registra en los metadatos. Por ejemplo, si el vídeo se graba a una altitud de sensor de 10 metros o más, una elevación media válida podría ser de 9 metros o menos. Si un vídeo se graba bajo el agua a una profundidad de -10 metros o más, la elevación media válida (relativa al nivel del mar) podría ser -11 o una profundidad mayor. Si el valor de Altitud del sensor es menor que el valor de elevación promedio, las cuatro coordenadas de esquina no se calcularán para ese registro. Si no conoce la elevación media del área del proyecto, utilice un DEM. | Raster Layer; Image Service; Linear Unit |
input_coordinate_system (Opcional) | El sistema de coordenadas que se utilizará para el valor del parámetro metadata_file. | Coordinate System |
Muestra de código
En este ejemplo se crea un archivo de vídeo que combina un vídeo archivado y 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 un vídeo archivado y 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)Entornos
Información de licenciamiento
- Basic: Requiere Image Analyst
- Standard: Requiere Image Analyst
- Advanced: Requiere Image Analyst