Mosaïque (Gestion des données)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Mosaïque plusieurs rasters en entrée en un jeu de données raster existant.

En savoir plus sur le mosaïquage de jeux de données raster

Illustration

Illustration de l'outil Mosaïque

Utilisation

Syntaxe

Mosaic_management (inputs, target, {mosaic_type}, {colormap}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {mosaicking_tolerance}, {MatchingMethod})
ParamètreExplicationType de données
inputs
[input,...]

Les jeux de données raster en entrée.

Mosaic Dataset ; Composite Layer ; Raster Dataset ; Raster Layer
target

Jeu de données raster cible.

Ce jeu de données raster doit exister au préalable. La couche cible est considérée comme étant le premier raster dans la liste des rasters en entrée.

Raster Dataset
mosaic_type
(Facultatif)

La méthode utilisée pour mosaïquer des zones superposées.

  • FIRSTLa valeur de la cellule en sortie des zones superposées sera celle issue du premier jeu de données raster mosaïqué à cet emplacement.
  • LASTLa valeur de la 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.
  • BLENDLa valeur de cellule en sortie des zones superposées sera un calcul horizontalement pondéré des valeurs des cellules dans la zone superposée.
  • MOYENNELa valeur de la cellule en sortie des zones superposées sera la valeur moyenne des cellules superposées.
  • MINIMUMLa valeur de la cellule en sortie des zones superposées sera la valeur minimale des cellules superposées.
  • MAXIMUMLa valeur de la cellule en sortie des zones superposées sera la valeur maximale des cellules superposées.
  • SUMLa valeur de la cellule en sortie des zones superposées sera la somme totale des cellules superposées.

La couche cible est considérée comme étant le premier raster dans la liste des rasters en entrée.

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.

  • FIRSTLa palette de couleurs du premier jeu de données raster dans la liste sera appliquée à la mosaïque raster en sortie. Il s'agit de l'option par défaut.
  • LASTLa palette de couleurs du dernier jeu de données raster dans la liste sera appliquée à la mosaïque raster en sortie.
  • MATCHToutes les palettes de couleurs seront prises en compte lors du mosaïquage. Si toutes les valeurs possibles sont déjà utilisées (pour la profondeur binaire), la valeur sera mise en correspondance avec la couleur disponible la plus proche, si possible.
  • REJECTSeuls les jeux de données raster auxquels aucune palette de couleurs n'est associée seront mosaïqués.

La couche cible est considérée comme étant le premier raster dans la liste des rasters en entrée.

Pour plus d'informations sur chaque mode de palette de couleurs, 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. 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 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.

  • NONEAucune conversion ne sera effectuée. Il s'agit de l'option par défaut.
  • OneBitTo8BitLe raster en entrée sera converti.
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. 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,5. Une tolérance de 0,5 garantit 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, 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)

Sélectionnez la méthode de correspondance des couleurs à appliquer aux rasters.

  • NONECette option n'utilisera pas l'opération de mise en correspondance des couleurs lors du mosaïquage de vos jeux de données raster.
  • STATISTICS_MATCHINGCette 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, puis applique la transformation au jeu de données cible entier.
  • HISTOGRAM_MATCHINGCette méthode met en correspondance l'histogramme issu de la zone de superposition de référence avec la zone de superposition source, puis applique la transformation à la cible entière.
  • LINEARCORRELATION_MATCHINGCette 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

Exemple de code

Exemple 1 d'utilisation de l'outil Mosaïque (fenêtre Python)

Ceci est un exemple Python d'utilisation de l'outil Mosaïque.

import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.Mosaic_management("land2.tif;land3.tif","land1.tif","LAST","FIRST",
                        "0", "9", "", "", "")
Exemple 2 d'utilisation de l'outil Mosaïque (script autonome)

Ceci est un exemple de script Python d'utilisation de l'outil Mosaïque.

##==================================
##Mosaic
##Usage: Mosaic_management inputs;inputs... target {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}
try:
    import arcpy
    arcpy.env.workspace = r"\\workspace\PrjWorkspace\RasGP"
    ##Mosaic two TIFF images to a single TIFF image
    ##Background value: 0
    ##Nodata value: 9
    arcpy.Mosaic_management("landsatb4a.tif;landsatb4b.tif","Mosaic\\landsat.tif","LAST","FIRST","0", "9", "", "", "")
    
    ##Mosaic several 3-band TIFF images to FGDB Raster Dataset with Color Correction
    ##Set Mosaic Tolerance to 0.3. Mismatch larget than 0.3 will be resampled
    arcpy.Mosaic_management("rgb1.tif;rgb2.tif;rgb3.tif", "Mosaic.gdb\\rgb","LAST","FIRST","", "", "", "0.3", "HISTOGRAM_MATCHING")
except:
    print "Mosaic example failed."
    print arcpy.GetMessages()

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Oui
ArcGIS for Desktop Standard: Oui
ArcGIS for Desktop Advanced: Oui
6/5/2014