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

Resumen

Establece algunas propiedades en un dataset ráster o dataset de mosaico, como tipo de datos, estadísticas y valores nodata.

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, utiliza esta herramienta si no desea que ArcGIS las calcule por usted. Las estadísticas que puede establecer son los valores mínimos, máximos, de desviación estándar y valores 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: esto define si los valores de celda representan los datos categóricos o de elevación o si los valores se procesaron con otros métodos y se deben ajustar para visualizar los datos.
  • Estadísticas por banda: para cada banda, puede definir el valor mínimo, máximo, medio y de desviación estándar.
  • Bandas para valor NoData: Para cada banda, puede definir un valor NoData.

• Estas propiedades también se pueden establecer en la ventana Propiedades, al hacer clic con el botón derecho en un ráster de la ventana Catálogo y seleccionar Propiedades, o al hacer clic con el botón derecho en una capa ráster en ArcMap y seleccionar Propiedades. La herramienta Establecer propiedades de ráster le permite establecer estas propiedades en un modelo de geoprocesamiento o en Python.

Sintaxis

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

Parámetro	Explicación	Tipo de datos
in_raster	El dataset ráster de entrada o el dataset de mosaico.	Mosaic Layer ; Raster Layer
data_type (Opcional)	El tipo de datos que contiene este dataset. Estas configuraciones controlan la simbología que se aplica cuando se presentan estos datasets. GENERIC —Éste es un ráster que no ubica ningún otro tipo de origen de datos. ArcGIS intentará usar el renderizador más apropiado para visualizar estos datos. ELEVATION —Los datos son datos de elevación. Se aplicará una extensión mínima-máxima al visualizar estos datos. THEMATIC —Los datos son categóricos; por lo tanto, no se usará una extensión. Estos datos probablemente se deben visualizar con el mapa de color o el renderizador de valores único. PROCESSED —Los datos ya se han mejorado; por lo tanto, no se aplicará ninguna extensión al visualizar este dataset.	String
statistics [[band_index, min, max, mean, std_dev],...] (Opcional)	Escriba el número de banda, valor mínimo de las estadísticas, valor máximo de las estadísticas, valor medio de las estadísticas y valor de desviación estándar.	Value Table
stats_file (Opcional)	Un archivo XML que contiene las estadísticas. Este archivo se puede crear al exportar las estadísticas de otro ráster o dataset de mosaico.	File
nodata [[band index, nodata_value],...] (Opcional)	Defina valores para cada banda o todas las bandas. 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 en el parámetro bands_for_nodata_value.	Value Table

Ejemplo 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 (secuencia de comandos independiente)

Esta es una muestra de secuencia de comandos 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