Capacidad de almacenamiento (Spatial Analyst)

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.

Sintaxis

StorageCapacity(in_surface_raster, out_table, in_zone_data, {zone_field}, {analysis_type}, {min_elevation}, {max_elevation}, {increment_type}, {increment}, {z_unit}, {out_chart})
ParámetroExplicaciónTipo 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_VOLUMETanto las áreas de superficie como los volúmenes totales se calculan en cada incremento de elevación. Esta es la opción predeterminada.
  • AREAEl área de superficie se calcula en cada incremento de elevación.
  • VOLUMEEl 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_INCREMENTSSe utiliza el número de incrementos entre las elevaciones mínima y máxima. Esta es la opción predeterminada.
  • VALUE_OF_INCREMENTSe 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.

  • INCHLa unidad lineal será pulgadas.
  • FOOTLa unidad lineal será pies.
  • YARDLa unidad lineal será yardas.
  • MILE_USLa unidad lineal será millas.
  • NAUTICAL_MILELa unidad lineal será millas náuticas.
  • MILLIMETERLa unidad lineal será milímetros.
  • CENTIMETERLa unidad lineal será centímetros.
  • METERLa unidad lineal será metros.
  • KILOMETERLa unidad lineal será kilómetros.
  • DECIMETERLa 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)

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.

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

Información de licenciamiento

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

Temas relacionados