Multiplexor de vídeo (Image Analyst)

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 único 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 los dos archivos que contienen el vídeo y los metadatos se denomina multiplexado.

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 los valores asociados.

  • Los formatos de vídeo admitidos como entrada de la herramienta se enumeran en la siguiente tabla:

    DescripciónExtensión

    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 medios VLC (mpeg4)

    .mpeg4

    Archivo de medios VLC (vob)

    .vob

    HLS (velocidad de bits adaptable [ABR])

    .m3u8

  • 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 se pueden introducir en la plantilla de metadatos, FMV_Multiplexer_Field_Mapping_Template.csv, en 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 para ajustar la cronología 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 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 DEM, puede introducir una elevación media y una unidad en relación con el nivel del mar, como 15 pies o 10 metros. En el caso de un sumergible, puede introducir -15 pies o -10 metros. 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 VMTI en el vídeo proporcionando la información de VMTI necesaria para el cuadro de vídeo adecuado mediante un archivo de metadatos .csv que contiene los 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 varias detecciones de objetos para 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

EtiquetaExplicaciónTipo 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 (admite H.264, no H.265), .h264, .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 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 único archivo de vídeo de salida admitido es .ts.

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 establece una referencia cruzada entre el nombre de campo de metadatos y el nombre de campo FMV. Cada fila representa uno de los parámetros de metadatos estándar, como la latitud del sensor. Las primeras dos columnas contienen la información para la etiqueta y el nombre del parámetro MISB ya 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. Si este es el caso, la huella de imagen con Full Motion Video rodea entidades que se pueden ver 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 observaciones de cambio de tiempo es un archivo CSV que contiene dos columnas (elapsed time y time shift) y una o más filas de datos. Una fila para los nombres de columnas es opcional.

Por ejemplo, si la imagen de vídeo tiene un retardo de 5 segundos durante todo el tiempo, el archivo de observaciones de cambio de tiempo tendrá una línea: 0:00, -5. Todo el vídeo cambia 5 segundos.

Si hay un retardo de 5 segundos en la marca 0:18 del vídeo y un retardo de 9 segundos en la marca 2:21 del vídeo, el archivo de observaciones de cambio de tiempo tendrá las dos líneas siguientes:

0:18, -5
2:21, -9

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 DEM, puede introducir una elevación media y una unidad en relación con el nivel del mar, como 15 pies o 10 metros. En el caso de un sumergible, puede introducir -15 pies o -10 metros. 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

VideoMultiplexer(in_video_file, metadata_file, out_video_file, {metadata_mapping_file}, {timeshift_file}, {elevation_layer})
NombreExplicaciónTipo 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 (admite H.264, no H.265), .h264, .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 de las columnas de metadatos. Estos nombres de campo pueden coincidir con sus correspondientes nombres de campo utilizando el archivo FMV_Multiplexer_Field_Mapping_Template.csv si es necesario. Cada fila posterior contiene los valores de metadatos para la hora indicada 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 único archivo de vídeo de salida admitido es .ts.

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 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. Si este es el caso, la huella de imagen con Full Motion Video rodea entidades que se pueden ver 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 observaciones de cambio de tiempo es un archivo CSV que contiene dos columnas (elapsed time y time shift) y una o más filas de datos. Una fila para los nombres de columnas es opcional.

Por ejemplo, si la imagen de vídeo tiene un retardo de 5 segundos durante todo el tiempo, el archivo de observaciones de cambio de tiempo tendrá una línea: 0:00, -5. Todo el vídeo cambia 5 segundos.

Si hay un retardo de 5 segundos en la marca 0:18 del vídeo y un retardo de 9 segundos en la marca 2:21 del vídeo, el archivo de observaciones de cambio de tiempo tendrá las dos líneas siguientes:

0:18, -5
2:21, -9

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 DEM, puede introducir una elevación media y una unidad en relación con el nivel del mar, como 15 pies o 10 metros. En el caso de un sumergible, puede introducir -15 pies o -10 metros. 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

Muestra de código

Ejemplo 1 de VideoMultiplexer (ventana de Python)

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”)
Ejemplo 2 de VideoMultiplexer (script independiente)

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

Esta herramienta no utiliza ningún entorno de geoprocesamiento.