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 Primero, Mínimo o Máximo de Operador de mosaico brindarán los resultados más significativos. Las opciones 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 los datasets ráster de entrada de punto flotante de diferentes resoluciones o cuando las celdas no están alineadas, se recomienda volver a muestrear todos los datos utilizando interpolación bilineal o convolución cúbica antes de ejecutar Mosaico. De lo contrario, Mosaico volverá a muestrear automáticamente los datasets ráster utilizando el remuestreo de vecino más cercano, que no es adecuado para los 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) | Especifique el método que se utilizará para crear un mosaico de áreas superpuestas.
| String |
colormap (Opcional) | 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 |
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, 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) | Al crear el mosaico, los píxeles de destino y de origen no siempre se alinean con exactitud. Cuando hay una desalineación de píxeles, debe decidir si desea remuestrear o intercambiar los datos. La tolerancia de mosaico controla si se realizará el remuestreo de los píxeles o si estos se desplazarán. 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 realizará 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 realizará remuestreo y se llevará a cabo un intercambio. La unidad de tolerancia es un píxel, con un rango de valores válido de 0 a 0,5. Una tolerancia de 0,5 garantizará el intercambio. Una tolerancia de cero garantizará 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, el remuestreo ocurrirá debido a que la diferencia de alineación de píxeles es mayor que la tolerancia. Si la tolerancia de mosaico está configurada como 0,3, los píxeles cambiará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
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", "")
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
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí