De mosaico a nuevo ráster (Administración de datos)

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

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:

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

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

  • FIRSTEl 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.
  • LASTEl 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.
  • BLENDEl 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.
  • MEANEl valor de la celda de salida de las áreas superpuestas será el valor promedio de las celdas superpuestas.
  • MINIMUMEl valor de la celda de salida de las áreas superpuestas será el valor mínimo de las celdas superpuestas.
  • MAXIMUMEl valor de la celda de salida de las áreas superpuestas será el valor máximo de las celdas superpuestas.
  • SUMEl 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.

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.

  • FIRSTEl 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.
  • LASTEl mapa de color del último dataset ráster en la lista se aplicará al mosaico del ráster de salida.
  • MATCHTodos los mapas de color se tendrán en cuenta al crear mosaicos. Si todos los valores posibles ya están en uso (para la profundidad de bit), la herramienta intentará hacer coincidir el valor con el color más parecido disponible.
  • REJECTSolo 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")

Información de licenciamiento

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

Temas relacionados