De espacio de trabajo a dataset ráster (Administración de datos)

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.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Espacio de trabajo de entrada	La carpeta que contiene los datasets ráster que se van a fusionar.	Workspace
Dataset ráster objetivo	Dataset ráster existente en el que se van a fusionar todos los datasets ráster del espacio de trabajo de entrada.	Raster Dataset
Incluir subdirectorios (Opcional)	Especifica si se incluirán subdirectorios. Desactivado: no se incluirán subdirectorios. Esta es la opción predeterminada. Activado: todos los datasets ráster en los subdirectorios se incluirán al cargar.	Boolean
Operador de mosaico (Opcional)	Especifique el método que se utilizará para crear un mosaico de áreas superpuestas. 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.	String
Modo 'Colormap' para el Mosaico (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. 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—Todos 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. REJECT—Solo se realizará un mosaico de los datasets ráster que no tienen un mapa de color asociado.	String
Ignorar valor de fondo (Opcional)	Elimine 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.	Double
Valor NoData (Opcional)	Todos los píxeles con el valor especificado se establecerán como NoData en el dataset ráster de salida.	Double
Convierte datos de 1 bit en 8 bit (Opcional)	Especifica 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 de 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 de pirámide de 1 bit, lo que hace que la visualización sea de poca calidad. 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. Desactivada: no se producirá ninguna conversión. Esta es la opción predeterminada. Activada: el ráster de entrada se convertirá.	Boolean
Tolerancia Mosaico (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
Método de concordancia de color (Opcional)	El método de concordancia de color que se va a aplicar a los rásteres. NONE—Esta opción no utilizará la operación de correspondencia del color al realizar un mosaico de los datasets ráster. STATISTIC_MATCHING—Mediante este método se utilizarán estadísticas descriptivas de las áreas superpuestas y, a continuación, se aplicará la transformación a todo el dataset de destino. HISTOGRAM_MATCHING—Mediante este método se cotejará el histograma del área de superposición de referencia con el área de superposición de origen y, a continuación, se aplicará la transformación a todo el dataset de destino. LINEARCORRELATION_MATCHING—Mediante este método se cotejarán los píxeles superpuestos y, a continuación, se interpolará el resto del dataset de origen; los píxeles que no tengan una relación de uno a uno utilizarán un promedio ponderado.	String
Mapa de color a RGB (Opcional)	Especifica si el dataset ráster de entrada se convertirá a un dataset ráster de salida de tres bandas si el dataset ráster de entrada incluye un mapa de color. Esto es útil cuando se crean mosaicos de rásteres con diferentes mapas de color. Desactivada: no se producirá ninguna conversión. Esta es la opción predeterminada. Activada: el dataset de entrada se convertirá.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Dataset ráster de destino actualizado	El dataset ráster actualizado.	Dataset ráster

Python

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})

Nombre	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)	Especifica si se incluirán subdirectorios. NONE—No se incluirán subdirectorios. Esta es la opción predeterminada. INCLUDE_SUBDIRECTORIES—Todos los datasets ráster en los subdirectorios se incluirán al cargar.	Boolean
mosaic_type (Opcional)	Especifique el método que se utilizará para crear un mosaico de áreas superpuestas. 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.	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. 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—Todos 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. REJECT—Solo se realizará un mosaico de los datasets ráster que no tienen un mapa de color asociado.	String
background_value (Opcional)	Elimine 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.	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)	Especifica 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 de 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 de pirámide de 1 bit, lo que hace que la visualización sea de poca calidad. 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. NONE—No se producirá ninguna conversión. Esta es la opción predeterminada. OneBitTo8Bit—El ráster de entrada se convertirá.	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. NONE—Esta opción no utilizará la operación de correspondencia del color al realizar un mosaico de los datasets ráster. STATISTIC_MATCHING—Mediante este método se utilizarán estadísticas descriptivas de las áreas superpuestas y, a continuación, se aplicará la transformación a todo el dataset de destino. HISTOGRAM_MATCHING—Mediante este método se cotejará el histograma del área de superposición de referencia con el área de superposición de origen y, a continuación, se aplicará la transformación a todo el dataset de destino. LINEARCORRELATION_MATCHING—Mediante este método se cotejarán los píxeles superpuestos y, a continuación, se interpolará el resto del dataset de origen; los píxeles que no tengan una relación de uno a uno utilizarán un promedio ponderado.	String
colormap_to_RGB (Opcional)	Especifica si el dataset ráster de entrada se convertirá a un dataset ráster de salida de tres bandas si el dataset ráster de entrada incluye un mapa de color. Esto es útil cuando se crean mosaicos de rásteres con diferentes mapas de color. NONE—No se producirá ninguna conversión. Esta es la opción predeterminada. ColormapToRGB—El dataset de entrada se convertirá.	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.