Resumen
Fusiona varios datasets ráster en un dataset ráster nuevo.
Uso
Los datasets ráster de entrada son todos los datasets ráster que desea incluir en un mismo mosaico. Las entradas deben tener la misma cantidad de bandas y la misma profundidad de bit; de otro modo, la herramienta se cerrará con un mensaje de error.
La herramienta Mosaico tiene más parámetros disponibles al combinar los datasets en un ráster existente, como opciones para ignorar el valor de fondo y los valores NoData.
Debe establecer el tipo de píxel para que coincida con los datasets ráster de entrada existentes. Si no establece el tipo de píxel, se utilizará el valor predeterminado de 8 bits y la salida puede ser incorrecta.
Puede guardar la salida en los formatos BIL, BIP, BMP, BSQ, DAT, cuadrícula de Esri, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF o en un dataset ráster de geodatabase.
Cuando se almacena el dataset ráster en un archivo JPEG, un archivo JPEG 2000 o una geodatabase, se puede especificar un Tipo de compresión y la Calidad de compresión en Entornos.
El formato GIF solo admite datasets ráster de banda única.
Al realizar un mosaico con datasets ráster que contienen mapas de color, es importante notar las diferencias entre los mapas de color de cada dataset ráster del mosaico. En este caso, utilice la herramienta Mosaico para los rásteres con distintos mapas de color; sin embargo, debe elegir el valor del parámetro Modo 'Colormap' para el mosaico adecuado. Si se elige un modo de mapa de color que no es el adecuado, puede que la salida no sea la esperada.
Esta herramienta no respeta la configuración del entorno Extensión de salida para las geodatabases corporativas. Si desea una extensión específica para el ráster de salida, considere utilizar la herramienta Recortar. Puede recortar los rásteres de entrada antes de utilizar esta herramienta o bien recortar la salida de esta herramienta.
Sintaxis
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})| Parámetro | Explicación | Tipo de datos |
input_rasters [input_raster,...] | Los datasets ráster que desea fusionar. Las entradas deben tener el mismo número de bandas y la misma profundidad de bit. | Mosaic Dataset; Raster Dataset; Raster Layer |
output_location | La carpeta o geodatabase donde se va a almacenar el ráster. | Workspace |
raster_dataset_name_with_extension | El nombre del dataset que va a crear. Al almacenar el dataset ráster en un formato de archivo, deberá especificar la extensión del archivo:
Cuando almacene un dataset ráster en una geodatabase, no agregue ninguna extensión de archivo al nombre del dataset ráster. Cuando almacene el dataset ráster en un archivo JPEG, un archivo JPEG 2000, un archivo TIFF o una geodatabase, puede especificar un Tipo de compresión y la Calidad de compresión en los Entornos. | String |
coordinate_system_for_the_raster (Opcional) | El sistema de coordenadas para el dataset ráster de salida. | Coordinate System |
pixel_type (Opcional) | Profundidad de bit o resolución radiométrica del dataset de mosaico. Si no establece el tipo de píxel, se utilizará el valor predeterminado de 8 bits y la salida puede ser incorrecta.
| String |
cellsize (Opcional) | El tamaño de celda para el nuevo dataset ráster. | Double |
number_of_bands | EL número de bandas que tendrá el ráster de salida. | Long |
mosaic_method (Opcional) | El método utilizado para las áreas de superposición del mosaico.
Para obtener más información acerca de cada uno de los operadores de mosaico, consulte el tema de ayuda Operador de mosaico. | String |
mosaic_colormap_mode (Opcional) | Se aplica cuando los datasets ráster de entrada tienen un mapa de coropletas. Especifique el método que se utilizará para elegir qué mapa de color de los rásteres de entrada se aplicará a la salida del mosaico.
| String |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| output_raster_dataset | El dataset ráster de salida. | Dataset ráster |
Muestra de código
Esta es una muestra de Python para la herramienta 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")Esta es una muestra del script de Python para la herramienta 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")Entornos
- Extensión
No es válido para la geodatabase corporativa
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí