Générer un ensemble de rasters (Outils de gestion des données)
Résumé
Effectue une analyse ou un traitement par lots sur des collections d’images contenues dans un jeu de données mosaïque. Les images du jeu de données mosaïque en entrée peuvent être traitées individuellement ou en tant que groupes.
Les règles de traitement peuvent être définies à l’aide du paramètre Collection Builder (Générateur d’ensembles) et des paramètres de la fonction raster. Un nouveau jeu de données mosaïque des images traitées est généré. Vous pouvez choisir d’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 du jeu de données mosaïque, puis de l’ajouter au jeu de données mosaïque en sortie.
Utilisation
La sortie de cet outil est un jeu de données mosaïque, où le modèle de fonction raster (RFT) est appliqué à chaque élément raster. Puisque les paramètres facultatifs ont un impact sur la sortie, il est nécessaire de les définir correctement afin d’obtenir la sortie adéquate.
Si vous voulez générer des fichiers image distincts auxquels est appliqué un modèle de fonction raster (RFT), vous devez définir un espace de travail en sortie. Vous pouvez créer un modèle de fonction raster (RFT) à l’aide de Raster Function Editor (Éditeur de fonctions raster).
Chemin d’accès complet du jeu de données mosaïque à créer. Le jeu de données mosaïque doit être stocké dans une géodatabase.
Mosaic Dataset
Générateur d’ensembles
Collection d’images en entrée. Elle peut être vue comme un modèle contenant des arguments tels que le chemin d’accès au jeu de données mosaïque source, les filtres permettant d’extraire un sous-ensemble de la source de données en entrée, etc.
Actuellement, cet outil prend en charge uniquement l’option Simple Collection (Collection simple), qui permet de définir une source de données unique et un filtre de requête pour la source de données.
Collection simple—Cette option permet de définir une source de données et un filtre de requête.
String
Arguments du générateur d’ensembles
Liste d’arguments permettant de créer une collection de type sous-ensemble du jeu de données mosaïque.
Cet outil prend en charge uniquement la source de données et le filtre pour créer des sous-ensembles du jeu de données mosaïque. Les valeurs Data Source (Source de données) et Where Clause (Clause Where) doivent être indiquées. À défaut, l’outil ne peut pas s’exécuter.
Colonnes de la table de valeurs :
Name—The name of the collection builder arguments.
Value—The value of the collection builder arguments.
Value Table
Fonction raster en entrée
(Facultatif)
Chemin d’accès à un fichier de modèle de fonction raster (.rft.xml ou .rft.json). Le modèle de fonction raster est appliqué à chaque élément dans le jeu de données mosaïque en entrée. Vous pouvez utiliser Function Editor (Éditeur de fonctions) pour créer le modèle. Si aucun modèle de fonction raster (RFT) n’est défini, cet outil crée la 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 NVDI, définissez les ID de la bande visible et de la bande infrarouge. Le nom de la variable raster du modèle de fonction raster (RFT) doit correspondre à la valeur du champ Tag dans la source de données en entrée.
Colonnes de la table de valeurs :
Name—The name of the raster function argument; this is usually the name in the Tag field.
Value—The value of the raster function argument.
Value Table
Propriétés de l’ensemble de rasters
(Facultatif)
Propriétés clés du jeu de données mosaïque en sortie.
Propriétés des métadonnées clés disponibles selon le type de capteur qui a capturé l’imagerie. Voici quelques 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
ReflectanceBias
Colonnes de la table de valeurs :
Name—The name of the key property.
Value—The value of the key property.
Value Table
Générer des rasters
(Facultatif)
Choisissez de générer des fichiers de jeu de données raster des éléments du jeu de données mosaïque après l’application du modèle de fonction raster (RFT).
Activé—Créez des jeux de données raster sur le disque. Vous devrez également renseigner les paramètres Output Raster Workspace (Espace de travail du raster en sortie) et Format.
Décoché—Le traitement défini par le modèle de fonction raster est ajouté aux éléments d’image de la source de données en entrée pour produire un élément d’image dans le jeu de données mosaïque en sortie. Il s’agit de l’option par défaut.
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 de nommage pour les fichiers raster en sortie est oid_<oid#>_<Unique_GUID>.
Folder; String
Format
(Facultatif)
Type de format du raster à générer.
Tiff—TIFF (Tagged Image File Format)
ERDAS IMAGINE—Fichier ERDAS IMAGINE
CRF—Cloud Raster Format. Il s’agit de l’option par défaut.
MRF—Meta 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 des jeux de données raster si plusieurs jeux de données raster sont générés en sortie.
Le jeu de données mosaïque obtenu référence directement le format CRF sans conserver la chaîne de fonctions raster.
Chemin d’accès complet du jeu de données mosaïque à créer. Le jeu de données mosaïque doit être stocké dans une géodatabase.
Mosaic Dataset
collection_builder
Collection d’images en entrée. Elle peut être vue comme un modèle contenant des arguments tels que le chemin d’accès au jeu de données mosaïque source, les filtres permettant d’extraire un sous-ensemble de la source de données en entrée, etc.
Actuellement, cet outil prend en charge uniquement l’option SIMPLE_COLLECTION, qui permet de définir une source de données unique et un filtre de requête pour la source de données.
SIMPLE_COLLECTION—Cette option permet de définir une source de données et un filtre de requête.
String
collection_builder_arguments[[Name, Value],...]
Liste d’arguments permettant de créer une collection de type sous-ensemble du jeu de données mosaïque.
Cet outil prend en charge uniquement la source de données et le filtre pour créer des sous-ensembles du jeu de données mosaïque. Les valeurs DataSource et WhereClause doivent être indiquées. À défaut, l’outil ne peut pas s’exécuter.
Colonnes de la table de valeurs :
Name—The name of the collection builder arguments.
Value—The value of the collection builder arguments.
Value Table
raster_function
(Facultatif)
Chemin d’accès à un fichier de modèle de fonction raster (.rft.xml ou .rft.json). Le modèle de fonction raster est appliqué à chaque élément dans le jeu de données mosaïque en entrée. Vous pouvez utiliser Function Editor (Éditeur de fonctions) pour créer le modèle. Si aucun modèle de fonction raster (RFT) n’est défini, cet outil crée la 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 NVDI, définissez les ID de la bande visible et de la bande infrarouge. Le nom de la variable raster du modèle de fonction raster (RFT) doit correspondre à la valeur du champ Tag dans la source de données en entrée.
Colonnes de la table de valeurs :
Name—The name of the raster function argument; this is usually the name in the Tag field.
Value—The value of the raster function argument.
Value Table
collection_properties[[Name, Value],...]
(Facultatif)
Propriétés clés du jeu de données mosaïque en sortie.
Propriétés des métadonnées clés disponibles selon le type de capteur qui a capturé l’imagerie. Voici quelques 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
ReflectanceBias
Colonnes de la table de valeurs :
Name—The name of the key property.
Value—The value of the key property.
Value Table
generate_rasters
(Facultatif)
Choisissez de générer des fichiers de jeu de données raster des éléments du jeu de données mosaïque après l’application du modèle de fonction raster (RFT).
GENERATE_RASTERS—Créez des jeux de données raster sur le disque. Vous devrez également renseigner les paramètres out_workspace et format.
NO_GENERATE_RASTERS—Le traitement défini par le modèle de fonction raster est ajouté aux éléments d’image de la source de données en entrée pour produire un élément d’image dans le jeu de données mosaïque en sortie. Il s’agit de l’option par défaut.
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 de nommage pour les fichiers raster en sortie est oid_<oid#>_<Unique_GUID>.
Folder; String
format
(Facultatif)
Type de format du raster à générer.
TIFF—TIFF (Tagged Image File Format)
IMAGINE Image—Fichier ERDAS IMAGINE
CRF—Cloud Raster Format. Il s’agit de l’option par défaut.
MRF—Meta 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 la fonction GenerateRasterCollection (script autonome)
Il s’agit d’un script Python pour la fonction GenerateRasterCollection.