Ajouter des images au jeu de données d’imagerie orientée (Imagerie orientée)

Synthèse

Ajoute des images à un jeu de données d’imagerie orientée à partir de plusieurs sources en entrée, notamment un fichier, un dossier, une table, une liste de chemins d’accès aux images ou une couche d’entités ponctuelles.

Utilisation

  • Les images qui sont ajoutées ne sont pas gérées par le jeu de données d’imagerie orientée. Le jeu de données pointe sur l’emplacement de stockage des images. Si une image est supprimée ou déplacée, elle n’est pas chargée dans la visionneuse d’imagerie orientée.

  • En fonction de la valeur du paramètre Données en entrée, l’outil identifie les métadonnées requises pour le chargement de données dans le jeu de données d’imagerie orientée. Les fonctions d’imagerie orientée dépendent des informations de métadonnées.

  • Toutes les options de données en entrée prennent en charge le format JPEG. Dans les cas suivants, les images doivent être ajoutées avec un fichier .csv respectant la structure de la table de l’imagerie orientée, une couche d’entités respectant la structure de la table attributaire de l’imagerie orientée ou une couche d’imagerie orientée :

    • L’image est au format TIF ou MRF.
    • Les métadonnées d’image sont stockées séparément des fichiers image ou doivent être mises à jour avant d’être ajoutées.
    • Vous incluez l’orientation de la caméra, ce qui permet de réaliser des transformations de type image vers sol et sol vers image plus précises.

  • Si des données sont ajoutées directement à partir de fichiers image, d’un dossier contenant des images ou d’un fichier texte avec une liste de chemins d’accès aux images, les informations de métadonnées sont extraites des données EXIF et XMP des images. Au minimum, les données EXIF doivent contenir des informations de localisation géographique.

Paramètres

ÉtiquetteExplicationType de données
Jeu de données d’imagerie orientée

Chemin d’accès et nom du jeu de données d’imagerie orientée où les images sont ajoutées.

Oriented Imagery Layer
Catégorie d’imagerie

Spécifie le type des images en entrée à utiliser et définit les propriétés par défaut du jeu de données d’imagerie orientée. La propriété par défaut est utilisée si l’attribut équivalent est introuvable dans la table attributaire du jeu de données d’imagerie orientée.

  • Horizontal : les images dans lesquelles l’exposition est parallèle au sol et dirigée vers l’horizon sont utilisées.
  • Oblique : les images dans lesquelles l’exposition se trouve à un angle par rapport au sol, généralement à environ 45 degrés, de sorte que les côtés des objets sont visibles, sont utilisées.
  • Nadir : les images dans lesquelles l’exposition est perpendiculaire au sol et dirigée directement vers le bas sont utilisées. Seule la partie supérieure des objets est visible.
  • 360 : les images prises à l’aide de caméras spécialisées qui fournissent des vues d’habillage sphériques à 360 degrés ou qui ont été assemblées en tant que vues à 360 degrés à partir de plusieurs caméras sont utilisées.
  • Inspection : l’imagerie en gros plan des ressources (à moins de 5 mètres de la caméra) est utilisée.
String
Données en entrée

Chemin d’accès et nom des données en entrée. Les produits suivants sont pris en charge :

Folder; Oriented Imagery Layer; Table; Raster Layer; File
Inclure les sous-dossiers
(Facultatif)

Indique si les sous-dossiers sont explorés de manière récursive.

  • Activé : des données sont recherchées de manière récursive dans tous les sous-dossiers. Il s’agit de l’option par défaut.
  • Désactivé - Les données sont recherchées uniquement dans le dossier de niveau supérieur.
Boolean
Filtre des dossiers en entrée
(Facultatif)

Expression permettant de filtrer et d’ajouter des images dans le dossier en entrée.

Par exemple, pour ajouter uniquement des images contenant une chaîne en particulier, ajoutez les symboles de pourcentage avant et après la valeur de chaîne (%value%).

String
Filtre des tables en entrée
(Facultatif)

Expression SQL utilisée pour sélectionner un sous-ensemble d’enregistrements. Pour plus d’informations sur la syntaxe SQL reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.

SQL Expression
Inclure tous les champs de la table en entrée
(Facultatif)

Spécifie si tous les champs de la table en entrée, à part la structure requise, sont ajoutés dans la table attributaire du jeu de données.

Désactivé : seuls les champs spécifiques à la structure de l’imagerie orientée sont ajoutées dans la table attributaire du jeu de données. Il s’agit de l’option par défaut.

Activé : tous les champs de la table en entrée sont ajoutés dans la table attributaire du jeu de données.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Jeu de données d’imagerie orientée mis à jour

Jeu de données d’imagerie orientée mis à jour.

Oriented Imagery Layer

arcpy.management.AddImagesToOrientedImageryDataset(in_oriented_imagery_dataset, imagery_category, input_data, {include_sub_folders}, {folder_filter}, {where_clause}, {include_all_fields})
NomExplicationType de données
in_oriented_imagery_dataset

Chemin d’accès et nom du jeu de données d’imagerie orientée où les images sont ajoutées.

Oriented Imagery Layer
imagery_category

Spécifie le type des images en entrée à utiliser et définit les propriétés par défaut du jeu de données d’imagerie orientée. La propriété par défaut est utilisée si l’attribut équivalent est introuvable dans la table attributaire du jeu de données d’imagerie orientée.

  • Horizontal : les images dans lesquelles l’exposition est parallèle au sol et dirigée vers l’horizon sont utilisées.
  • Oblique : les images dans lesquelles l’exposition se trouve à un angle par rapport au sol, généralement à environ 45 degrés, de sorte que les côtés des objets sont visibles, sont utilisées.
  • Nadir : les images dans lesquelles l’exposition est perpendiculaire au sol et dirigée directement vers le bas sont utilisées. Seule la partie supérieure des objets est visible.
  • 360 : les images prises à l’aide de caméras spécialisées qui fournissent des vues d’habillage sphériques à 360 degrés ou qui ont été assemblées en tant que vues à 360 degrés à partir de plusieurs caméras sont utilisées.
  • Inspection : l’imagerie en gros plan des ressources (à moins de 5 mètres de la caméra) est utilisée.
String
input_data
[input_data,...]

Chemin d’accès et nom des données en entrée. Les produits suivants sont pris en charge :

Folder; Oriented Imagery Layer; Table; Raster Layer; File
include_sub_folders
(Facultatif)

Indique si les sous-dossiers sont explorés de manière récursive.

  • SUBFOLDERSDes données sont recherchées de manière récursive dans tous les sous-dossiers. Il s’agit de l’option par défaut.
  • NOSUBFOLDERSLes données sont recherchées uniquement dans le dossier de niveau supérieur.
Boolean
folder_filter
(Facultatif)

Expression permettant de filtrer et d’ajouter des images dans le dossier en entrée.

Par exemple, pour ajouter uniquement des images contenant une chaîne en particulier, ajoutez les symboles de pourcentage avant et après la valeur de chaîne (%value%).

String
where_clause
(Facultatif)

Expression SQL utilisée pour sélectionner un sous-ensemble d’enregistrements. Pour plus d’informations sur la syntaxe SQL reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.

SQL Expression
include_all_fields
(Facultatif)

Spécifie si tous les champs de la table en entrée, à part la structure requise, sont ajoutés dans la table attributaire du jeu de données.

  • NO_INCLUDE_ALL_FIELDSSeuls les champs spécifiques à la structure de l’imagerie orientée sont ajoutées dans la table attributaire du jeu de données. Il s’agit de l’option par défaut.
  • INCLUDE_ALL_FIELDSTous les champs de la table en entrée sont ajoutés dans la table attributaire du jeu de données.
Boolean

Sortie obtenue

NomExplicationType de données
out_oriented_imagery_dataset

Jeu de données d’imagerie orientée mis à jour.

Oriented Imagery Layer

Exemple de code

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

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction AddImagesToOrientedImageryDataset en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.oi.AddImagesToOrientedImageryDataset(
    "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset", 
    imagery_category="Oblique",
    input_data='C:/OrientedImageryExample/Samples/img1.jpg;C:/OrientedImageryExample/Samples/img2.jpg')