Establecer propiedades de ráster

Resumen

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

Obtenga más información sobre las estadísticas de ráster y propiedades

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 las opciones de representación en pantalla predeterminadas en ArcMap, así como las estadísticas que otras herramientas utilizan.

  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

SetRasterProperties_management (in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties})

Parámetro	Explicación	Tipo 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. THEMATIC —Los datos temáticos tienen valores discretos, como la cobertura de suelo. PROCESSED —El color del dataset de mosaico ya se ha equilibrado. SCIENTIFIC —Los datos incluyen información científica y se mostrarán de manera predeterminada con la rampa de color de azul a rojo. VECTOR_UV —Los datos son un ráster de dos bandas que contiene los componentes U y V de los datos de un campo vectorial. VECTOR_MAGDIR —Los 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. Para crear este archivo, exporte las estadísticas desde otro dataset ráster o de mosaico.	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

Nombre	Explicación	Tipo de datos
out_raster

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", "#", "#")

Entornos

• Espacio de trabajo actual

Información sobre licencias

• ArcGIS Desktop Basic: Sí
• ArcGIS Desktop Standard: Sí
• ArcGIS Desktop Advanced: Sí