Establecer 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

  • Esta herramienta le permite definir las estadísticas para un dataset ráster o de mosaico. Por lo general, esta herramienta se utiliza cuando no se desea que la aplicación las calcule. Las estadísticas que puede configurar son 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 la configuración de representación en pantalla predeterminada de ArcGIS Pro, así como las estadísticas que utilizan otras herramientas.

    Las propiedades que puede establecer incluyen:

    • Tipo de fuente de datos: define 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.

Sintaxis

arcpy.management.SetRasterProperties(in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties})
ParámetroExplicaciónTipo de datos
in_raster

Dataset de mosaico o ráster cuyas propiedades desea definir.

Mosaic Layer ; Raster Layer
data_type
(Opcional)

Tipo de imágenes del dataset de mosaico.

  • GENERIC El dataset de mosaico no tiene un tipo de datos especificado.
  • ELEVATION El dataset de mosaico contiene datos de elevación.
  • THEMATICLos datos temáticos 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)

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

Value Table
stats_file
(Opcional)

Archivo .xml que contiene las estadísticas.

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

Especifique 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. Si desea definir varios valores NoData para cada selección de bandas, utilice un delimitador de espacios entre cada valor NoData del parámetro bands_for_nodata_value.

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

Las propiedades compatibles de forma nativa son las siguientes. Los datos pueden tener propiedades que no se incluyen en esta lista. Las propiedades no distinguen entre minúsculas y mayú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

Salida derivada

NombreExplicaciónTipo de datos
out_raster

El dataset ráster de salida.

Dataset ráster

Muestra de código

Ejemplo 1 de SetRasterProperties (ventana de Python)

Esta es una muestra de Python para 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 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í