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

Cuadro de diálogo

Etiqueta	Explicación	Tipo 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érico—El dataset de mosaico no tiene un tipo de datos especificado. Elevación—El dataset de mosaico contiene datos de elevación. Temático—El dataset de mosaico tiene datos temáticos, que tienen valores discretos, como la cobertura de suelo. Científico—Los datos incluyen información científica y se mostrarán de manera predeterminada con la rampa de color de azul a rojo. UV de vector—Los 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ón—Los datos son un ráster de dos bandas que contiene la magnitud y la dirección de los datos de un campo vectorial. Procesado—El 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

Etiqueta	Explicación	Tipo de datos
Dataset ráster actualizado	El dataset ráster de salida.	Raster Dataset

Python

arcpy.management.SetRasterProperties(in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties}, {multidimensional_info})

Nombre	Explicación	Tipo 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. GENERIC—El dataset de mosaico no tiene un tipo de datos especificado. ELEVATION—El dataset de mosaico contiene datos de elevación. THEMATIC—El dataset de mosaico tiene datos temáticos, que 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)	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

Nombre	Explicación	Tipo 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", "#", "#")

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal

Información de licenciamiento

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