Générer un ensemble de rasters (Gestion des données)

Synthèse

Effectue une analyse ou un géocodage par lots sur des ensembles d’images contenues dans une mosaïque. Les images de la mosaïque en entrée peuvent être traitées individuellement ou en tant que groupes.

Les règles de traitement peuvent être définies via le paramètre Collection Builder (Générateur d'ensembles) et les paramètres de fonction raster. Il génère une nouvelle mosaïque d’images traitées. Vous pouvez enregistrer les images traitées sur le disque en tant que fichiers distincts. La condition par défaut consiste à ajouter la fonction raster en entrée à la chaîne de fonctions des images existantes de la mosaïque et à l’ajouter à la mosaïque en sortie.

Utilisation

  • La sortie de cet outil est une mosaïque avec le modèle de fonction raster appliqué à chaque élément raster. Comme les paramètres facultatifs affectent la sortie, vous devez définir correctement les paramètres afin d’obtenir la sortie appropriée.

  • Pour générer des fichiers image distincts avec un modèle de fonction raster appliqué, vous devez définir un espace de travail en sortie. Un modèle de fonction raster peut être créé avec Raster Function Editor (Éditeur de fonctions raster).

Paramètres

ÉtiquetteExplicationType de données
Ensemble de rasters en sortie

Chemin complet de la mosaïque à créer. La mosaïque doit être stockée dans une géodatabase.

Mosaic Dataset
Générateur d'ensembles

Collecte d’images en entrée. Elle peut être considérée comme un modèle contenant des arguments, comme le chemin de la mosaïque source, les filtres d’extraction d’un sous-ensemble à partir de la source de données en entrée, etc.

Actuellement, cet outil prend uniquement en charge Simple Collection (Collecte simple), qui vous permet de définir une seule source de données et un filtre de requête, pour la source de données.

  • Collecte simplePermet de définir une source de données et un filtre de requête.
String
Arguments du générateur d'ensembles

Liste des arguments pour créer une collecte de sous-ensembles de la mosaïque.

Cet outil prend uniquement en charge la source de données et le filtre pour extraire des sous-ensembles de la mosaïque. Les valeurs Data Source (Source de données) et Where Clause (Clause Where) doivent être renseignées. Sinon, l’outil ne peut pas s’exécuter.

  • Source de donnéesChemin de la source de données.
  • Clause WhereFiltre utilisé pour extraire des sous-ensembles de la mosaïque.
Value Table
Fonction raster en entrée
(Facultatif)

Chemin d’un fichier modèle de fonction raster (.rft.xml ou .rft.json). Le modèle de fonction raster sera appliqué à chaque élément de la mosaïque en entrée. Function Editor (Éditeur de fonctions) peut servir à créer le modèle. Si aucun modèle de fonction raster n’est défini, cet outil crée une mosaïque en sortie en fonction du paramètre Collection Builder Arguments (Arguments du générateur d'ensembles).

String; File
Arguments de la fonction raster
(Facultatif)

Les paramètres associés à la chaîne de fonctions.

Par exemple, si la chaîne de fonctions applique la fonction NDVI, définissez les ID visibles et infrarouges. Le nom de la variable raster du modèle de fonction raster (RFT) doit être la valeur de champ Tag (Balise) dans la source de données en entrée.

Value Table
Propriétés de l'ensemble de rasters
(Facultatif)

Propriétés clés de la mosaïque en sortie.

Les propriétés de métadonnées clés qui sont disponibles reposent sur le type de capteur qui a saisi l’imagerie. Voici des exemples de propriétés de métadonnées clés :

  • SensorName
  • ProductName
  • AcquisitionDate
  • CloudCover
  • SunAzimuth
  • SunElevation
  • SensorAzimuth
  • SensorElevation
  • Off-nadirAngle
  • BandName
  • MinimumWavelength
  • MaximumWavelength
  • RadianceGain
  • RadianceBias
  • SolarIrradiance
  • ReflectanceGain
  • Tendance de réflectance

Value Table
Générer des rasters
(Facultatif)

Générez des fichiers de jeux de données raster des éléments de mosaïque après l’application du modèle de fonction raster.

  • Désactivé : le processus défini par le modèle de fonction raster sera ajouté aux élément d’image de la source de données en entrée pour produire un élément d’image dans la mosaïque en sortie. Il s’agit de l’option par défaut.
  • Activé : des jeux de données raster seront créés sur le disque. Vous devez également renseigner les champs Output Raster Workspace (Espace de travail du raster en sortie) et Format.

Boolean
Espace de travail du raster en sortie
(Facultatif)

Définit l’emplacement en sortie des jeux de données raster conservés si le paramètre Generate Rasters (Générer des rasters) est activé.

La convention d’attribution de nom des fichiers raster en sortie est oid_<oid#>_<Unique_GUID>.

Folder; String
Format
(Facultatif)

Type de format du à générer.

  • TiffTIFF (Tagged Image File Format)
  • ERDAS IMAGINEFichier ERDAS IMAGINE
  • CRFCloud Raster Format. Il s’agit de l’option par défaut.
  • MRFMeta Raster Format
String
Nom de base en sortie
(Facultatif)

Définit le nom de base en sortie des jeux de données raster conservés si le paramètre Generate Rasters (Générer des rasters) est activé. Un alias numérique est ajouté au nom de base de plusieurs jeux de données raster en sortie.

Le jeu de données mosaïque obtenu fait référence au format CRF directement sans conserver la chaîne de fonctions raster.

String

arcpy.management.GenerateRasterCollection(out_raster_collection, collection_builder, collection_builder_arguments, {raster_function}, {raster_function_arguments}, {collection_properties}, {generate_rasters}, {out_workspace}, {format}, {out_base_name})
NomExplicationType de données
out_raster_collection

Chemin complet de la mosaïque à créer. La mosaïque doit être stockée dans une géodatabase.

Mosaic Dataset
collection_builder

Collecte d’images en entrée. Elle peut être considérée comme un modèle contenant des arguments, comme le chemin de la mosaïque source, les filtres d’extraction d’un sous-ensemble à partir de la source de données en entrée, etc.

Actuellement, cet outil prend uniquement en charge SIMPLE_COLLECTION, qui vous permet de définir une seule source de données et un filtre de requête, pour la source de données.

  • SIMPLE_COLLECTIONPermet de définir une source de données et un filtre de requête.
String
collection_builder_arguments
[[Name, Value],...]

Liste des arguments pour créer une collecte de sous-ensembles de la mosaïque.

Cet outil prend uniquement en charge la source de données et le filtre pour extraire des sous-ensembles de la mosaïque. Les valeurs DataSource et WhereClause doivent être renseignées. Sinon, l’outil ne peut pas s’exécuter.

  • DataSourceChemin de la source de données.
  • WhereClauseFiltre utilisé pour extraire des sous-ensembles de la mosaïque.
Value Table
raster_function
(Facultatif)

Chemin d’un fichier modèle de fonction raster (.rft.xml ou .rft.json). Le modèle de fonction raster sera appliqué à chaque élément de la mosaïque en entrée. Function Editor (Éditeur de fonctions) peut servir à créer le modèle. Si aucun modèle de fonction raster n’est défini, cet outil crée une mosaïque en sortie en fonction du paramètre collection_builder_arguments.

String; File
raster_function_arguments
[[Name, Value],...]
(Facultatif)

Les paramètres associés à la chaîne de fonctions.

Par exemple, si la chaîne de fonctions applique la fonction NDVI, définissez les ID visibles et infrarouges. Le nom de la variable raster du modèle de fonction raster (RFT) doit être la valeur de champ Tag (Balise) dans la source de données en entrée.

Value Table
collection_properties
[[Name, Value],...]
(Facultatif)

Propriétés clés de la mosaïque en sortie.

Les propriétés de métadonnées clés qui sont disponibles reposent sur le type de capteur qui a saisi l’imagerie. Voici des exemples de propriétés de métadonnées clés :

  • SensorName
  • ProductName
  • AcquisitionDate
  • CloudCover
  • SunAzimuth
  • SunElevation
  • SensorAzimuth
  • SensorElevation
  • Off-nadirAngle
  • BandName
  • MinimumWavelength
  • MaximumWavelength
  • RadianceGain
  • RadianceBias
  • SolarIrradiance
  • ReflectanceGain
  • Tendance de réflectance

Value Table
generate_rasters
(Facultatif)

Générez des fichiers de jeux de données raster des éléments de mosaïque après l’application du modèle de fonction raster.

  • NO_GENERATE_RASTERSLe processus défini par le modèle de fonction raster sera ajouté aux élément d’image de la source de données en entrée pour produire un élément d’image dans la mosaïque en sortie. Il s’agit de l’option par défaut.
  • GENERATE_RASTERSDes jeux de données raster seront créés sur le disque. Vous devez également renseigner les champs out_workspace et format.
Boolean
out_workspace
(Facultatif)

Définit l’emplacement en sortie des jeux de données raster conservés si le paramètre generate_rasters est défini sur GENERATE_RASTERS.

La convention d’attribution de nom des fichiers raster en sortie est oid_<oid#>_<Unique_GUID>.

Folder; String
format
(Facultatif)

Type de format du à générer.

  • TIFFTIFF (Tagged Image File Format)
  • IMAGINE ImageFichier ERDAS IMAGINE
  • CRFCloud Raster Format. Il s’agit de l’option par défaut.
  • MRFMeta Raster Format
String
out_base_name
(Facultatif)

Définit le nom de base en sortie des jeux de données raster conservés si le paramètre generate_rasters est défini sur GENERATE_RASTERS.

String

Exemple de code

Exemple d’utilisation de l’outil GenerateRasterCollection (script autonome)

Il s'agit d'un script Python pour l'outil GenerateRasterCollection.

import arcpy
arcpy.GenerateRasterCollection_management(
    out_raster_collection="c:/temp/FGDB.gdb/testgencollection", 
    collection_builder="Simple Collection", 
    collection_builder_arguments="# DataSource c:\temp\FGDB.gdb\qb_portland;# 
WhereClause 'Tag = 'MS''", 
    raster_function="C:/temp/NDVI_test.rft.json", 
    raster_function_arguments="# MS #;# VisibleBandID_20171019_7337_958 1;# 
InfraredBandID_20171019_7337_958 4", 
    collection_properties="", 
    generate_rasters="GENERATE_RASTERS", 
    out_workspace="c:/temp/persistedoutput", 
    format="CRF"
)