Extraire des images vidéo en images (Image Analyst)

Disponible avec une licence Image Analyst.

Synthèse

Extrait les images vidéo et les métadonnées associées d’un flux vidéo compatible FMV. Il est possible d’ajouter les images extraites à un jeu de données mosaïque ou à d’autres outils et fonctions en vue d’une analyse approfondie.

Utilisation

  • Cet outil fonctionne uniquement avec des données vidéo archivées. Les flux vidéo en direct ne sont pas pris en charge.

  • Les images d’un flux vidéo compatible FMV sont extraites et stockées dans un répertoire au format TIFF, NITF ou JPEG.

  • Les métadonnées associées à l’imagerie vidéo sont écrites dans un fichier à valeurs séparées par des virgules (.csv) dans le même répertoire.

Paramètres

ÉtiquetteExplicationType de données
Fichier vidéo en entrée

Fichier vidéo en entrée dans l’un des formats de fichier vidéo pris en charge suivants : PS, TS, MPG, MPEG, MP2, MPG2, MPEG2, MP4, MPG4, MPEG4, H264, H265, VOB et M2TS.

File
Dossier en sortie

Répertoire de fichiers dans lequel les images et les métadonnées en sortie sont enregistrées.

Folder
Type d’image
(Facultatif)

Spécifie le format des images en sortie.

  • JPEGLes images en sortie sont au format JPEG.
  • TIFFLes images en sortie sont au format TIFF. Il s’agit de l’option par défaut.
  • NITFLes images en sortie sont au format NITF.
  • PNGLes images en sortie sont au format PNG.
String
Pourcentage de superposition maximal
(Facultatif)

Pourcentage de superposition maximal entre deux images. Si la superposition entre une image candidate et la dernière image écrite sur le disque est supérieure à cette valeur, l’image candidate est ignorée. Le pourcentage par défaut est de 100 %, ce qui revient à écrire toutes les images sur le disque.

Double
Nouvelles métadonnées requises
(Facultatif)

Indique si les images vidéo avec des métadonnées associées sont extraites et enregistrées.

  • Activé – Seules les images vidéo avec des métadonnées associées sont enregistrées.
  • Désactivé – Toutes les images vidéo sont enregistrées. Il s’agit de l’option par défaut.
Boolean
Temps minimal entre les entités
(Facultatif)

Intervalle temporel minimal entre les images vidéo à enregistrer. Si aucune valeur n’est indiquée, toutes les images vidéo sont enregistrées en tant qu’images.

Time Unit

ExtractVideoFramesToImages(in_video, out_folder, {image_type}, {image_overlap}, {require_fresh_metadata}, {min_time})
NomExplicationType de données
in_video

Fichier vidéo en entrée dans l’un des formats de fichier vidéo pris en charge suivants : PS, TS, MPG, MPEG, MP2, MPG2, MPEG2, MP4, MPG4, MPEG4, H264, H265, VOB et M2TS.

File
out_folder

Répertoire de fichiers dans lequel les images et les métadonnées en sortie sont enregistrées.

Folder
image_type
(Facultatif)

Spécifie le format des images en sortie.

  • JPEGLes images en sortie sont au format JPEG.
  • TIFFLes images en sortie sont au format TIFF. Il s’agit de l’option par défaut.
  • NITFLes images en sortie sont au format NITF.
  • PNGLes images en sortie sont au format PNG.
String
image_overlap
(Facultatif)

Pourcentage de superposition maximal entre deux images. Si la superposition entre une image candidate et la dernière image écrite sur le disque est supérieure à cette valeur, l’image candidate est ignorée. Le pourcentage par défaut est de 100 %, ce qui revient à écrire toutes les images sur le disque.

Double
require_fresh_metadata
(Facultatif)

Indique si les images vidéo avec des métadonnées associées sont extraites et enregistrées.

  • REQUIRE_FRESH_METADATASeules les images vidéo avec des métadonnées associées sont enregistrées.
  • NO_REQUIRE_FRESH_METADATAToutes les images vidéo sont enregistrées. Il s’agit de l’option par défaut.
Boolean
min_time
(Facultatif)

Intervalle temporel minimal entre les images vidéo à enregistrer. Si aucune valeur n’est indiquée, toutes les images vidéo sont enregistrées en tant qu’images.

Time Unit

Exemple de code

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

Cet exemple extrait les images vidéo et les métadonnées associées d’un flux vidéo et enregistre les données dans un répertoire.

arcpy.ia.ExtractVideoFramesToImages(r"c:\test\video.ts", r"C:\temp2\outimages",
"TIFF", 100, "", "20 Seconds")
Exemple 2 d’utilisation de la fonction ExtractVideoFramesToImages (script autonome)

Cet exemple extrait les images vidéo et les métadonnées associées d’un flux vidéo et enregistre les données dans un répertoire.

import arcpy
from arcpy.ia import *

arcpy.CheckOutExtension("ImageAnalyst")

in_video = "c:\\test\\drone_vid.ts"
out_folder = "c:\\output"
outformat = "NITF"
maxoverlap = 100
requirefreshmeta = “REQUIRE_FRESH_METADATA” 
mintimebetween = "1 minute"


arcpy.ia.ExtractVideoFramesToImages(in_video, out_folder, outformat, maxoverlap,
requirefreshmeta, mintimebetween)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Rubriques connexes