Generar colección de ráteres (Administración de datos)

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.

Parámetros

EtiquetaExplicaciónTipo de datos
Captura de rásteres de salida

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

Mosaic Dataset
Builder de captura

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 la Colección individual, que permite definir una única fuente de datos y un filtro de consulta, para la fuente de datos.

  • Colección individualPermite definir una fuente de datos y un filtro de consulta.
String
Argumentos de builder de captura

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 Fuente de datos y Cláusula WHERE se deben completar; de lo contrario, la herramienta no se ejecutará.

  • Fuente de datosLa ruta de la fuente de datos.
  • Cláusula WhereEl filtro utilizado para crear un subconjunto del dataset de mosaico.
Value Table
Introducir función ráster
(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 Argumentos de builder de colección.

String; File
Argumentos de la función de ráster
(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
Propiedades de captura de rásteres
(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
Generar rásteres
(Opcional)

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

  • Desactivado: 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.
  • Activado: cree datasets ráster en el disco. También deberá especificar el Espacio de trabajo de ráster de salida y el Formato.

Boolean
Espacio de trabajo de ráster de salida
(Opcional)

Define la ubicación de salida de los datasets ráster persistentes, si el parámetro Generar rásteres está activado.

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

Folder; String
Formato
(Opcional)

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

  • TiffFormato de archivo de imagen con etiquetas (TIFF)
  • ERDAS IMAGINEArchivo ERDAS IMAGINE
  • CRFFormato de ráster de nube. Esta es la opción predeterminada.
  • MRFFormato metarráster
String
Nombre de base de salida
(Opcional)

Define el nombre de base de salida de los datasets ráster persistentes, si el parámetro Generar rásteres está activado. Varias salidas de datasets ráster tendrán un alias numérico incorporado a su nombre de base.

El dataset de mosaico resultante hará referencia al CRF directamente sin mantener la cadena de función ráster.

String

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})
NombreExplicació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_COLLECTIONPermite 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á.

  • DataSourceLa ruta de la fuente de datos.
  • WhereClauseEl 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_RASTERSEl 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_RASTERSCrear 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á.

  • TIFFFormato de archivo de imagen con etiquetas (TIFF)
  • IMAGINE ImageArchivo ERDAS IMAGINE
  • CRFFormato de ráster de nube. Esta es la opción predeterminada.
  • MRFFormato 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"
)