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

Boîte de dialogue

Étiquette	Explication	Type 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 : Une ou plusieurs images au format JPEG. Un dossier contenant les images. Seules les images JPEG sont ajoutées au jeu de données à partir du dossier. Un fichier .txt contenant les chemins d’accès aux images JPEG. Chaque chemin d’accès à l’image doit être sur une ligne séparée. Un fichier .csv avec la structure de la table de l’imagerie orientée. Une couche d’entités avec la structure de la table attributaire de l’imagerie orientée. Une couche d’imagerie orientée. Un fichier .csv avec la structure de table FrameCamera. Un jeu de données mosaïque créé à l’aide de types raster d’imagerie aérienne.	Folder; Oriented Imagery Layer; Table; Raster Layer; Mosaic Layer; File
Inclure les sous-dossiers (Facultatif)	Indique si les données sont recherchées de manière récursive dans les sous-dossiers. 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

Étiquette	Explication	Type 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

Python

arcpy.oi.AddImagesToOrientedImageryDataset(in_oriented_imagery_dataset, imagery_category, input_data, {include_sub_folders}, {folder_filter}, {where_clause}, {include_all_fields})

Nom	Explication	Type 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 : Une ou plusieurs images au format JPEG. Un dossier contenant les images. Seules les images JPEG sont ajoutées au jeu de données à partir du dossier. Un fichier .txt contenant les chemins d’accès aux images JPEG. Chaque chemin d’accès à l’image doit être sur une ligne séparée. Un fichier .csv avec la structure de la table de l’imagerie orientée. Une couche d’entités avec la structure de la table attributaire de l’imagerie orientée. Une couche d’imagerie orientée. Un fichier .csv avec la structure de table FrameCamera. Un jeu de données mosaïque créé à l’aide de types raster d’imagerie aérienne.	Folder; Oriented Imagery Layer; Table; Raster Layer; Mosaic Layer; File
include_sub_folders (Facultatif)	Indique si les données sont recherchées de manière récursive dans les sous-dossiers. SUBFOLDERS—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. NOSUBFOLDERS—Les 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_FIELDS—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. INCLUDE_ALL_FIELDS—Tous les champs de la table en entrée sont ajoutés dans la table attributaire du jeu de données.	Boolean

Sortie obtenue

Nom	Explication	Type de données
out_oriented_imagery_dataset	Jeu de données d’imagerie orientée mis à jour.	Oriented Imagery Layer

Exemple de code

Exemple 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.oi.AddImagesToOrientedImageryDataset(
    "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset", 
    imagery_category="Oblique",
    input_data=['C:/OrientedImageryExample/Samples/img1.jpg',
                'C:/OrientedImageryExample/Samples/img2.jpg'
)

Environnements

Système de coordonnées en sortie, Transformations géographiques, Étendue

Informations de licence

• Basic: Non
• Standard: Oui
• Advanced: Oui