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

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)

El método utilizado para las áreas de superposición del mosaico.

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

El método utilizado 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.
  • MATCHConsiderará todos los mapas de color al realizar mosaicos. Si todos los valores posibles ya están en uso (para la profundidad de bit), 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)

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.

  • 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