ArcMap

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.

    El archivo XML se puede crear al exportar las estadísticas de otro dataset ráster o de mosaico, como sigue:

    1. En la ventana Catálogo, haga clic con el botón derecho en el dataset ráster o de mosaico que contiene las estadísticas que desea exportar y seleccione Propiedades.
    2. Desplácese a la fila que contiene la propiedad Estadísticas.
    3. Expanda las Opciones del menú desplegable en la columna Valor.
    4. Haga clic en Exportar estadísticas a 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

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.
  • 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

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

Entornos

Información de licenciamiento

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

Temas relacionados