Resumen
Crea mosaicos del contenido de un catálogo de ráster en un dataset ráster nuevo.
Uso
Esta herramienta le permite convertir su catálogo de ráster de geodatabase en un dataset ráster; la entrada en un catálogo ráster y la salida es un dataset ráster nuevo. Esta herramienta no puede crear mosaicos de datos en un dataset ráster existente.
El uso de un dataset ráster en mosaico ofrece varias ventajas: tiende a visualizarse más rápido a cualquier escala, ahorra espacio ya que no hay datos superpuestos y los datos tienden a visualizarse con menos uniones.
Debe establecer el tipo de píxel para que coincida con los datasets ráster de entrada existentes. Si no define 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, MRF, CRF o en cualquier 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.
Las áreas superpuestas del mosaico se pueden manipular de varias maneras; por ejemplo, puede configurar la herramienta para mantener solo los datos del primer dataset ráster, o puede combinar los valores de celda superpuestos. Existen también diversas opciones para determinar cómo controlar un mapa de color si el dataset ráster utiliza uno. Por ejemplo, puede mantener el mapa de color del último dataset ráster utilizado en el mosaico.
Para crear mosaicos con datos discretos, las opciones de Operador de mosaico Primero, Mínimo o Máximo, brindarán los resultados más significativos. Las opciones de Operador de mosaico Combinar y Media son las más apropiadas para datos continuos.
Siempre que sea posible, utilice el Último operador de mosaico para crear un mosaico de los datasets ráster en un dataset ráster existente de una geodatabase de archivos o geodatabase corporativa; es con diferencia la manera más efectiva de crear un mosaico.
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.
Para datasets ráster de entrada de punto flotante con distintas resoluciones o cuando las celdas no están alineadas, se recomienda realizar un remuestreo de todos los datos mediante la interpolación bilineal o convolución cúbica antes de ejecutar Mosaico, de lo contrario, Mosaico realizará un remuestreo de los datasets ráster de manera automática utilizando un remuestreo de vecino más próximo, el cual no es adecuado para tipos de datos continuos.
La correspondencia del color y la corrección del color se pueden utilizar para hacer que el ráster de mosaico tenga menos interrupciones.
Sintaxis
arcpy.management.RasterCatalogToRasterDataset(in_raster_catalog, out_raster_dataset, {where_clause}, {mosaic_type}, {colormap}, {order_by_field}, {ascending}, {pixel_type}, {ColorBalancing}, {MatchingMethod}, {ReferenceRaster}, {OID})| Parámetro | Explicación | Tipo de datos |
in_raster_catalog | Catálogo de ráster del cual se creará un mosaico a un dataset ráster. | Raster Catalog Layer |
out_raster_dataset | Nombre y extensión del mosaico del dataset ráster de salida. 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 se deberá agregar 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. | Raster Dataset |
where_clause (Opcional) | Introduzca la declaración SQL adecuada para seleccionar filas específicas en el catálogo de ráster. | SQL Expression |
mosaic_type (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 |
colormap (Opcional) | El método utilizado para elegir qué mapa de color de los rásteres de entrada se aplicará a la salida del mosaico.
Para obtener más información acerca de cada uno de los modos de mapa de color, consulte el tema de ayuda Modo 'Colormap' para el mosaico. | String |
order_by_field (Opcional) | Defina el campo según el cual se ordenarán los elementos del catálogo de ráster. | String |
ascending (Opcional) | Elija si se debe usar el valor ascendente de order_by_field. Si no se utiliza la opción ascendente, se utilizará el orden descendente.
| Boolean |
pixel_type (Opcional) | Determina la profundidad de bit del dataset ráster de salida. Si no se especifica, la profundidad de bit de salida será igual que la de la entrada. No se producirá un reescalamiento de los valores ráster cuando se elija un tipo de píxel diferente. Si el tipo de píxel se degrada (se lo baja), los valores ráster que estén fuera del rango válido para esa profundidad de píxel se truncarán y se perderán.
| String |
ColorBalancing (Opcional) | Elija si desea o no utilizar una técnica de sobreexposición para corregir el color de los elementos del catálogo de ráster. Todos los píxeles del catálogo de ráster se usarán para determinar los valores de contraste y gamma para el algoritmo de balance de color.
| Boolean |
MatchingMethod (Opcional) | Elija el método de geocodificación de color para aplicar a los rásteres.
| String |
ReferenceRaster (Opcional) | Si se aplica geocodificación de color, elija cómo se debe especificar el ráster de referencia.
| String |
OID (Opcional) | El Id. de objeto (OID) del ráster de referencia. El OID es un campo clave único en el catálogo de ráster. | Long |
Muestra de código
Ejemplo 1 de RasterCatalogToRasterDataset (ventana de Python)
Esta es una muestra de Python para la herramienta RasterCatalogToRasterDataset.
import arcpy
arcpy.RasterCatalogToRasterDataset_management("c:/data/fgdb.gdb/catalog1",
"c:/data/dataset.tif",
"OBJECTID>1", "LAST", "FIRST",
"", "", "8_BIT_UNSIGNED",
"COLOR_BALANCING",
"HISTOGRAM_MATCHING",
"CALCULATE_FROM_ALL", "")
Ejemplo 2 de RasterCatalogToRasterDataset (secuencia de comandos independiente)
Esta es una muestra de la secuencia de comandos de Python para la herramienta RasterCatalogToRasterDataset.
##==================================
##Raster Catalog To Raster Dataset
##Usage: RasterCatalogToRasterDataset_management in_raster_catalog out_raster_dataset {where_clause} {LAST | FIRST | MINIMUM | MAXIMUM
## | MEAN | BLEND} {FIRST | REJECT | LAST | MATCH} {order_by_field} {NONE | ASCENDING}
## {8_BIT_UNSIGNED | 1_BIT | 2_BIT | 4_BIT | 8_BIT_SIGNED | 16_BIT_UNSIGNED |
## 16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT | 64_BIT}
## {NONE | COLOR_BALANCING} {NONE | STATISTIC_MATCHING | HISTOGRAM_MATCHING
## | LINEARCORRELATION_MATCHING} {CACULATE_FROM_ALL | SPECIFY_OID | DEFINE_FROM_SELECTION}
## {OID}
import arcpy
arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"
##Mosaic a Unmanaged Raster Catalog to a TIFF format Raster Dataset with Color Correction
arcpy.RasterCatalogToRasterDataset_management("RC2RD\\fgdb.gdb\\catalog1","RC2RD\\dataset1.tif", "OBJECTID>1", "LAST", "FIRST", "", "",\
"8_BIT_UNSIGNED", "COLOR_BALANCING", "HISTOGRAM_MATCHING", "CALCULATE_FROM_ALL", "")
##Mosaic using the According Order of cretain Field
arcpy.RasterCatalogToRasterDataset_management("RC2RD\\fgdb.gdb\\catalog2","RC2RD\\dataset2.tif", "", "LAST", "FIRST", "POPULATION", \
"ASCENDING", "8_BIT_UNSIGNED", "COLOR_BALANCING", "HISTOGRAM_MATCHING", "SPECIFY_OID", "2")
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí