Establecer las propiedades de ráster (Administración de datos)

Resumen

Define el tipo de datos, las estadísticas y los valores NoData de un dataset de mosaico o ráster.

Uso

  • Con esta herramienta puede definir las estadísticas para un dataset ráster o de mosaico. Por lo general, esta herramienta se utiliza cuando no se desea el cálculo de estadísticas. Puede configurar los valores mínimos, máximos, de desviación estándar y medios de cada banda. Estas estadísticas se pueden leer en un archivo .xml.

  • Las propiedades que se pueden establecer con esta herramienta determinan las opciones de representación en pantalla predeterminadas en ArcGIS Pro, así como las estadísticas que otras herramientas utilizan.

    Puede establecer las siguientes propiedades:

    • Tipo de fuente de datos: defina si los valores de celda representan los datos de categorías o de elevación, o si los valores se han procesado con otros métodos y no requieren extensión al visualizar los datos.
    • Estadísticas por banda: para cada banda, puede definir valores mínimos, máximos, medios y de desviación estándar.
    • Bandas para el valor NoData: para cada banda, puede definir un valor NoData.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de entrada

El dataset ráster o de mosaico con las propiedades que se van a establecer.

Mosaic Layer ; Raster Layer
Tipo de fuente de datos
(Opcional)

Especifica el tipo de imágenes en el dataset de mosaico.

  • GenéricoEl dataset de mosaico no tiene un tipo de datos especificado.
  • ElevaciónEl dataset de mosaico contiene datos de elevación.
  • TemáticoEl dataset de mosaico tiene datos temáticos, que tienen valores discretos, como la cobertura de suelo.
  • CientíficoLos datos incluyen información científica y se mostrarán de manera predeterminada con la rampa de color de azul a rojo.
  • UV de vectorLos datos son un ráster de dos bandas que contiene los componentes U y V de los datos de un campo vectorial.
  • Magnitud y direcciónLos datos son un ráster de dos bandas que contiene la magnitud y la dirección de los datos de un campo vectorial.
  • ProcesadoEl color del dataset de mosaico ya se ha equilibrado.
String
Estadísticas por banda
(Opcional)

Las bandas y los valores de mínimo, máximo, media y desviación estándar.

Value Table
Importar estadísticas desde el archivo
(Opcional)

Un archivo .xml que contiene las estadísticas.

File
Bandas para el valor NoData
(Opcional)

El valor NoData para cada banda. Cada banda puede tener definido un único valor NoData, o el mismo valor puede estar especificado para todas las bandas.

Haga clic en la flecha desplegable NoData, elija una banda de la lista y haga clic en el botón Agregar para agregar una banda a la tabla. A continuación, introduzca un valor o varios valores. Si elige varios valores NoData, separe cada valor con un espacio.

Value Table
Propiedades clave
(Opcional)

Las propiedades compatibles de forma nativa. Los datos pueden tener propiedades no incluidas en la siguiente lista. Las propiedades no distinguen mayúsculas y minúsculas.

  • AcquisitionDate
  • BandName
  • BlockName
  • CloudCover
  • DatasetTag
  • Dimensiones
  • FlowDirection
  • Huella
  • HighCellSize
  • LowCellSize
  • MinCellSize
  • MaxCellSize
  • OffNadir
  • ParentRasterType
  • ParentTemplate
  • PerspectiveX
  • PerspectiveY
  • PerspectiveZ
  • ProductName
  • RadianceBias
  • RadianceGain
  • ReflectanceBias
  • RefelctanceGain
  • Segmented
  • SensorAzimuth
  • SensorElevation
  • SensorName
  • SolarIrradiance
  • SourceBandIndex
  • StdPressure
  • StdPressure_Max
  • StdTemperature
  • StdTemperature_Max
  • StdTime
  • StdTime_Max
  • StdZ
  • StdZ_max
  • SunAzimuth
  • SunElevation
  • ThermalConstant_K1
  • ThermalConstant_K2
  • Variable
  • VerticalAccuracy
  • WavelengthMin
  • WavelengthMax
Value Table
Información multidimensional
(Opcional)

La información dimensional para el dataset ráster. La configuración de información dimensional convertirá el ráster adimensional en un ráster multidimensional.

Si la dimensión es tiempo, el nombre de la dimensión debe ser StdTime. El formato de tiempo es año-mes-día (2021-10-01) o año-mes-díaThh:mm:ss (2021-10-01T01:00:00).

Para definir una variable con tiempo y elevación, agregue primero la variable con tiempo; luego agregue la misma variable con la dimensión z.

Value Table

Salida derivada

EtiquetaExplicaciónTipo de datos
Dataset ráster actualizado

El dataset ráster de salida.

Raster Dataset

arcpy.management.SetRasterProperties(in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties}, {multidimensional_info})
NombreExplicaciónTipo de datos
in_raster

El dataset ráster o de mosaico con las propiedades que se van a establecer.

Mosaic Layer ; Raster Layer
data_type
(Opcional)

Especifica el tipo de imágenes en el dataset de mosaico.

  • GENERICEl dataset de mosaico no tiene un tipo de datos especificado.
  • ELEVATIONEl dataset de mosaico contiene datos de elevación.
  • THEMATICEl dataset de mosaico tiene datos temáticos, que tienen valores discretos, como la cobertura de suelo.
  • PROCESSEDEl color del dataset de mosaico ya se ha equilibrado.
  • SCIENTIFICLos datos incluyen información científica y se mostrarán de manera predeterminada con la rampa de color de azul a rojo.
  • VECTOR_UVLos datos son un ráster de dos bandas que contiene los componentes U y V de los datos de un campo vectorial.
  • VECTOR_MAGDIRLos datos son un ráster de dos bandas que contiene la magnitud y la dirección de los datos de un campo vectorial.
String
statistics
[[band_index, min, max, mean, std_dev],...]
(Opcional)

Las bandas y los valores de mínimo, máximo, media y desviación estándar.

Value Table
stats_file
(Opcional)

Un archivo .xml que contiene las estadísticas.

File
nodata
[[band index, nodata_value],...]
(Opcional)

El valor NoData para cada banda. Cada banda puede tener definido un único valor NoData, o el mismo valor puede estar especificado para todas las bandas. Para definir varios valores NoData para cada selección de bandas, utilice un delimitador de espacios entre cada valor NoData para el parámetro bands_for_nodata_value.

Value Table
key_properties
[key_properties,...]
(Opcional)

Las propiedades compatibles de forma nativa. Los datos pueden tener propiedades no incluidas en la siguiente lista. Las propiedades no distinguen mayúsculas y minúsculas.

  • AcquisitionDate
  • BandName
  • BlockName
  • CloudCover
  • DatasetTag
  • Dimensiones
  • FlowDirection
  • Huella
  • HighCellSize
  • LowCellSize
  • MinCellSize
  • MaxCellSize
  • OffNadir
  • ParentRasterType
  • ParentTemplate
  • PerspectiveX
  • PerspectiveY
  • PerspectiveZ
  • ProductName
  • RadianceBias
  • RadianceGain
  • ReflectanceBias
  • RefelctanceGain
  • Segmented
  • SensorAzimuth
  • SensorElevation
  • SensorName
  • SolarIrradiance
  • SourceBandIndex
  • StdPressure
  • StdPressure_Max
  • StdTemperature
  • StdTemperature_Max
  • StdTime
  • StdTime_Max
  • StdZ
  • StdZ_max
  • SunAzimuth
  • SunElevation
  • ThermalConstant_K1
  • ThermalConstant_K2
  • Variable
  • VerticalAccuracy
  • WavelengthMin
  • WavelengthMax
Value Table
multidimensional_info
[multidimensional_info,...]
(Opcional)

La información dimensional para el dataset ráster. La configuración de información dimensional convertirá el ráster adimensional en un ráster multidimensional.

Si la dimensión es tiempo, el nombre de la dimensión debe ser StdTime. El formato de tiempo es año-mes-día (2021-10-01) o año-mes-díaThh:mm:ss (2021-10-01T01:00:00).

Para definir una variable con tiempo y elevación, agregue primero la variable con tiempo; luego agregue la misma variable con la dimensión z.

Value Table

Salida derivada

NombreExplicaciónTipo de datos
out_raster

El dataset ráster de salida.

Raster Dataset

Muestra de código

Ejemplo 1 de SetRasterProperties (ventana de Python)

Esta es una muestra de Python para la función SetRasterProperties.

import arcpy
arcpy.SetRasterProperties_management("\\cpu\data\srtm.tif", "ELEVATION", 
                                     "1 50 400 5 28" , "#" , "#")
Ejemplo 2 de SetRasterProperties (script independiente)

Esta es una muestra de script de Python para la función SetRasterProperties.

#Set raster dataset type and statistics

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
arcpy.SetRasterProperties_management("srtmraster.tif", "ELEVATION", 
                                         "1 50 400 5 28", "#", "#")

Información de licenciamiento

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