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

Résumé

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).

Syntaxe

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})
ParamètreExplicationType 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"
)

Informations de licence

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

Rubriques connexes