Mosaïque vers nouveau raster (Gestion des données)

Résumé

Combine plusieurs jeux de données raster en un nouveau jeu de données raster.

Utilisation

  • Les jeux de données raster en entrée sont tous les jeux de données raster que vous souhaitez mosaïquer ensemble. Les entrées doivent avoir le même nombre de canaux et la même profondeur de couleur, sinon, l'outil s'interrompra avec un message d'erreur.

  • L’outil Mosaic (Mosaïque) offre plus de paramètres si vous combinez des jeux de données dans un raster existant, comme des options permettant d’ignorer les valeurs NoData et en arrière-plan.

  • Vous devez définir le type de pixel pour qu'il corresponde à vos jeux de données raster en entrée existants. Si vous ne définissez pas le type de pixel, la valeur par défaut de 8 bits est appliquée et la sortie obtenue risque d'être incorrecte.

  • Vous pouvez enregistrer votre sortie au format BIL, BIP, BMP, BSQ, DAT, Grid Esri, GIF, IMG, JPEG, JPEG 2000, PNG ou TIFF ou en tant que jeu de données raster de géodatabase.

  • Lorsque vous stockez un jeu de données raster dans un fichier JPEG, un fichier JPEG 2000 ou une géodatabase, vous pouvez spécifier un type de compression et une qualité de compression dans les environnements.

  • Le format GIF prend uniquement en charge des jeux de données raster monocanaux.

  • 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. Dans cette situation, utilisez l’outil Mosaïque pour les rasters comportant des palettes de couleurs différentes. Vous devez toutefois sélectionner une valeur de paramètre Mosaic Colormap Mode (Mode de palette du mosaïquage) adéquate. Si vous choisissez un mode de palette de couleurs inadéquat, votre sortie peut ne pas ressembler à ce que vous attendez.

  • Cet outil ne respecte pas le paramètre d'environnement Etendue en sortie pour les géodatabases d'entreprise. Si vous souhaitez une étendue spécifique pour votre raster en sortie, utilisez plutôt l'outil Découper. Vous pouvez soit découper les raster en entrée avant d'utiliser cet outil, soit découper la sortie de cet outil.

Syntaxe

arcpy.management.MosaicToNewRaster(input_rasters, output_location, raster_dataset_name_with_extension, {coordinate_system_for_the_raster}, {pixel_type}, {cellsize}, number_of_bands, {mosaic_method}, {mosaic_colormap_mode})
ParamètreExplicationType de données
input_rasters
[input_raster,...]

Jeux de données raster que vous voulez combiner. Les entrées doivent avoir le même nombre de bandes et la même profondeur de couleur.

Mosaic Dataset; Raster Dataset; Raster Layer
output_location

Dossier ou géodatabase où stocker le raster.

Workspace
raster_dataset_name_with_extension

Nom du jeu de données que vous créez.

Pour enregistrer le jeu de données raster dans un format de fichier, vous devez spécifier une extension de fichier :

  • .bil : Esri BIL
  • .bip : Esri BIP
  • .bmp : BMP
  • .bsq : Esri BSQ
  • .dat : ENVI DAT
  • .gif : GIF
  • .img : ERDAS IMAGINE
  • .jpg : JPEG
  • .jp2 : JPEG 2000
  • .png : PNG
  • .tif : TIFF
  • Aucune extension pour Grid Esri

Pour enregistrer un jeu de données raster dans une géodatabase, n'ajoutez pas d'extension de fichier au nom du jeu de données raster.

Lorsque vous enregistrez un jeu de données raster dans un fichier JPEG, un fichier JPEG 2000, un fichier TIFF ou une géodatabase, vous pouvez spécifier un type de compression et une qualité de compression dans les environnements de géotraitement.

String
coordinate_system_for_the_raster
(Facultatif)

Système de coordonnées du jeu de données raster en sortie.

Coordinate System
pixel_type
(Facultatif)

Profondeur des couleurs, ou résolution radiométrique, de la mosaïque.

Si vous ne définissez pas le type de pixel, la valeur par défaut de 8 bits est appliquée et la sortie obtenue risque d'être incorrecte.

  • 1_BITEntier non signé 1 bit. Les valeurs peuvent être 0 ou 1.
  • 2_BITEntier non signé 2 bits. Les valeurs prises en charge s'échelonnent de 0 à 3.
  • 4_BITEntier non signé 4 bits. Les valeurs prises en charge s'échelonnent de 0 à 15.
  • 8_BIT_UNSIGNEDType de données 8 bits non signé. Les valeurs prises en charge s'échelonnent de 0 à 255.
  • 8_BIT_SIGNEDType de données 8 bits signé. Les valeurs prises en charge sont comprises entre -128 et 127.
  • 16_BIT_UNSIGNEDType de données 16 bits non signé. Les valeurs s'échelonnent de 0 à 65 535.
  • 16_BIT_SIGNEDType de données 16 bits signé. Les valeurs s'échelonnent de -32 768 à 32 767.
  • 32_BIT_UNSIGNEDType de données 32 bits non signé. Les valeurs s'échelonnent de 0 à 4 294 967 295.
  • 32_BIT_SIGNEDType de données 32 bits signé. Les valeurs s'échelonnent de -2 147 483 648 à 2 147 483 647.
  • 32_BIT_FLOATType de données 32 bits prenant en charge les décimales.
  • 64_BITType de données 64 bits prenant en charge les décimales.
String
cellsize
(Facultatif)

Taille de cellule du nouveau jeu de données raster.

Double
number_of_bands

Nombre de canaux que va détenir le raster en sortie.

Long
mosaic_method
(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.
  • 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.

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

String
mosaic_colormap_mode
(Facultatif)

S'applique lorsque les jeux de données raster en entrée possèdent une palette de couleurs.

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

Sortie dérivée

NomExplicationType de données
output_raster_dataset

Jeu de données raster en sortie.

Jeu de données raster

Exemple de code

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

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

import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.MosaicToNewRaster_management("land1.tif;land2.tif", "Mosaic2New", \
                                   "landnew.tif", "World_Mercator.prj",\
                                   "8_BIT_UNSIGNED", "40", "1", "LAST","FIRST")
Exemple 2 d'utilisation de l'outil MosaicToNewRaster (script autonome)

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

##==================================
##Mosaic To New Raster
##Usage: MosaicToNewRaster_management inputs;inputs... output_location raster_dataset_name_with_extension 
##                                    {coordinate_system_for_the_raster} 8_BIT_UNSIGNED | 1_BIT | 2_BIT | 4_BIT 
##                                    | 8_BIT_SIGNED | 16_BIT_UNSIGNED | 16_BIT_SIGNED | 32_BIT_FLOAT | 32_BIT_UNSIGNED 
##                                    | 32_BIT_SIGNED | | 64_BIT {cellsize} number_of_bands {LAST | FIRST | BLEND  | MEAN 
##                                    | MINIMUM | MAXIMUM} {FIRST | REJECT | LAST | MATCH}                               

import arcpy
arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"

##Mosaic several TIFF images to a new TIFF image
arcpy.MosaicToNewRaster_management("landsatb4a.tif;landsatb4b.tif","Mosaic2New", "landsat.tif", "World_Mercator.prj",\
                                   "8_BIT_UNSIGNED", "40", "1", "LAST","FIRST")

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes