Métadonnées vidéo vers classe d’entités (Outils Image Analyst)

Résumé

Extrait un ou la totalité des éléments suivants d’une vidéo géospatiale avec les métadonnées correctes : la position de la plateforme, le centre de l’image, le contour de l’image et les métadonnées de la vidéo. La géométrie et les attributs en sortie sont enregistrés sous forme de classes d’entités.

Utilisation

Cet outil exporte les métadonnées vidéo en tant que classes d’entités, avec toutes les métadonnées sous forme de champs dans une table attributaire. Ces entités peuvent être utilisées pour la position de la plateforme, le contour de l’image vidéo et le centre de l’image vidéo afin de vérifier que la couverture des données est correcte et d’exécuter des requêtes spatiales et attributaires, et ainsi de trouver rapidement des images vidéo pertinentes.
Cet outil fonctionne uniquement avec des fichiers vidéo archivés. Les flux vidéo en direct ne sont pas pris en charge.
Un fichier vidéo compatible avec les métadonnées doit être utilisé en entrée. L’exécution de l’outil échoue s’il n’y a pas de métadonnées dans le flux de la vidéo.
L’outil peut comporter cinq types de sortie et vous devez en spécifier au moins un. L’outil échouera si les cinq sorties sont laissées vides.

Etiqueter	Explication	Type de données
Vidéo en entrée	Fichier vidéo en entrée compatible avec des métadonnées contenant des métadonnées essentielles pour chaque image des données vidéo. Les types de fichier vidéo pris en charge sont `.av1`, `.m2ts`, `.mkv`, `.mov`, `.mp2`, `.mp4`, `.mpeg`, `.mpeg2`, `.mpeg4`, `.mpg`, `.mpg2`, `.mpg4`, `.ps`, `.ts`, `.vob` et `.wmv`.	File
Fichier de métadonnées en sortie (Facultatif)	Fichier `.csv` ou `.json` en sortie contenant des métadonnées relatives aux images vidéo pendant des durées spécifiques. Le format du fichier de métadonnées est le même que celui utilisé par l’outil Video Multiplexer (Multiplexeur vidéo).	File
Classe d’entités de trajectoire de vol en sortie (Facultatif)	Classe d’entités contenant les informations sur la trajectoire de vol de la plateforme.	Feature Class
Type de classe d’entités de trajectoire de vol (Facultatif)	Définit le type de classe d’entités à utiliser pour la trajectoire de vol. Point—Une classe d’entités ponctuelles est utilisée pour la trajectoire de vol. Polyligne—Une classe d’entités polylignes est utilisée pour la trajectoire de vol. Il s’agit de l’option par défaut.	String
Classe d’entités de chemin d’accès à l’image en sortie (Facultatif)	Classe d’entités en sortie contenant les informations sur le chemin d’accès à l’image.	Feature Class
Type de classe d’entités de chemin d’accès à l’image (Facultatif)	Définit le type de classe d’entités à utiliser pour le chemin d’accès à l’image. Si vous utilisez une sortie ponctuelle, le centre de chaque image vidéo apparaît sur la carte. Point—Une classe d’entités ponctuelles est utilisée pour le chemin d’accès à l’image. Polyligne—Une classe d’entités polylignes est utilisée pour le chemin d’accès à l’image. Il s’agit de l’option par défaut.	String
Classe d’entités d’emprise d’image en sortie (Facultatif)	Classe d’entités en sortie contenant les informations sur l’emprise de l’image vidéo	Feature Class
Heure de début de la capture des métadonnées (Facultatif)	Heure de début d’enregistrement des métadonnées à partir du début de la vidéo. Le format en entrée est j.hh:mm:ss, et l’heure de début par défaut est 0.00:00:00. Les horodatages des métadonnées ne sont pas utilisés dans ce champ ; c’est l’heure du fichier vidéo qui est utilisée.	Time Unit; Date
Heure d’arrêt de la capture des métadonnées (Facultatif)	Heure de fin d’enregistrement des métadonnées. Le format en entrée est j.hh:mm:ss. Si cette valeur n’est pas renseignée, la valeur par défaut est la fin de la vidéo. Les horodatages des métadonnées ne sont pas utilisés dans ce champ.	Time Unit; Date
Distance minimale entre les entités (Facultatif)	Distance entre les entités dans les images vidéo séquentielles. Si cette valeur n’est pas renseignée, chaque entité de métadonnées est extraite et ajoutée à la classe d’entités.	Linear Unit
Temps minimal entre les entités (Facultatif)	Intervalle temporel entre les entités dans les images vidéo séquentielles. Si cette valeur n’est pas renseignée, chaque entité de métadonnées est extraite et ajoutée à la classe d’entités.	Time Unit
Jeu de classes d’entités VMTI en sortie (Facultatif)	Jeu de classes d’entités en sortie contenant les informations VMTI de la vidéo.	Feature Dataset

VideoMetadataToFeatureClass(in_video, {csv_file}, {flightpath}, {flightpath_type}, {imagepath}, {imagepath_type}, {footprint}, {start_time}, {stop_time}, {min_distance}, {min_time}, {vmti})

Nom	Explication	Type de données
in_video	Fichier vidéo en entrée compatible avec des métadonnées contenant des métadonnées essentielles pour chaque image des données vidéo. Les types de fichier vidéo pris en charge sont `.av1`, `.m2ts`, `.mkv`, `.mov`, `.mp2`, `.mp4`, `.mpeg`, `.mpeg2`, `.mpeg4`, `.mpg`, `.mpg2`, `.mpg4`, `.ps`, `.ts`, `.vob` et `.wmv`.	File
csv_file (Facultatif)	Fichier `.csv` ou `.json` en sortie contenant des métadonnées relatives aux images vidéo pendant des durées spécifiques. Le format du fichier de métadonnées est le même que celui utilisé par l’outil Video Multiplexer (Multiplexeur vidéo).	File
flightpath (Facultatif)	Classe d’entités contenant les informations sur la trajectoire de vol de la plateforme.	Feature Class
flightpath_type (Facultatif)	Définit le type de classe d’entités à utiliser pour la trajectoire de vol. `POINT`—Une classe d’entités ponctuelles est utilisée pour la trajectoire de vol. `POLYLINE`—Une classe d’entités polylignes est utilisée pour la trajectoire de vol. Il s’agit de l’option par défaut.	String
imagepath (Facultatif)	Classe d’entités en sortie contenant les informations sur le chemin d’accès à l’image.	Feature Class
imagepath_type (Facultatif)	Définit le type de classe d’entités à utiliser pour le chemin d’accès à l’image. Si vous utilisez une sortie ponctuelle, le centre de chaque image vidéo apparaît sur la carte. `POINT`—Une classe d’entités ponctuelles est utilisée pour le chemin d’accès à l’image. `POLYLINE`—Une classe d’entités polylignes est utilisée pour le chemin d’accès à l’image. Il s’agit de l’option par défaut.	String
footprint (Facultatif)	Classe d’entités en sortie contenant les informations sur l’emprise de l’image vidéo	Feature Class
start_time (Facultatif)	Heure de début d’enregistrement des métadonnées à partir du début de la vidéo. Le format en entrée est j.hh:mm:ss, et l’heure de début par défaut est 0.00:00:00. Les horodatages des métadonnées ne sont pas utilisés dans ce champ ; c’est l’heure du fichier vidéo qui est utilisée.	Time Unit; Date
stop_time (Facultatif)	Heure de fin d’enregistrement des métadonnées. Le format en entrée est j.hh:mm:ss. Si cette valeur n’est pas renseignée, la valeur par défaut est la fin de la vidéo. Les horodatages des métadonnées ne sont pas utilisés dans ce champ.	Time Unit; Date
min_distance (Facultatif)	Distance entre les entités dans les images vidéo séquentielles. Si cette valeur n’est pas renseignée, chaque entité de métadonnées est extraite et ajoutée à la classe d’entités.	Linear Unit
min_time (Facultatif)	Intervalle temporel entre les entités dans les images vidéo séquentielles. Si cette valeur n’est pas renseignée, chaque entité de métadonnées est extraite et ajoutée à la classe d’entités.	Time Unit
vmti (Facultatif)	Jeu de classes d’entités en sortie contenant les informations VMTI de la vidéo.	Feature Dataset

Exemple de code

Exemple 1 d’utilisation de la fonction VideoMetadataToFeatureClass (fenêtre Python)

Dans cet exemple, l’outil extrait et enregistre les métadonnées de la plateforme, du centre de l’image, du contour de l’image et des attributs d’une vidéo compatible avec 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")

Exemple 2 d’utilisation de la fonction VideoMetadataToFeatureClass (script autonome)

Dans cet exemple, l’outil extrait et enregistre les métadonnées de la plateforme, du centre de l’image, du contour de l’image et des attributs d’une vidéo compatible avec FMV.

import arcpy

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)

Environnements

La sortie comporte des valeurs Z

Informations de licence