ArcMap

De mosaico a nuevo ráster

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.

  • Al trabajar con un número grande de datasets ráster, la herramienta Catálogo de ráster a dataset ráster funciona de manera más eficiente.

  • 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 que elija para crear el mosaico. En este caso, utilice la herramienta Mosaico para los rásteres con distintos mapas de color; sin embargo, debe elegir el operador Modo 'Colormap' para el mosaico específico. Si se elige un modo de mapa de color que no es el adecuado, puede que la salida no resulte como usted esperaba.

  • 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ámetroExplicaciónTipo 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.

Composite Layer; Mosaic Dataset; Raster Dataset; Raster Layer
output_location

La ruta que contendrá el dataset ráster. La ruta puede ser a una carpeta o una geodatabase.

Workspace; Raster Catalog
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:

  • .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
  • Ninguna extensión para Cuadrícula de Esri

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. Si no se especifica, se utilizará la configuración del entorno del Sistema de coordenadas 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.

  • 1_BIT —Un entero sin signo de 1 bit. Los valores pueden ser 0 o 1.
  • 2_BIT —Un entero sin signo de 2 bit. Los valores admitidos son del 0 al 3.
  • 4_BIT —Un entero sin signo de 4 bit. Los valores admitidos son del 0 al 15.
  • 8_BIT_UNSIGNED —Un tipo de dato sin signo de 8 bits. Los valores admitidos son del 0 al 255.
  • 8_BIT_SIGNED —Un tipo de dato con signo de 8 bits. Los valores admitidos son de -128 a 127.
  • 16_BIT_UNSIGNED —Un tipo de dato sin signo de 16 bits. Los valores pueden variar del 0 al 65.535.
  • 16_BIT_SIGNED —Un tipo de dato con signo de 16 bits. Los valores pueden variar del -32.768 al 32.767.
  • 32_BIT_UNSIGNED —Un tipo de dato sin signo de 32 bits. Los valores pueden variar de 0 a 4.294.967.295.
  • 32_BIT_SIGNED —Un tipo de dato con signo de 32 bits. Los valores pueden variar de -2.147.483.648 a 2.147.483.647.
  • 32_BIT_FLOAT —Un tipo de dato de 32 bits que admite decimales.
  • 64_BIT —Un tipo de dato de 64 bits que admite decimales.
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.

  • FIRST —El valor de la celda de salida de las áreas superpuestas será el valor del primer dataset ráster del que se creó un mosaico en dicha ubicación.
  • LAST —El valor de la celda de salida de las áreas superpuestas será el valor del último dataset ráster del que se creó un mosaico en dicha ubicación. Esta es la opción predeterminada.
  • BLEND —El valor de la celda de salida de las áreas superpuestas será un cálculo ponderado horizontalmente de los valores de las celdas en el área superpuesta.
  • MEAN —El valor de la celda de salida de las áreas superpuestas será el valor promedio de las celdas superpuestas.
  • MINIMUM —El valor de la celda de salida de las áreas superpuestas será el valor mínimo de las celdas superpuestas.
  • MAXIMUM —El valor de la celda de salida de las áreas superpuestas será el valor máximo de las celdas superpuestas.
  • SUM —El valor de la celda de salida de las áreas superpuestas será la suma total de las celdas superpuestas.

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.

El método utilizado para elegir qué mapa de color de los rásteres de entrada se aplicará a la salida del mosaico.

  • FIRST —El mapa de color del primer dataset ráster en la lista se aplicará al mosaico del ráster de salida. Esta es la opción predeterminada.
  • LAST —El mapa de color del último dataset ráster en la lista se aplicará al mosaico del ráster de salida.
  • MATCH —Considerará todos los mapas de color al realizar mosaicos. Si todos los valores posibles ya están en uso (para la profundidad de bit), intentará hacer coincidir el valor con el color más parecido disponible.
  • REJECT —Solo se realizará un mosaico de los datasets ráster que no tienen un mapa de color asociado.
String

Salida derivada

NombreExplicaciónTipo de datos
output_raster_dataset

El dataset ráster de salida.

Dataset ráster

Muestra de código

Ejemplo 1 de MosaicToNewRaster (ventana de Python)

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")
Ejemplo 2 de MosaicToNewRaster (script independiente)

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

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados