Resumen
Fusiona todos los datasets ráster de una carpeta en un dataset ráster.
Uso
El dataset ráster de destino debe existir previamente para que la herramienta funcione.
Si el dataset ráster de destino no existe previamente, utilice la herramienta Crear dataset ráster para crear un dataset ráster nuevo.
Cuando se lleve a cabo la creación de mosaicos, deberá especificar el método de mosaico y el modo de mapa de color que desea utilizar.
Si el dataset ráster de destino es un dataset ráster vacío, se aplicará al mosaico el tamaño de celda y la referencia espacial del primer dataset ráster de entrada.
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 en una geodatabase de archivos o geodatabase corporativa; es la manera más efectiva de crear un mosaico, sin lugar a dudas.
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.
La flecha desplegable del método de concordancia de color le permite elegir un algoritmo para hacer coincidir el color de los datasets en el mosaico.
Para rásteres basados en archivos, se debe establecer Ignorar valor de fondo en el mismo valor que NoData para que se ignore el valor de fondo. Los rásteres de geodatabase funcionan sin este paso adicional.
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.
Sintaxis
arcpy.management.WorkspaceToRasterDataset(in_workspace, in_raster_dataset, {include_subdirectories}, {mosaic_type}, {colormap}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {mosaicking_tolerance}, {MatchingMethod}, {colormap_to_RGB})
Parámetro | Explicación | Tipo de datos |
in_workspace | La carpeta que contiene los datasets ráster que se van a fusionar. | Workspace |
in_raster_dataset | Dataset ráster existente en el que se van a fusionar todos los datasets ráster del espacio de trabajo de entrada. | Raster Dataset |
include_subdirectories (Opcional) | Especifique si desea incluir subdirectorios.
| Boolean |
mosaic_type (Opcional) | El método utilizado para las áreas de superposición del 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.
| String |
background_value (Opcional) | Utilice esta opción para quitar los valores no deseados que se crean alrededor de los datos ráster. El valor especificado se distinguirá de otros datos valiosos en el dataset ráster. Por ejemplo, un valor de cero a lo largo de los bordes del dataset ráster se distinguirá de los valores cero del dataset ráster. El valor de píxel especificado se establecerá como NoData en el dataset ráster de salida. Para rásteres basados en archivos y rásteres de geodatabase personal, se debe establecer Ignorar valor de fondo con el mismo valor que NoData para que se ignore el valor de fondo. Los rásteres de las geodatabases de archivos y corporativas funcionan sin este paso adicional. | Double |
nodata_value (Opcional) | Todos los píxeles con el valor especificado se establecerán como NoData en el dataset ráster de salida. | Double |
onebit_to_eightbit (Opcional) | Elija si el dataset ráster de entrada de 1 bit se convertirá a un dataset ráster de 8 bits. En esta conversión, el valor 1 en el dataset ráster de entrada se cambiará a 255 en el dataset ráster de salida. Esto es útil cuando se importa un dataset ráster de 1 bit a una geodatabase. Los datasets ráster de 1 bit tienen capas en pirámide de 8 bits cuando se almacenan en un sistema de archivos, pero en una geodatabase, los datasets ráster de 1 bit solo pueden tener capas en pirámide de 1 bit, lo que hace que la visualización no sea agradable. Al convertir los datos a 8 bits en una geodatabase, las capas en pirámide se crean como de 8 bits en lugar de 1 bit, lo que da como resultado un dataset ráster correcto en la visualización.
| Boolean |
mosaicking_tolerance (Opcional) | Cuando se crea el mosaico, los píxeles de destino y de origen no siempre se alinean con exactitud. Cuando se presenta una desalineación de los píxeles, debe decidir si se realiza un remuestreo o un desplazamiento de los datos. La tolerancia de mosaico controla si se realiza el remuestreo de los píxeles o si estos deben desplazarse. Si la diferencia en la alineación de píxeles (del dataset de origen y el dataset de destino) es mayor que la tolerancia, se realiza un remuestreo. Si la diferencia en la alineación de píxeles (del dataset de origen y el dataset de destino) es menor que la tolerancia, no se realiza remuestreo (en cambio, se realiza una conversión). La unidad de tolerancia es un píxel; donde el rango de valores válido es de 0 a 0,5. Una tolerancia de 0.5 garantizará que se lleve a cabo un cambio. Una tolerancia de cero garantiza un remuestreo, si existe una alineación incorrecta de los píxeles. Por ejemplo, los píxeles de origen y de destino tienen una diferencia de alineación de 0,25. Si la tolerancia de mosaico está configurada como 0,2, se llevará a cabo un remuestreo ya que la diferencia de alineación de píxeles es mayor que la tolerancia. Si la tolerancia mosaico está configurada como 0,3, los píxeles se convertirán. | Double |
MatchingMethod (Opcional) | El método de concordancia de color que se va a aplicar a los rásteres.
| String |
colormap_to_RGB (Opcional) | Si el dataset ráster de entrada tiene un mapa de color, el dataset ráster de salida se puede convertir a un dataset ráster de salida de tres bandas. Esto es útil cuando se crean mosaicos de rásteres con diferentes mapas de color.
| Boolean |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_raster_dataset | El dataset ráster actualizado. | Dataset ráster |
Muestra de código
Ejemplo 1 de WorkspaceToRasterDataset (ventana de Python)
Esta es una muestra de Python para la herramienta WorkspaceToRasterDataset.
import arcpy
arcpy.WorkspaceToRasterDataset_management("c:/data/WS2RD", "c:/fgdb.gdb/outdats",
"INCLUDE_SUBDIRECTORIES", "LAST",
"FIRST", "0", "9", "", "",
"HISTOGRAM_MATCHING", "")
Ejemplo 2 de WorkspaceToRasterDataset (script independiente)
Esta es una muestra del script de Python para la herramienta WorkspaceToRasterDataset.
##==================================
##Workspace To Raster Dataset
##Usage: WorkspaceToRasterDataset_management in_workspace in_raster_dataset {NONE | INCLUDE_SUBDIRECTORIES}
## {LAST | FIRST | BLEND | MEAN | MINIMUM | MAXIMUM} {FIRST | REJECT
## | LAST | MATCH} {background_value} {nodata_value} {NONE | OneBitTo8Bit}
## {mosaicking_tolerance} {NONE | STATISTIC_MATCHING | HISTOGRAM_MATCHING
## | LINEARCORRELATION_MATCHING} {NONE | ColormapToRGB}
import arcpy
arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"
##Mosaic images to File Geodatabase Raster Dataset with Background and Nodata setting and Color Correction
arcpy.WorkspaceToRasterDataset_management("WS2RD", "fgdb.gdb\\dataset", "INCLUDE_SUBDIRECTORIES", "LAST", \
"FIRST", "0", "9", "", "", "HISTOGRAM_MATCHING", "")
##Mosaic Colormap image to RGB image
arcpy.WorkspaceToRasterDataset_management("WS2RD_clr","fgdb.gdb\\dataset2", "INCLUDE_SUBDIRECTORIES", "LAST",\
"FIRST", "", "", "", "0.3", "", "ColormapToRGB")
Entornos
Esta herramienta no utiliza ningún entorno de geoprocesamiento.
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí
Temas relacionados
- Información general sobre el conjunto de herramientas Ráster
- Configurar el entorno para datos ráster
- ¿Qué es un mosaico?
- ¿Qué herramientas de mosaicos están disponibles en ArcGIS?
- Operadores de mosaico
- Opciones para la creación de mosaicos con mapas de color
- Utilizar el botón Mosaico en la ventana Análisis de imagen
- Corregir colores en datos ráster