Espacio de trabajo a dataset ráster (Gestión de datos)

Nivel de licencia:BasicStandardAdvanced

Resumen

Crea mosaicos de todos los datasets ráster almacenados dentro de un espacio de trabajo específico en un dataset ráster.

Uso

Sintaxis

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

Espacio de trabajo que contiene todos los datasets ráster con los que se creará un mosaico en el dataset ráster.

Workspace
in_raster_dataset

Dataset ráster que tendrá todos los rásteres del espacio de trabajo con los que se creará un mosaico. El dataset ráster debe existir previamente.

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

Para obtener más información acerca de cada uno de los operadores de mosaico, consulte el tema de ayuda Operador de 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.

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

Para obtener más información acerca de cada uno de los modos de mapa de color, consulte el tema de ayuda Modo 'Colormap' para el 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 dentro 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 geodatabase de archivos y de ArcSDE 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 ArcSDE. Los datasets ráster de 1 bit tienen capas en pirámide de 8 bits cuando se los almacena en un sistema de archivos, pero en ArcSDE 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 ArcSDE, 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)

Elija el método de geocodificación de color para 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.
  • STATISTICS_MATCHINGPor medio de este método, se hacen coincidir las diferencias estadísticas (mínimo, máximo y media) entre el área de superposición de referencia y el área de superposición de origen; después la transformación se aplicará a todo el dataset de destino.
  • HISTOGRAM_MATCHINGPor medio de este método, el histograma del área de superposición de referencia coincide con el área de superposición de origen; después la transformación se aplicará a todo el destino.
  • LINEARCORRELATION_MATCHINGEste método hace coincidir píxeles superpuestos y realiza la interpolación al resto del origen; los píxeles que no tienen 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

Ejemplo 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 (secuencia de comandos independiente)

Esta es una secuencia de comandos de muestra 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}
try:
    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")
except:
    print "Workspace To Raster Dataset example failed."
    print arcpy.GetMessages()

Entornos

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: Sí
ArcGIS for Desktop Standard: Sí
ArcGIS for Desktop Advanced: Sí
5/12/2014