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

Récapitulatif

Mosaïque tous les jeux de données raster stockés dans l'espace de travail spécifié en 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.

• Comme le mosaïquage va avoir lieu, vous devrez spécifier la méthode de mosaïquage et le mode de palette du mosaïquage à 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.

• Lorsque cela s'avère possible, utilisez le dernier Opérateur de mosaïque pour mosaïquer des jeux de données raster sur un jeu de données raster existant dans une géodatabase fichier ou ArcSDE ; il s'agit incontestablement de la méthode de mosaïquage la plus efficace.

• S'agissant du mosaïquage des données discrètes, les options Premier, Minimum ou Maximum de l'Opérateur de mosaïque donnent les résultats les plus significatifs. Les options Fusionner et Moyenne de l'Opérateur de mosaïque sont mieux 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 et les rasters de géodatabase personnelle, 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 les rasters ArcSDE fonctionneront sans cette étape supplémentaire.

• Pour les jeux de données raster en entrée multicanaux de résolutions différentes ou lorsque les cellules ne sont pas alignées, il est conseillé 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 ; dans le cas contraire, l'outil Mosaïque ré-échantillonnera automatiquement les jeux de données raster à l'aide du ré-échantillonnage du plus proche voisin, une méthode qui n'est pas adaptée aux types de données continues.

Syntaxe

WorkspaceToRasterDataset_management (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	Espace de travail contenant tous les jeux de données raster à mosaïquer dans le jeu de données raster.	Workspace
in_raster_dataset	Jeu de données raster dans lequel seront mosaïqués tous les rasters de l'espace de travail. Ce jeu de données raster doit déjà exister.	Raster dataset
include_subdirectories (Facultatif)	Spécifiez s'il faut inclure les sous-répertoires. NONE —N'inclut pas les sous-répertoires. Il s'agit de l'option par défaut. INCLUDE_SUBDIRECTORIES —Inclut tous les jeux de données raster contenus dans les sous-répertoires lors du chargement.	Boolean
mosaic_type (Facultatif)	La méthode utilisée pour mosaïquer des zones superposées. FIRST —La valeur de cellule en sortie des zones superposées sera celle issue du premier jeu de données raster mosaïqué à cet emplacement. LAST —La valeur de cellule en sortie des zones superposées sera celle issue 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 sera un calcul pondéré horizontalement des valeurs des cellules de la zone superposée. MOYENNE —La valeur de cellule en sortie des zones superposées sera la valeur moyenne des cellules superposées. MINIMUM —La valeur de cellule en sortie des zones superposées sera la valeur minimale des cellules superposées. MAXIMUM —La valeur de cellule en sortie des zones superposées sera la valeur maximale des cellules superposées. Pour plus d'informations sur chaque opérateur de mosaïque, reportez-vous à la rubrique Opérateur de mosaïque.	String
colormap (Facultatif)	La méthode utilisée pour choisir la palette de couleurs des rasters en entrée sera appliquée à la mosaïque en sortie. FIRST —La palette de couleurs du premier jeu de données raster de la liste sera appliquée à la mosaïque 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 sera appliquée à la mosaïque 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 des couleurs), la valeur est mise en correspondance avec la couleur disponible la plus proche, si possible. REJECT —Seuls les jeux de données raster auxquels aucune palette de couleurs n'est associée sont mosaïqués. Pour plus d'informations sur chaque mode de palette, reportez-vous à la rubrique Mode de palette du mosaïquage.	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 et les rasters de géodatabase personnelle, 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 ArcSDE fonctionneront 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 ArcSDE. Le jeu de données raster de 1 bit comporte des couches pyramidales de 8 bits lorsqu'il est stocké dans un système de fichiers. Toutefois, dans ArcSDE, 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 ArcSDE, 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. NONE —Aucune conversion ne sera effectuée. Il s'agit de l'option par défaut. OneBitTo8Bit —Le raster en entrée sera converti.	Boolean
mosaicking_tolerance (Facultatif)	Lorsque le mosaïquage est effectué, les pixels source et cible ne s'alignent pas toujours parfaitement. S'il existe un défaut d'alignement des pixels, un ré-échantillonnage ou un déplacement des données doit être exécuté. 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é (un déplacement est effectué à la place). L'unité de tolérance est le pixel ; la plage des valeurs valides s'étend de 0 à 0,9999. Un pixel peut être décalé de 0,5 au maximum. Aussi, la définition de toute valeur supérieure à 0,5 vous permet de vous assurer qu'un décalage 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, un ré-échantillonnage est effectué, é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)	Sélectionnez la méthode de correspondance des couleurs à appliquer aux rasters. NONE —Cette option n'utilise pas l'opération de correspondance des couleurs lors du mosaïquage de vos jeux de données raster. STATISTICS_MATCHING —Cette méthode met en correspondance les différences statistiques (valeurs minimales, maximales et moyennes) entre la zone de superposition de référence et la zone de superposition source ; la transformation est ensuite appliquée à l'ensemble du jeu de données cible. HISTOGRAM_MATCHING —Cette méthode met en correspondance l'histogramme issu de la zone de superposition de référence avec la zone de superposition source ; la transformation est ensuite appliquée à la cible entière. LINEARCORRELATION_MATCHING —Cette méthode met en correspondance les pixels superposés, puis interpole au reste de la source ; les pixels qui n'ont pas de relation un-à-un utilisent une moyenne pondérée.	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. NONE —Aucune conversion n'est effectuée. Il s'agit de l'option par défaut. ColormapToRGB —Le jeu de données en entrée sera converti.	Boolean

Exemple de code

Exemple 1 d'utilisation de l'outil WorkspaceToRasterDataset (fenêtre Python)

Il s'agit d'un exemple de script 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", "")

Exemple 2 d'utilisation de l'outil WorkspaceToRasterDataset (script autonome)

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}
try:
    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")
except:
    print "Workspace To Raster Dataset example failed."
    print arcpy.GetMessages()

Environnements

Espace de travail courant