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ètre | Explication | Type 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 :
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.
| 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.
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.
| String |
Sortie dérivée
| Nom | Explication | Type de données |
| output_raster_dataset | Jeu de données raster en sortie. | Jeu de données raster |
Exemple de code
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")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")Environnements
- Etendue
Non valide pour les géodatabases d'entreprise
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?