Espace de travail vers jeu de données raster (Outils de gestion des données)

Résumé

Combine tous les jeux de données raster d’un dossier en un jeu de données raster.

Utilisation

Pour pouvoir exécuter cet outil, le jeu de données raster cible doit déjà exister.
En l’absence d’un jeu de données raster cible, utilisez l’outil Create Raster Dataset (Créer un jeu de données raster) pour créer un jeu de données raster.
Comme le mosaïquage aura lieu, vous devrez spécifier la méthode de mosaïquage et le mode de palette de couleurs à utiliser.
Si le jeu de données raster cible est vide, la taille de cellule et la référence spatiale du premier jeu de données raster en entrée sont appliquées à la mosaïque.
Dans la mesure du possible, utilisez Last Mosaic Operator (Dernier opérateur de mosaïquage) pour mosaïquer les jeux de données raster sur un jeu de données raster existant dans une géodatabase fichier ou une géodatabase d'entreprise. Il s’agit de loin de la méthode de mosaïquage la plus efficace.
Pour le mosaïquage de données discrètes, l’option First (Premier), Minimum ou Maximum dans Mosaic Operator (Opérateur de mosaïquage) fournira les résultats les plus significatifs. Les options Blend (Fusionner) et Mean (Moyenne) sont les plus adaptées aux données continues.
Le menu déroulant Color Matching Method (Méthode de correspondance des couleurs) permet de choisir un algorithme pour faire correspondre les couleurs des jeux de données de votre mosaïque.
Pour les rasters basés sur des fichiers, l’option Ignore Background Value (Ignorer la valeur d’arrière-plan) doit être définie avec la même valeur que NoData pour que la valeur d’arrière-plan soit ignorée. Les rasters de géodatabase fonctionneront sans cette étape supplémentaire.
Pour les jeux de données raster en entrée à virgule flottante de différentes résolutions ou lorsque les cellules ne sont pas alignées, il est recommandé de rééchantillonner toutes les données par interpolation bilinéaire ou convolution cubique avant d’exécuter Mosaic (Mosaïque). Dans le cas contraire, Mosaic (Mosaïque) rééchantillonnera automatiquement les jeux de données raster en utilisant le rééchantillonnage par le voisin le plus proche, ce qui n’est pas approprié pour les types de données continus.

Etiqueter	Explication	Type de données
Espace de travail en entrée	Dossier contenant les jeux de données raster à fusionner.	Workspace
Jeu de données raster cible	Jeu de données raster existant dans lequel fusionner tous les jeux de données raster à partir de l'espace de travail en entrée.	Raster Dataset
Inclure les sous-répertoires (Facultatif)	Spécifie si les sous-répertoires sont inclus. Activé—Tous les jeux de données raster des sous-répertoires sont inclus lors du chargement. Décoché—Les sous-répertoires ne sont pas inclus. Il s’agit de l’option par défaut.	Boolean
Opérateur de mosaïque (Facultatif)	Spécifie la méthode qui sera utilisée pour mosaïquer les zones superposées. Premier—La valeur de cellule en sortie des zones superposées est la valeur du premier jeu de données raster mosaïqué à cet emplacement. Dernier—La valeur de cellule en sortie des zones superposées est la valeur du dernier jeu de données raster mosaïqué à cet emplacement. Il s’agit de l’option par défaut. Fusionner—La valeur de cellule en sortie des zones superposées résulte d’un calcul pondéré horizontalement des valeurs des cellules situées dans la zone superposée. Moyenne—La valeur de cellule en sortie des zones superposées correspond à la valeur moyenne des cellules superposées. Minimum—La valeur de cellule en sortie des zones superposées correspond à la valeur minimum des cellules superposées. Maximum—La valeur de cellule en sortie des zones superposées correspond à la valeur maximum des cellules superposées. Somme—La valeur de cellule en sortie des zones superposées correspond à la somme totale des cellules superposées.	String
Mode de palette du mosaïquage (Facultatif)	Détermine la méthode utilisée pour sélectionner la palette de couleurs des rasters en entrée qui sera appliquée à la sortie mosaïque. Premier—La palette de couleurs du premier jeu de données raster de la liste est appliquée à la mosaïque du raster en sortie. Il s’agit de l’option par défaut. Dernier—La palette de couleurs du dernier jeu de données raster de la liste est appliquée à la mosaïque du raster en sortie. Apparier—Toutes les palettes de couleurs sont prises en compte lors du mosaïquage. Si toutes les valeurs possibles sont déjà utilisées (pour la profondeur de bits), l’outil associe la valeur à la couleur disponible la plus proche. Refuser—Seuls les jeux de données raster auxquels aucune palette de couleurs n’est associée sont mosaïqués.	String
Ignorer la valeur d’arrière-plan (Facultatif)	Supprimez les valeurs non désirées créées autour des données raster. La valeur spécifiée est différenciée des autres valeurs utiles dans le jeu de données raster. Par exemple, une valeur zéro le long des bordures du jeu de données raster se différencie des valeurs zéro à l’intérieur du jeu de données raster. La valeur du pixel spécifiée est définie sur NoData dans le jeu de données raster en sortie. Pour les rasters basés sur des fichiers, ce paramètre doit être défini sur la même valeur que celle du paramètre NoData Value (Valeur NoData) pour que la valeur d’arrière-plan soit ignorée. Les rasters de géodatabase d’entreprise et fichier fonctionneront sans cette étape supplémentaire.	Double
Valeur NoData (Facultatif)	Tous les pixels ayant la valeur spécifiée auront la valeur des pixels NoData dans le jeu de données raster en sortie.	Double
Convertir les données 1 bit en 8 bits (Facultatif)	Indique si le jeu de données raster de 1 bit en entrée doit être converti en jeu de données raster de 8 bits. Si vous demandez cette conversion, la valeur 1 dans le jeu de données raster en entrée passera à 255 dans le jeu de données raster en sortie. Ceci est utile pour l’importation d’un jeu de données raster de 1 bit dans une géodatabase. Les jeux de données raster de 1 bit comportent des couches pyramidales de 8 bits lorsqu’ils sont stockés dans un système de fichiers. Toutefois, dans une géodatabase, les jeux de données raster de 1 bit comportent uniquement des couches pyramidales de 1 bit, ce qui entraîne un affichage de qualité médiocre. Grâce à la conversion des données en 8 bits dans une géodatabase, les couches pyramidales sont construites sur 8 bits et non pas sur 1 bit, ce qui permet le bon affichage des jeux de données raster. Activé—Le raster en entrée sera converti. Décoché—Aucune conversion n’est effectuée. Il s’agit de l’option par défaut.	Boolean
Tolérance de mosaïquage (Facultatif)	Lors du mosaïquage, les pixels cible et source ne s’alignent pas toujours exactement. En cas de défaut d’alignement des pixels, vous devez choisir entre un rééchantillonnage et un décalage des données. La tolérance de mosaïquage détermine si les pixels seront rééchantillonnés ou décalés. Si la différence d’alignement des pixels (du jeu de données entrant et du jeu de données cible) est supérieure à la tolérance, le rééchantillonnage a lieu. Si la différence d’alignement des pixels (du jeu de données entrant et du jeu de données cible) est inférieure à la tolérance, le rééchantillonnage n’a pas lieu et un décalage est effectué. L’unité de tolérance est un pixel avec une plage de valeurs valides comprises entre 0 et 0,5. Une tolérance de 0,5 garantit qu’un décalage sera appliqué. Une tolérance de zéro garantit qu’un rééchantillonnage sera appliqué en cas de défaut d’alignement des pixels. Par exemple, les pixels source et cible présentent un défaut d’alignement de 0,25. Si la tolérance de mosaïquage est définie sur 0,2, c’est le rééchantillonnage qui sera appliqué puisque le défaut d’alignement des pixels est supérieur à la tolérance. Si la tolérance de mosaïquage est définie sur 0,3, les pixels seront décalés.	Double
Méthode de correspondance des couleurs (Facultatif)	Méthode de correspondance des couleurs à appliquer aux rasters. Aucun—Cette option n’utilise aucune méthode de correspondance des couleurs lors du mosaïquage des jeux de données raster. Apparier les statistiques—Cette méthode utilise les statistiques descriptives des zones superposées. La transformation est ensuite appliquée à l’intégralité du jeu de données cible. Apparier l'histogramme—Cette méthode apparie l’histogramme de la zone de superposition de référence à la zone de superposition source. La transformation est ensuite appliquée à l’intégralité du jeu de données cible. Corrélation linéaire—Cette méthode apparie les pixels superposés, puis interpole le reste du jeu de données source. Les pixels sans relation un vers un utilisent une moyenne pondérée.	String
Palette vers RVB (Facultatif)	Indique si le jeu de données raster en entrée est converti en jeu de données raster en sortie à trois bandes lorsque le jeu de données raster en entrée inclut une palette de couleurs. Ceci est utile pour le mosaïquage des rasters avec différentes palettes de couleurs. Activé—Le jeu de données en entrée sera converti. Décoché—Aucune conversion n’est effectuée. Il s’agit de l’option par défaut.	Boolean

Sortie dérivée

Etiqueter	Explication	Type de données
Jeu de données raster cible mis à jour	Jeu de données raster mis à jour.	Raster Dataset

arcpy.management.WorkspaceToRasterDataset(in_workspace, in_raster_dataset, {include_subdirectories}, {mosaic_type}, {colormap}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {mosaicking_tolerance}, {MatchingMethod}, {colormap_to_RGB})

Nom	Explication	Type de données
in_workspace	Dossier contenant les jeux de données raster à fusionner.	Workspace
in_raster_dataset	Jeu de données raster existant dans lequel fusionner tous les jeux de données raster à partir de l'espace de travail en entrée.	Raster Dataset
include_subdirectories (Facultatif)	Spécifie si les sous-répertoires sont inclus. `INCLUDE_SUBDIRECTORIES`—Tous les jeux de données raster des sous-répertoires sont inclus lors du chargement. `NONE`—Les sous-répertoires ne sont pas inclus. Il s’agit de l’option par défaut.	Boolean
mosaic_type (Facultatif)	Spécifie la méthode qui sera utilisée pour mosaïquer les zones superposées. `FIRST`—La valeur de cellule en sortie des zones superposées est la valeur du premier jeu de données raster mosaïqué à cet emplacement. `LAST`—La valeur de cellule en sortie des zones superposées est la valeur du dernier jeu de données raster mosaïqué à cet emplacement. Il s’agit de l’option par défaut. `BLEND`—La valeur de cellule en sortie des zones superposées résulte d’un calcul pondéré horizontalement des valeurs des cellules situées dans la zone superposée. `MEAN`—La valeur de cellule en sortie des zones superposées correspond à la valeur moyenne des cellules superposées. `MINIMUM`—La valeur de cellule en sortie des zones superposées correspond à la valeur minimum des cellules superposées. `MAXIMUM`—La valeur de cellule en sortie des zones superposées correspond à la valeur maximum des cellules superposées. `SUM`—La valeur de cellule en sortie des zones superposées correspond à la somme totale des cellules superposées.	String
colormap (Facultatif)	Détermine la méthode utilisée pour sélectionner la palette de couleurs des rasters en entrée qui sera appliquée à la sortie mosaïque. `FIRST`—La palette de couleurs du premier jeu de données raster de la liste est appliquée à la mosaïque du raster en sortie. Il s’agit de l’option par défaut. `LAST`—La palette de couleurs du dernier jeu de données raster de la liste est appliquée à la mosaïque du raster en sortie. `MATCH`—Toutes les palettes de couleurs sont prises en compte lors du mosaïquage. Si toutes les valeurs possibles sont déjà utilisées (pour la profondeur de bits), l’outil associe la valeur à la couleur disponible la plus proche. `REJECT`—Seuls les jeux de données raster auxquels aucune palette de couleurs n’est associée sont mosaïqués.	String
background_value (Facultatif)	Supprimez les valeurs non désirées créées autour des données raster. La valeur spécifiée est différenciée des autres valeurs utiles dans le jeu de données raster. Par exemple, une valeur zéro le long des bordures du jeu de données raster se différencie des valeurs zéro à l’intérieur du jeu de données raster. La valeur du pixel spécifiée est définie sur NoData dans le jeu de données raster en sortie. Pour les rasters basés sur des fichiers, ce paramètre doit être défini sur la même valeur que celle du paramètre `nodata_value` pour que la valeur d’arrière-plan soit ignorée. Les rasters de géodatabase d’entreprise et fichier fonctionneront sans cette étape supplémentaire.	Double
nodata_value (Facultatif)	Tous les pixels ayant la valeur spécifiée auront la valeur des pixels NoData dans le jeu de données raster en sortie.	Double
onebit_to_eightbit (Facultatif)	Indique si le jeu de données raster de 1 bit en entrée doit être converti en jeu de données raster de 8 bits. Si vous demandez cette conversion, la valeur 1 dans le jeu de données raster en entrée passera à 255 dans le jeu de données raster en sortie. Ceci est utile pour l’importation d’un jeu de données raster de 1 bit dans une géodatabase. Les jeux de données raster de 1 bit comportent des couches pyramidales de 8 bits lorsqu’ils sont stockés dans un système de fichiers. Toutefois, dans une géodatabase, les jeux de données raster de 1 bit comportent uniquement des couches pyramidales de 1 bit, ce qui entraîne un affichage de qualité médiocre. Grâce à la conversion des données en 8 bits dans une géodatabase, les couches pyramidales sont construites sur 8 bits et non pas sur 1 bit, ce qui permet le bon affichage des jeux de données raster. `OneBitTo8Bit`—Le raster en entrée sera converti. `NONE`—Aucune conversion n’est effectuée. Il s’agit de l’option par défaut.	Boolean
mosaicking_tolerance (Facultatif)	Lors du mosaïquage, les pixels cible et source ne s’alignent pas toujours exactement. En cas de défaut d’alignement des pixels, vous devez choisir entre un rééchantillonnage et un décalage des données. La tolérance de mosaïquage détermine si les pixels seront rééchantillonnés ou décalés. Si la différence d’alignement des pixels (du jeu de données entrant et du jeu de données cible) est supérieure à la tolérance, le rééchantillonnage a lieu. Si la différence d’alignement des pixels (du jeu de données entrant et du jeu de données cible) est inférieure à la tolérance, le rééchantillonnage n’a pas lieu et un décalage est effectué. L’unité de tolérance est un pixel avec une plage de valeurs valides comprises entre 0 et 0,5. Une tolérance de 0,5 garantit qu’un décalage sera appliqué. Une tolérance de zéro garantit qu’un rééchantillonnage sera appliqué en cas de défaut d’alignement des pixels. Par exemple, les pixels source et cible présentent un défaut d’alignement de 0,25. Si la tolérance de mosaïquage est définie sur 0,2, c’est le rééchantillonnage qui sera appliqué puisque le défaut d’alignement des pixels est supérieur à la tolérance. Si la tolérance de mosaïquage est définie sur 0,3, les pixels seront décalés.	Double
MatchingMethod (Facultatif)	Méthode de correspondance des couleurs à appliquer aux rasters. `NONE`—Cette option n’utilise aucune méthode de correspondance des couleurs lors du mosaïquage des jeux de données raster. `STATISTIC_MATCHING`—Cette méthode utilise les statistiques descriptives des zones superposées. La transformation est ensuite appliquée à l’intégralité du jeu de données cible. `HISTOGRAM_MATCHING`—Cette méthode apparie l’histogramme de la zone de superposition de référence à la zone de superposition source. La transformation est ensuite appliquée à l’intégralité du jeu de données cible. `LINEARCORRELATION_MATCHING`—Cette méthode apparie les pixels superposés, puis interpole le reste du jeu de données source. Les pixels sans relation un vers un utilisent une moyenne pondérée.	String
colormap_to_RGB (Facultatif)	Indique si le jeu de données raster en entrée est converti en jeu de données raster en sortie à trois bandes lorsque le jeu de données raster en entrée inclut une palette de couleurs. Ceci est utile pour le mosaïquage des rasters avec différentes palettes de couleurs. `ColormapToRGB`—Le jeu de données en entrée sera converti. `NONE`—Aucune conversion n’est effectuée. Il s’agit de l’option par défaut.	Boolean

Sortie dérivée

Nom	Explication	Type de données
out_raster_dataset	Jeu de données raster mis à jour.	Raster Dataset

Exemple de code

Exemple 1 de WorkspaceToRasterDataset (fenêtre Python)

Il s’agit d’un exemple Python d’utilisation de l’outil WorkspaceToRasterDataset.

import arcpy
arcpy.management.WorkspaceToRasterDataset("c:/data/WS2RD", "c:/fgdb.gdb/outdats",
                                          "INCLUDE_SUBDIRECTORIES", "LAST",
                                          "FIRST", "0", "9", "", "",
                                          "HISTOGRAM_MATCHING", "")

Exemple 2 de WorkspaceToRasterDataset (script autonome)

Il s’agit d’un exemple de script Python d’utilisation de l’outil WorkspaceToRasterDataset.

##==================================
##Workspace To Raster Dataset

import arcpy
arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"
##Mosaic images to File Geodatabase Raster Dataset with Background and Nodata setting and Color Correction
arcpy.management.WorkspaceToRasterDataset("WS2RD", "fgdb.gdb\\dataset", "INCLUDE_SUBDIRECTORIES", "LAST", \
                                          "FIRST", "0", "9", "", "", "HISTOGRAM_MATCHING", "")

##Mosaic Colormap image to RGB image
arcpy.management.WorkspaceToRasterDataset("WS2RD_clr","fgdb.gdb\\dataset2", "INCLUDE_SUBDIRECTORIES", "LAST",\
                                          "FIRST", "", "", "", "0.3", "", "ColormapToRGB")

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Espace de travail vers jeu de données raster (Outils de gestion des données)

Résumé

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes