Résumé
Combine tous les jeux de données raster d'un dossier dans un jeu de données raster.
Utilisation
Le jeu de données raster cible doit déjà exister pour que cet outil puisse être exécuté.
En l'absence de jeu de données raster cible existant, utilisez l'outil Créer un jeu de données raster pour créer un jeu de données raster.
En vue du mosaïquage qui doit avoir lieu, vous devez 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 un jeu de données raster 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 le dernier opérateur de mosaïque pour mosaïquer les jeux de données raster de mosaïque sur un jeu de données raster existant dans une géodatabase fichier ou une géodatabase d'entreprise. C'est de loin la méthode de mosaïquage la plus efficace.
Pour le mosaïquage des données discrètes, les options First (Premier), Minimum ou Maximum dans Mosaic Operator (Opérateur de mosaïque) donneront les résultats les plus significatifs. Les options Blend (Fusionner) et Mean (Moyenne) sont particulièrement adaptées aux données continues.
La flèche de la liste déroulante de la méthode de correspondance des couleurs permet de choisir un algorithme pour faire correspondre les couleurs des jeux de données dans votre mosaïque.
Pour les rasters basés sur des fichiers, l'option 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 résolution différente ou lorsque les cellules ne sont pas alignées, il est recommander de ré-échantillonner toutes les données à l’aide de l’interpolation bilinéaire ou de la convolution cubique avant d’exécuter l’outil Mosaïque. Sans cela, l’outil Mosaïque ré-échantillonnera automatiquement les jeux de données raster à l’aide du ré-échantillonnage par le voisin le plus proche, qui ne convient pas aux types de données continues.
Syntaxe
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})| Paramètre | Explication | Type de données |
in_workspace | Dossier contenant les jeux de données raster à combiner. | Workspace |
in_raster_dataset | Jeu de données raster existant dans lequel combiner tous les jeux de données raster à partir de l'espace de travail en entrée. | Raster Dataset |
include_subdirectories (Facultatif) | Spécifiez s'il faut inclure les sous-répertoires.
| Boolean |
mosaic_type (Facultatif) | Spécifie la méthode qui sera utilisée pour mosaïquer les zones superposées.
| String |
colormap (Facultatif) | Spécifie la méthode utilisée pour choisir la palette de couleurs des rasters en entrée sera appliquée à la mosaïque en sortie.
| String |
background_value (Facultatif) | Utilisez cette option pour supprimer 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, l'option 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 fichier et d'entreprise fonctionnent sans cette étape supplémentaire. | Double |
nodata_value (Facultatif) | Tous les pixels ayant la valeur spécifiée auront la valeur NoData dans le jeu de données raster en sortie. | Double |
onebit_to_eightbit (Facultatif) | Spécifiez 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, d'où la médiocrité de l'affichage. 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.
| Boolean |
mosaicking_tolerance (Facultatif) | Lorsque le mosaïquage est effectué, les pixels de la source et de la cible ne s’alignent pas toujours parfaitement. En cas de mauvais alignement des pixels, vous devez choisir entre ré-échantillonner ou déplacer les données. La tolérance de mosaïquage détermine s’il convient de ré-échantillonner les pixels ou de les déplacer. Si la différence d’alignement des pixels (entre le jeu de données entrant et le jeu de données cible) est supérieure à la tolérance, un ré-échantillonnage est exécuté. Si la différence d’alignement des pixels (entre le jeu de données entrant et le jeu de données cible) est inférieure à la tolérance, aucun ré-échantillonnage n’est effectué et un déplacement est effectué. L’unité de tolérance est le pixel, la plage des valeurs valides s’étendant de 0 à 0,5. Une tolérance de 0,5 garantit qu’un déplacement a lieu. Une tolérance de zéro garantit un ré-échantillonnage 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, le ré-échantillonnage aura lieu, étant donné que 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 sont alors déplacés. | Double |
MatchingMethod (Facultatif) | Méthode d'appariement des couleurs à appliquer aux rasters.
| String |
colormap_to_RGB (Facultatif) | Si le jeu de données raster en entrée possède une palette de couleurs, le jeu de données raster en sortie peut être converti en jeu de données raster en sortie à trois canaux. Ceci est utile pour le mosaïquage des rasters avec différentes palettes de couleurs.
| Boolean |
Sortie dérivée
| Nom | Explication | Type de données |
| out_raster_dataset | Jeu de données raster mis à jour. | Jeu de données raster |
Exemple de code
Il s’agit d'un exemple Python d'utilisation de l'outil WorkspaceToRasterDataset.
import arcpy
arcpy.WorkspaceToRasterDataset_management("c:/data/WS2RD", "c:/fgdb.gdb/outdats",
"INCLUDE_SUBDIRECTORIES", "LAST",
"FIRST", "0", "9", "", "",
"HISTOGRAM_MATCHING", "")Il s’agit d'un exemple de script Python d'utilisation de l'outil WorkspaceToRasterDataset.
##==================================
##Workspace To Raster Dataset
##Usage: WorkspaceToRasterDataset_management in_workspace in_raster_dataset {NONE | INCLUDE_SUBDIRECTORIES}
## {LAST | FIRST | BLEND | MEAN | MINIMUM | MAXIMUM} {FIRST | REJECT
## | LAST | MATCH} {background_value} {nodata_value} {NONE | OneBitTo8Bit}
## {mosaicking_tolerance} {NONE | STATISTIC_MATCHING | HISTOGRAM_MATCHING
## | LINEARCORRELATION_MATCHING} {NONE | ColormapToRGB}
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.WorkspaceToRasterDataset_management("WS2RD", "fgdb.gdb\\dataset", "INCLUDE_SUBDIRECTORIES", "LAST", \
"FIRST", "0", "9", "", "", "HISTOGRAM_MATCHING", "")
##Mosaic Colormap image to RGB image
arcpy.WorkspaceToRasterDataset_management("WS2RD_clr","fgdb.gdb\\dataset2", "INCLUDE_SUBDIRECTORIES", "LAST",\
"FIRST", "", "", "", "0.3", "", "ColormapToRGB")Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?