Ajouter des images à partir d’un type d’entrée personnalisé (Imagerie orientée)

Synthèse

Ajoute des images à un jeu de données d’imagerie orientée à partir des données en entrée définies par un type d’entrée spécifique.

Utilisation

• Cet outil utilise des types d’entrée personnalisés, implémentés dans Python, pour définir la façon dont des images et des métadonnées non normées ou complexes seront ajoutées à un jeu de données d’imagerie orientée.

  Le module Python doit se trouver dans un dossier nommé comme le module. Placez le dossier dans [InstallDirectory]\Resources\OrientedImagery\CustomInputTypes pour faire apparaître le type dans le menu déroulant du paramètre Type d’entrée personnalisé. Si le dossier du type d’entrée se trouve à un autre emplacement, sélectionnez l’option Folder et indiquez l’emplacement du dossier dans le paramètre Dossier du type d’entrée personnalisé.

• Pour automatiser les processus de gestion des données, ou pour les simplifier si vous utilisez fréquemment des imageries non normées, définissez un type d’entrée personnalisé pour les données. Utilisez ensuite l’outil pour ajouter des images à un jeu de données d’imagerie orientée.

• Cet outil constitue une alternative à l’outil Ajouter des images à un jeu de données d’imagerie orientée, qui crée un fichier .csv avec les métadonnées d’imagerie dans la structure de tables d’imagerie orientée pour ajouter des images à un jeu de données d’imagerie orientée.

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
Type d’entrée personnalisé	Nom du type d’entrée personnalisé. Pour sélectionner un type d’entrée qui n’est pas répertorié, utilisez l’option Folder. La valeur de ce paramètre va activer le paramètre Dossier du type d’entrée personnalisé.	String
Dossier du type d’entrée personnalisé	Chemin d’accès au dossier du type d’entrée personnalisé. Le dossier doit contenir un module Python portant le même nom que le dossier et doté des fonctions publiques requises.	Folder
Données en entrée	Nom et chemin d’accès ou valeur des données en entrée. Le type d’entrée personnalisé détermine les options disponibles.	Value Table
Paramètres auxiliaires	Noms et valeurs de tout paramètre auxiliaire défini dans la structure de types en entrée.	Value Table

Sortie obtenue

Étiquette	Explication	Type de données
Jeu de données d’imagerie orientée en sortie	Jeu de données d’imagerie orientée en sortie mis à jour.	Oriented Imagery Dataset

Python

arcpy.management.AddImagesFromCustomInputType(in_oriented_imagery_dataset, input_type, in_type_folder, in_data, auxiliary_parameters)

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
input_type	Nom du type d’entrée personnalisé. Si le dossier du type d’entrée personnalisé ne se trouve pas dans [InstallDirectory]\Resources\OrientedImagery\CustomInputTypes, spécifiez Folder comme valeur de paramètre et indiquez le chemin d’accès au dossier dans le paramètre in_type_folder.	String
in_type_folder	Chemin d’accès au dossier du type d’entrée personnalisé. Le dossier doit contenir un module Python portant le même nom que le dossier et doté des fonctions publiques requises.	Folder
in_data [in_data,...]	Nom et chemin d’accès ou valeur des données en entrée. Le type d’entrée personnalisé détermine les options disponibles.	Value Table
auxiliary_parameters [auxiliary_parameters,...]	Noms et valeurs de tout paramètre auxiliaire défini dans la structure de types en entrée.	Value Table

Sortie obtenue

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

Exemple de code

Exemple 1 d’utilisation de l’outil AddImagesFromCustomInputType (script autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction AddImagesFromCustomInputType dans un script autonome.

# Import system modules
import arcpy
import os

arcpy.env.workspace = "C:/OrientedImageryExample"

# Set local variables
fld = r"C:\OrientedImagerySamples"
oi_dataset = "C:\OrientedImageryExample\Sample.gdb\oi_dataset"
in_file = os.path.join(fld, "sampleinput.csv")
in_folder = os.path.join(arcpy.GetInstallInfo()['InstallDir'], 'Resources',
                         'OrientedImagery', 'CustomInputTypes',
                         'SampleInputType')
img_folder = os.path.join(fld, "Images")
img_ext = "mrf"
in_data= f'"CSV File" {in_file};"Image Folder" {img_folder};"Image Extension" {img_ext}'

# Run Add Images From Custom Input Type
arcpy.oi.AddImagesFromCustomInputType(
    oi_dataset, input_type="SampleInputType", in_type_folder="in_folder",
    in_data=in_data)

Environnements

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