ArcMap

Generar colección de ráteres

Resumen

Realiza procesamiento o análisis por lotes en colecciones de imágenes contenidas en un dataset de mosaico. Las imágenes del dataset de mosaico de entrada se pueden procesar individualmente o por grupos.

Es posible definir las reglas de procesamiento mediante el parámetro Builder de colección y los parámetros de función ráster. Genera un nuevo dataset de mosaico de imágenes procesadas. También puede guardar las imágenes procesadas en un disco, como archivos separados. La condición predeterminada es incorporar la función ráster de entrada a la cadena de funciones de las imágenes existentes del dataset de mosaico y agregarla al dataset de mosaico de salida.

Uso

  • La salida de esta herramienta es un dataset de mosaico con la plantilla de función ráster (RFT) aplicada a cada elemento de ráster. Dado que los parámetros opcionales afectan a la salida, debe definir correctamente los parámetros para obtener la salida correcta.

  • Si desea generar archivos de imágenes separados con una RFT aplicada, debe definir un espacio de trabajo de salida. Es posible crear una RFT mediante el Editor de funciones ráster.

Sintaxis

arcpy.management.GenerateRasterCollection(out_raster_collection, collection_builder, collection_builder_arguments, {raster_function}, {raster_function_arguments}, {collection_properties}, {generate_rasters}, {out_workspace}, {format}, {out_base_name})
ParámetroExplicaciónTipo de datos
out_raster_collection

La ruta completa del dataset de mosaico que se creará. El dataset de mosaico se debe almacenar en una geodatabase.

Mosaic Dataset
collection_builder

La colección de imágenes de entrada. Se puede ver como una plantilla que contiene argumentos tales como la ruta del dataset de mosaico de origen, filtros para extraer un subconjunto de la fuente de datos de entrada, etc.

Actualmente, esta herramienta solo admite SIMPLE_COLLECTION, que permite definir una única fuente de datos y un filtro de consulta, para la fuente de datos.

  • SIMPLE_COLLECTION —Permite definir una fuente de datos y un filtro de consulta.
String
collection_builder_arguments
[[Name, Value],...]

La lista de argumentos para crear una colección de subconjuntos del dataset de mosaico.

Esta herramienta solo admite la fuente de datos y el filtro para crear un subconjunto del dataset de mosaico. Los valores DataSource y WhereClause se deben completar; de lo contrario, la herramienta no se ejecutará.

  • DataSource —La ruta de la fuente de datos.
  • WhereClause —El filtro utilizado para crear un subconjunto del dataset de mosaico.
Value Table
raster_function
(Opcional)

La ruta a un archivo de plantilla de función ráster (.rft.xml o .rft.json). La plantilla de función ráster se aplicará a todos los elementos del dataset de mosaico de entrada. Puede utilizar el Editor de funciones para crear la plantilla. Si no se define ninguna RFT, esta herramienta creará el mosaico de salida según el parámetro collection_builder_arguments.

String; File
raster_function_arguments
[[Name, Value],...]
(Opcional)

Los parámetros asociados con la cadena de funciones.

Por ejemplo, si la cadena de funciones aplica la función NDVI, defina los Id. visibles e de infrarrojos. El nombre de la variable ráster de la RFT debería ser el valor de campo Tag de la fuente de datos de entrada.

Value Table
collection_properties
[[Name, Value],...]
(Opcional)

Las propiedades clave del dataset de mosaico de salida.

Las propiedades de metadatos clave que hay disponibles dependen del tipo de sensor que capturó las imágenes. A continuación, se indican algunos ejemplos de propiedades de metadatos clave:

  • SensorName
  • ProductName
  • AcquisitionDate
  • CloudCover
  • SunAzimuth
  • SunElevation
  • SensorAzimuth
  • SensorElevation
  • Off-nadirAngle
  • BandName
  • MinimumWavelength
  • MaximumWavelength
  • RadianceGain
  • RadianceBias
  • SolarIrradiance
  • ReflectanceGain
  • ReflectanceBias

Value Table
generate_rasters
(Opcional)

Elija generar archivos de dataset ráster de los elementos del dataset de mosaico tras la aplicación de la RFT.

  • NO_GENERATE_RASTERS —El procesamiento definido por la plantilla de función ráster se incorporará a los elementos de imagen desde la fuente de datos de entrada, para producir un elemento de imagen en el dataset de mosaico de salida. Esta es la opción predeterminada.
  • GENERATE_RASTERS —Crear datasets ráster en el disco. También deberá especificar el out_workspace y el format.
Boolean
out_workspace
(Opcional)

Define la ubicación de salida de los datasets ráster persistentes, si el parámetro generate_rasters tiene el valor GENERATE_RASTERS.

El formato de nombre de los archivos ráster de salida es oid_<oid#>_<Unique_GUID>.

Folder; String
format
(Opcional)

El tipo de formato del ráster que se generará.

  • TIFF —Formato de archivo de imagen con etiquetas (TIFF)
  • IMAGINE Image —Archivo ERDAS IMAGINE
  • CRF —Formato de ráster de nube. Esta es la opción predeterminada.
  • MRF —Formato metarráster
String
out_base_name
(Opcional)

Define el nombre de base de salida de los datasets ráster persistentes, si el parámetro generate_rasters tiene el valor GENERATE_RASTERS.

String

Muestra de código

Ejemplo de GenerateRasterCollection (script independiente)

Este es un script de Python para la herramienta GenerateRasterCollection.

import arcpy
arcpy.GenerateRasterCollection_management(
    out_raster_collection="c:/temp/FGDB.gdb/testgencollection", 
    collection_builder="Simple Collection", 
    collection_builder_arguments="# DataSource c:\temp\FGDB.gdb\qb_portland;# 
WhereClause 'Tag = 'MS''", 
    raster_function="C:/temp/NDVI_test.rft.json", 
    raster_function_arguments="# MS #;# VisibleBandID_20171019_7337_958 1;# 
InfraredBandID_20171019_7337_958 4", 
    collection_properties="", 
    generate_rasters="GENERATE_RASTERS", 
    out_workspace="c:/temp/persistedoutput", 
    format="CRF"
)

Entornos

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados