Mosaïque (Gestion des données)

Résumé

Combine plusieurs jeux de données raster ou mosaïque existants en un jeu de données raster existant.

Illustration

Illustration de l’outil Mosaïque

Utilisation

  • Le raster cible doit être un jeu de données raster existant, qui peut être vide ou déjà contenir des données.

  • Une mosaïque est utile lorsqu'au moins deux jeux de données raster adjacents doivent être combinés en une seule entité. Certaines techniques de mosaïque peuvent aider à réduire les changements abrupts le long des limites de rasters superposés. Si le raster cible est un raster au format CRF, l’étendue n’est pas mise à jour.

  • Les zones superposées de la mosaïque peuvent être gérées de plusieurs façons. Vous pouvez par exemple définir l'outil de manière à ce qu'il conserve uniquement les données du premier jeu de données raster, ou vous pouvez combiner les valeurs de cellule superposées. Il existe également plusieurs options permettant de déterminer la manière de gérer une palette de couleurs, si le jeu de données raster en utilise une. Par exemple, vous pouvez conserver la palette de couleurs du jeu de données raster le plus récent utilisé dans la mosaïque.

  • Le raster indiqué dans Target Raster (Raster cible) est considéré comme le premier raster de la liste des rasters en entrée.

  • 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.

  • Dans la mesure du possible, utilisez l’option Dernier dans Opérateur de mosaïque pour mosaïquer les jeux de données raster mosaïque sur un jeu de données raster existant dans une géodatabase. Il s’agit de la méthode de mosaïquage la plus efficace.

  • 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.

  • Lors du mosaïquage de jeux de données raster contenant des palettes de couleurs, il est important de noter les différences entre les palettes de couleurs pour chaque jeu de données raster que vous mosaïquez. Vous pouvez utiliser l’outil Mosaïque même si les jeux de données raster ont des palettes de couleurs différentes, mais vous devez alors choisir le mode de palette de couleurs approprié. Si vous choisissez un mode de palette de couleurs inadéquat, votre sortie peut ne pas ressembler à ce que vous attendez.

  • Le paramètre Color Matching Method (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 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.

  • L’outil Mosaïque n’utilise pas le paramètre d’environnement de l’étendue en sortie, car l’outil a tendance à créer des jeux de données raster très gros et le paramètre de l’étendue en sortie risque de découper vos données. Si l’étendue en sortie doit être ajustée, utilisez l’outil Découper pour découper le raster cible après le traitement.

  • Lorsque le raster cible est un raster CRF multidimensionnel, seules les tranches correspondantes de la même dimension et de la même variable sont mises à jour.

  • Le raster cible et les rasters en entrée doivent avoir le même nombre de canaux.

Paramètres

ÉtiquetteExplicationType de données
Rasters en entrée

Jeux de données raster à fusionner.

Mosaic Dataset; Raster Dataset; Raster Layer
Raster cible

Raster auquel les rasters en entrée sont ajoutés. Ce jeu de données raster doit exister au préalable. Par défaut, le raster cible est considéré comme étant le premier raster dans la liste des jeux de données raster en entrée. Vous pouvez créer un raster vide à l’aide de l’outil Créer un jeu de données raster.

Raster Dataset
Opérateur de mosaïque
(Facultatif)

Spécifie la méthode qui sera utilisée pour mosaïquer les zones superposées.

Pour plus d’informations sur chaque opérateur de mosaïque, reportez-vous à la rubrique d’aide Opérateur de mosaïque.

  • PremierLa valeur de la cellule en sortie des zones superposées sera celle issue du premier jeu de données raster mosaïqué à cet emplacement.
  • DernierLa 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.
  • FusionnerLa 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.
  • MinimalLa 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.
  • SommeLa valeur de la cellule en sortie des zones superposées sera la somme totale des cellules superposées.
String
Mode de palette du mosaïquage
(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.

Pour plus d’informations sur chaque mode de palette de couleurs, reportez-vous à la rubrique d’aide Mode de palette du mosaïquage.

  • PremierLa 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.
  • DernierLa palette de couleurs du dernier jeu de données raster dans la liste sera appliquée à la mosaïque raster en sortie.
  • ApparierToutes 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), l’outil met la valeur en correspondance avec la couleur disponible la plus proche.
  • RefuserSeuls les jeux de données raster auxquels aucune palette de couleurs n'est associée seront mosaïqués.
String
Ignorer la valeur d’arrière-plan
(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, 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 d'entreprise fonctionneront sans cette étape supplémentaire.

Double
Valeur NoData
(Facultatif)

Tous les pixels ayant la valeur spécifiée auront la valeur NoData dans le jeu de données raster en sortie.

Double
Convertir les données 1 bit en 8 bits
(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.

  • Désactivé : aucune conversion ne sera effectuée. Il s’agit de l’option par défaut.
  • Activé : le raster en entrée sera converti.
Boolean
Tolérance de mosaïquage
(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
Méthode de correspondance des couleurs
(Facultatif)

Spécifie la méthode de correspondance des couleurs à appliquer aux rasters.

  • AucunAucune méthode de correspondance des couleurs n’est utilisée dans le mosaïquage de jeux de données raster.
  • Apparier les statistiquesLes statistiques descriptives des zones superposées seront appariées, puis la transformation sera appliquée à l’ensemble du jeu de données cible.
  • Apparier l'histogrammeL’histogramme de la zone de superposition de référence sera apparié à la zone de superposition source. La transformation sera ensuite appliquée à l’intégralité du jeu de données cible.
  • Corrélation linéaireLes pixels superposés seront appariés et le reste du jeu de données source sera interpolé. Les pixels sans relation un à un utiliseront une moyenne pondérée.
String

Sortie dérivée

ÉtiquetteExplicationType de données
Raster cible mis à jour

Jeu de données raster mis à jour.

Raster Dataset

arcpy.management.Mosaic(inputs, target, {mosaic_type}, {colormap}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {mosaicking_tolerance}, {MatchingMethod})
NomExplicationType de données
inputs
[input,...]

Jeux de données raster à fusionner.

Mosaic Dataset; Raster Dataset; Raster Layer
target

Raster auquel les rasters en entrée sont ajoutés. Ce jeu de données raster doit exister au préalable. Par défaut, le raster cible est considéré comme étant le premier raster dans la liste des jeux de données raster en entrée. Vous pouvez créer un raster vide à l’aide de l’outil Créer un jeu de données raster.

Raster Dataset
mosaic_type
(Facultatif)

Spécifie la méthode qui sera utilisée pour mosaïquer les 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.
  • MEANLa 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.
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.

  • 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), l’outil met la valeur en correspondance avec la couleur disponible la plus proche.
  • REJECTSeuls les jeux de données raster auxquels aucune palette de couleurs n'est associée seront mosaïqués.
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, 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 d'entreprise 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 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.

  • 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. 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)

Spécifie la méthode de correspondance des couleurs à appliquer aux rasters.

  • NONEAucune méthode de correspondance des couleurs n’est utilisée dans le mosaïquage de jeux de données raster.
  • STATISTIC_MATCHINGLes statistiques descriptives des zones superposées seront appariées, puis la transformation sera appliquée à l’ensemble du jeu de données cible.
  • HISTOGRAM_MATCHINGL’histogramme de la zone de superposition de référence sera apparié à la zone de superposition source. La transformation sera ensuite appliquée à l’intégralité du jeu de données cible.
  • LINEARCORRELATION_MATCHINGLes pixels superposés seront appariés et le reste du jeu de données source sera interpolé. Les pixels sans relation un à un utiliseront une moyenne pondérée.
String

Sortie dérivée

NomExplicationType de données
output

Jeu de données raster mis à jour.

Raster Dataset

Exemple de code

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

Il s'agit d'un exemple Python d'utilisation de l'outil Mosaic.

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)

Il s'agit d'un exemple de script Python d'utilisation de l'outil Mosaic.

##==================================
##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}

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")

Environnements

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

Informations de licence

  • Basic: Nécessite O
  • Standard: Nécessite O
  • Advanced: Nécessite O

Rubriques connexes