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.

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ámetroExplicaciónTipo 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.

  • NONENo incluye subdirectorios. Esta es la opción predeterminada.
  • INCLUDE_SUBDIRECTORIESIncluye todos los datasets ráster de los subdirectorios durante la carga.
Boolean
mosaic_type
(Opcional)

Especifique el método que se utilizará para crear un mosaico de áreas superpuestas.

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

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

  • NONENo se realizará ninguna conversión. Esta es la opción predeterminada.
  • OneBitTo8BitEl 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.

  • NONEEsta opción no utilizará la operación de correspondencia del color al realizar un mosaico de los datasets ráster.
  • STATISTIC_MATCHINGMediante 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_MATCHINGMediante 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_MATCHINGMediante 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)

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.

  • NONENo se producirá ninguna conversión. Esta es la opción predeterminada.
  • ColormapToRGBEl dataset de entrada se convertirá.
Boolean

Salida derivada

NombreExplicaciónTipo 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