Capacidad de almacenamiento (Spatial Analyst)—ArcGIS Pro

Disponible con una licencia de Spatial Analyst.

Resumen

Crea una tabla y un gráfico de elevaciones y capacidades de almacenamiento correspondientes para un ráster de superficie de entrada. La herramienta calcula el área de superficie y el volumen total de la región subyacente en una serie de incrementos de elevación.

Uso

La herramienta crea una tabla de área de superficie y volúmenes totales en una serie de incrementos de elevación. La tabla contiene un registro para cada incremento de elevación de cada zona.
La tabla salida presenta el siguiente esquema:
- Los campos son ELEVATION, AREA y VOLUME.
- Los campos de área y volumen contienen los cálculos de capacidad de almacenamiento en cada incremento de elevación.
- Los campos de elevación y volumen se calculan en unidades z. El campo de área se calcula en las unidades x,y del ráster de superficie de entrada.
- Cuando no se especifican zonas, se agrega un campo ZONE_CODE con un valor de 1 para todos los registros que utilizan la extensión de análisis como una única zona.
- Si se especifican zonas, se agrega un campo basado en el valor del parámetro Campo de zona (zone_field en Python). Para un campo de zona de enteros, se agregará un campo con el mismo nombre en la tabla de salida. Para un campo de zona de cadena de caracteres, se agregará un campo con el mismo nombre en la tabla de salida y se agregará un campo ZONE_CODE adicional.
Si lo desea, se crean dos gráficos para trazar las curvas de área de elevación y volumen de elevación. Los gráficos se agregan al panel Contenido junto con la tabla de salida. El formato de nombre utilizado para el nombre del gráfico es Curva de área de elevación <out_chart> y Curva de volumen de elevación <out_chart>, donde <out_chart> se sustituye por el nombre especificado en el parámetro Nombre de gráfico de salida (out_chart en Python). Al crear un gráfico con varias zonas, cada línea del gráfico representa una zona. Use la leyenda para activar o desactivar líneas interactivamente en el gráfico. Consulte Un repaso rápido a los gráficos para obtener más información sobre cómo trabajar con gráficos en ArcGIS Pro. Los gráficos solo se pueden crear en ArcGIS Pro; no se admiten desde un script independiente.
Utilice el parámetro Tipo de análisis (analysis_type en Python) para seleccionar el área de superficie, los cálculos de volumen o ambos. Esto determina el esquema para las tablas y los gráficos. Por ejemplo, si se selecciona la opción Área (AREA en Python), solo se crea un campo de área en la tabla de salida y se omite el campo de volumen. Del mismo modo, solo se crea un gráfico para la curva de elevación de área.
Si no se especifican zonas, la capacidad de almacenamiento se calcula utilizando la extensión de análisis como una única zona. Especifique un valor para el parámetro opcional Datos de zonas de entidad o ráster de entrada (in_zone_data en Python) que represente las zonas en las que se deben calcular las capacidades de almacenamiento. Por ejemplo, una zona puede ser un depósito o una balsa de retención. La herramienta admite cálculos en varias zonas y las capacidades de almacenamiento se calculan de forma independiente en cada zona basándose en un campo de zona.
Los incrementos de elevación sobre los que se calculan las capacidades de almacenamiento se basan en los valores de los parámetros Elevación mínima (min_elevation en Python), Elevación máxima (max_elevation en Python), Tipo de incremento (increment_type en Python) e Incremento (increment en Python).
Los valores predeterminados de los parámetros Elevación mínima y Elevación máxima se determinan de la siguiente manera:
- La herramienta utiliza los valores zonales mínimo y máximo del ráster de superficie de entrada como valores predeterminados. Estos valores pueden variar de zona a zona dependiendo de los valores mínimo y máximo del ráster de superficie de entrada en estas zonas.
- Si especifica un valor para los parámetros Elevación mínima o Elevación máxima, la herramienta utiliza el mismo valor para los incrementos mínimo y máximo en todas las zonas. En este caso, si un subconjunto de incrementos de elevación se vuelve más pequeño que el mínimo zonal, el área y los volúmenes se calculan como cero. Si son más grandes que el máximo zonal, las áreas y los volúmenes de esos incrementos no se calculan y aparecen como nulos o cero dependiendo del formato de tabla.
Especifique un valor para el parámetro Unidad z (z_unit en Python) para indicar las unidades verticales del ráster de superficie de entrada. Si el ráster de superficie de entrada tiene especificado un sistema de coordenadas verticales, estas unidades se utilizan como la unidad z predeterminada. Si no se especifica ninguna unidad z y el ráster de superficie de entrada no tiene un sistema de coordenadas verticales, la unidad z predeterminada es el metro. Cuando las unidades x,y son diferentes de la unidad z, las unidades x,y se convierten para coincidir con la unidad z al calcular volúmenes.
De forma predeterminada, esta herramienta aprovecha los procesadores multinúcleo. El número máximo de núcleos que se pueden utilizar es cuatro.
Para utilizar menos núcleos, use la configuración del entorno parallelProcessingFactor.

Parámetros

Etiqueta	Explicación	Tipo de datos
Ráster de superficie de entrada	Ráster de entrada que representa una superficie continua.	Raster Layer
Tabla de salida	La tabla de salida que contiene para cada zona el área de superficie y los volúmenes totales para cada incremento de elevación.	Table
Datos de zonas de entidad o ráster de entrada	Dataset que define las zonas. Las zonas pueden definirse mediante un ráster entero o una capa de entidades.	Raster Layer; Feature Layer
Campo de zona (Opcional)	El campo que contiene los valores que definen cada zona. Puede ser un campo de enteros o de cadenas de caracteres del dataset zonal.	Field
Tipo de análisis (Opcional)	Especifica el tipo de análisis. Área y volumen—Tanto las áreas de superficie como los volúmenes totales se calculan en cada incremento de elevación. Esta es la opción predeterminada. Área—El área de superficie se calcula en cada incremento de elevación. Volumen—El volumen total se calcula en cada incremento de elevación.	String
Elevación mínima (Opcional)	La elevación mínima desde la que se evalúan las capacidades de almacenamiento. De forma predeterminada, la herramienta utiliza el valor mínimo del ráster de superficie en cada zona como la elevación mínima para esa zona. Si se proporciona un valor, se utiliza como la elevación mínima en todas las zonas.	Double
Elevación máxima (Opcional)	La elevación máxima desde la que se evalúan las capacidades de almacenamiento. De forma predeterminada, la herramienta utiliza el valor máximo del ráster de superficie en cada zona como la elevación máxima para esa zona. Si se proporciona un valor, se utiliza como la elevación máxima en todas las zonas.	Double
Tipo de incremento (Opcional)	Especifica el tipo de incremento que se debe utilizar al calcular incrementos de elevación entre las elevaciones mínima y máxima. Número de incrementos—Se utiliza el número de incrementos entre las elevaciones mínima y máxima. Esta es la opción predeterminada. Valor de incremento—Se utiliza la diferencia de elevación entre cada incremento.	String
Incremento (Opcional)	Un valor incremental que es el número de incrementos o la diferencia de elevación entre incrementos. El valor se determina en función del valor del parámetro de tipo de incremento.	Double
Unidad z (Opcional)	La unidad lineal de los valores z verticales. Pulgada—La unidad lineal será pulgadas. Pie—La unidad lineal será pies. Yarda—La unidad lineal será yardas. Milla (EE. UU.)—La unidad lineal será millas. Milla náutica—La unidad lineal será millas náuticas. Milímetro—La unidad lineal será milímetros. Centímetro—La unidad lineal será centímetros. Contador—La unidad lineal será metros. Kilómetro—La unidad lineal será kilómetros. Decímetro—La unidad lineal será decímetros.	String
Nombre de gráfico de salida (Opcional)	El nombre del gráfico de salida que se va a visualizar. El gráfico aparece en el panel Contenido, en Tablas independientes.	Chart

StorageCapacity(in_surface_raster, out_table, in_zone_data, {zone_field}, {analysis_type}, {min_elevation}, {max_elevation}, {increment_type}, {increment}, {z_unit}, {out_chart})

Nombre	Explicación	Tipo de datos
in_surface_raster	Ráster de entrada que representa una superficie continua.	Raster Layer
out_table	La tabla de salida que contiene para cada zona el área de superficie y los volúmenes totales para cada incremento de elevación.	Table
in_zone_data	Dataset que define las zonas. Las zonas pueden definirse mediante un ráster entero o una capa de entidades.	Raster Layer; Feature Layer
zone_field (Opcional)	El campo que contiene los valores que definen cada zona. Puede ser un campo de enteros o de cadenas de caracteres del dataset zonal.	Field
analysis_type (Opcional)	Especifica el tipo de análisis. AREA_VOLUME—Tanto las áreas de superficie como los volúmenes totales se calculan en cada incremento de elevación. Esta es la opción predeterminada. AREA—El área de superficie se calcula en cada incremento de elevación. VOLUME—El volumen total se calcula en cada incremento de elevación.	String
min_elevation (Opcional)	La elevación mínima desde la que se evalúan las capacidades de almacenamiento. De forma predeterminada, la herramienta utiliza el valor mínimo del ráster de superficie en cada zona como la elevación mínima para esa zona. Si se proporciona un valor, se utiliza como la elevación mínima en todas las zonas.	Double
max_elevation (Opcional)	La elevación máxima desde la que se evalúan las capacidades de almacenamiento. De forma predeterminada, la herramienta utiliza el valor máximo del ráster de superficie en cada zona como la elevación máxima para esa zona. Si se proporciona un valor, se utiliza como la elevación máxima en todas las zonas.	Double
increment_type (Opcional)	Especifica el tipo de incremento que se debe utilizar al calcular incrementos de elevación entre las elevaciones mínima y máxima. NUMBER_OF_INCREMENTS—Se utiliza el número de incrementos entre las elevaciones mínima y máxima. Esta es la opción predeterminada. VALUE_OF_INCREMENT—Se utiliza la diferencia de elevación entre cada incremento.	String
increment (Opcional)	Un valor incremental que es el número de incrementos o la diferencia de elevación entre incrementos. El valor se determina en función del valor del parámetro de tipo de incremento.	Double
z_unit (Opcional)	La unidad lineal de los valores z verticales. INCH—La unidad lineal será pulgadas. FOOT—La unidad lineal será pies. YARD—La unidad lineal será yardas. MILE_US—La unidad lineal será millas. NAUTICAL_MILE—La unidad lineal será millas náuticas. MILLIMETER—La unidad lineal será milímetros. CENTIMETER—La unidad lineal será centímetros. METER—La unidad lineal será metros. KILOMETER—La unidad lineal será kilómetros. DECIMETER—La unidad lineal será decímetros.	String
out_chart (Opcional)	El nombre del gráfico de salida que se va a visualizar.	Chart

Muestra de código

Ejemplo 1 de StorageCapacity (ventana de Python)

Utilizar la herramienta StorageCapacity para crear una tabla de áreas y volúmenes de superficie en 10 incrementos de elevación en un ráster de superficie de entrada para cada zona en una entidad de zona.

import arcpy
from arcpy.sa import *
arcpy.env.workspace = "C:/sapyexamples/data"
arcpy.sa.StorageCapacity("in_surface.tif", "out_table", "in_zones", "zone_id")

Ejemplo 2 de StorageCapacity (script independiente)

# Name: StorageCapacity_Standalone.py
# Description: 
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy.sa import *

# Set the analysis environments
arcpy.CheckOutExtension("Spatial")
arcpy.env.workspace = "C:/arcpyExamples/data"

# Set local variables
in_surface_raster = "in_surface.tif"
out_table = "fgdb.gdb\out_table"
in_zones = "fgdb.gdb\in_zones"
zone_field = "zone_id"

# Execute StorageCapacity tool
arcpy.sa.StorageCapacity(in_surface_raster, out_table, in_zones, zone_field)

Entornos

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Compresión, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Máscara, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Factor de procesamiento en paralelo, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela

Información de licenciamiento

Basic: Requiere Spatial Analyst
Standard: Requiere Spatial Analyst
Advanced: Requiere Spatial Analyst

Temas relacionados

¿Algún comentario sobre este tema?