Вместимость (Инструменты Spatial Analyst)

Краткая информация

Создает таблицу и диаграмму высот и соответствующих вместимостей для входного растра поверхности. Инструмент вычисляет площадь поверхности и общий объем подстилающей области с серией приращений по высоте.

Использование

Инструмент создает таблицу площади поверхности и общих объёмов с серией приращений по высоте. Таблица содержит запись для каждого прироста высоты для каждой зоны.

Выходная таблица имеет следующую схему:
- Поля — ELEVATION, AREA, и VOLUME.
- Поля площади и объёма содержат вычисление вместимости на каждом шаге приращения высоты.
- Поля высоты и объёма вычисляются в z-единицах. Поле площади вычисляется в единицах x,y входного растра поверхности.
- Когда зоны не указаны, добавляется поле ZONE_CODE с значением 1 для всех записей, используя экстент анализа как единую зону.
- Если зоны указаны, добавляется поле на основе значения параметра Поле зоны (zone_field в Python). Для целочисленного поля зоны в выходную таблицу будет добавлено поле с тем же именем. Для строкового поля зоны в выходную таблицу будет добавлено поле с тем же именем, а также дополнительное поле ZONE_CODE.
Дополнительно могут быть созданы две диаграммы для построения кривых зависимости площади от высоты и объема от высоты. Диаграммы добавляются в панель Содержание вместе с выходной таблицей. Для именования диаграмм используется соглашение <out_chart> Кривая площади высот и <out_chart> Кривая объема высот, где <out_chart> заменяется именем, указанным в параметре Имя выходной диаграммы (out_chart в Python). При создании диаграммы с несколькими зонами каждая линия на диаграмме представляет собой отдельную зону. Используйте легенду, чтобы интерактивно включать или выключать линии на диаграмме. Подробную информацию о работе с диаграммами в ArcGIS Pro см. в разделе Краткий обзор диаграмм. Диаграммы можно создавать только в ArcGIS Pro; они не поддерживаются в автономном скрипте.
Используйте параметр Тип анализа (analysis_type в Python) для выбора площади поверхности, вычисления объёма или того и другого. Это определяет схему для таблиц и диаграмм. Например, если выбрана опция Площадь (AREA в Python), в выходной таблице создаётся только поле площади, а поле объёма пропущено. Аналогичным образом, для кривой зависимости высоты от площади создается только одна диаграмма.
Если зоны не указаны, вместимость вычисляется с использованием экстент анализа как единой зоны. Дополнительно можно указать значение параметра Входные растровые или векторные данные зон (in_zone_dataв Python), представляющее зоны, для которых необходимо вычислить вместимость. Например, зона может быть резервуаром или накопительным бассейном. Инструмент поддерживает расчеты по нескольким зонам, а емкость хранилища рассчитывается независимо для каждой зоны на основе поля зоны.
Приращения высоты, на основе которых вычисляются вместимости, основаны на значениях параметров Минимальная высота (min_elevation в Python), Максимальная высота (max_elevation в Python), Тип приращения (increment_type в Python) и Приращение (increment в Python).
Значения параметров **Минимальная высота ** и Максимальной высота по умолчанию определяются следующим образом:
- Инструмент использует минимальные и максимальные зональные значения из растра входной поверхности в качестве стандартных значений. Эти значения могут варьироваться от зоны к зоны в зависимости от минимальных и максимальных значений входного растра поверхности в этих зонах.
- Если указать значение параметра Минимальная высота или Максимальная высота, инструмент будет использовать одно и то же значение для минимального и максимального приращений во всех зонах. В этом случае, если подмножество приращений высоты становится меньше зонального минимума, площадь и объемы рассчитываются как ноль. Если они превышают зональный максимум, площади и объемы для этих приращений не рассчитываются и отображаются как нулевые значения в зависимости от формата таблицы.
Укажите значение параметра Z-единицы (z_unit в Python), чтобы обозначить вертикальные единицы входного растра поверхности. Если входной растр поверхности имеет вертикальную систему координат, эти единицы используются в качестве z-единицы по умолчанию. Если z-единица не указана и входной растр поверхности не имеет вертикальной системы координат, то по умолчанию используется единица измерения по оси Z — метр. Если единицы измерения x,y отличаются от z-единиц, то при вычислении объемов единицы измерения x,y преобразуются в соответствии с единицами измерения z.
По умолчанию этот инструмент будет использовать многоядерные процессоры, если они доступны. Максимальное число использующихся ядер – четыре.

Чтобы использовать меньшее число ядер, настройте параметр среды Коэффициент параллельной обработки.

Подпись	Объяснение	Тип данных
Входная растровая поверхность	Входной растр непрерывной высотной поверхности.	Raster Layer
Выходная таблица	Выходная таблица содержит для каждой зоны площадь поверхности и общий объем для каждого приращения высоты.	Table
Входные растровые или векторные данные зон	Набор данных, который определяет зоны. Зоны могут быть определены слоем целочисленного растра или векторным слоем.	Raster Layer; Feature Layer
Поле зоны (Дополнительный)	Поле, которое содержит значения, определяющие каждую зону. Это может быть целочисленное или строковое поле набора данных зоны.	Field
Тип анализа (Дополнительный)	Указывает тип анализа. Площадь и Объем–При каждом приращении высоты рассчитываются как площадь поверхности, так и общие объёмы. Используется по умолчанию. Площадь–Для каждого шага приращения высоты вычисляется площадь поверхности. Объем–Для каждого шага приращения высоты вычисляется суммарный объем.	String
Минимальная высота (Дополнительный)	Минимальная высота, от которой оцениваются вместимости (емкости хранения). По умолчанию, инструмент использует минимальное значение растровой поверхности в каждой зоне как минимальную высоту в этой зоне. Если значение задано, используется минимальная высота по всем зонам.	Double
Максимальная высота (Дополнительный)	Максимальная высота, от которой оцениваются емкости хранения. По умолчанию, инструмент использует максимальное значение растровой поверхности в каждой зоне как максимальную высоту в этой зоне. Если значение задано, используется максимальная высота по всем зонам.	Double
Тип приращения (Дополнительный)	Задает тип приращения, используемый при вычислении приращения высот между минимальной и максимальной высотой. Число инкрементов–Используется количество шагов между минимальными и максимальными высотами. Используется по умолчанию. Значение приращения (инкремента)–Используется разница высот для каждого приращения.	String
Приращение (Дополнительный)	Значение инкремента, которое является либо числом инкрементов, либо разницей высот между инкрементами. Значение определяется в зависимости от значения параметра тип инкремента.	Double
Z единицы (Дополнительный)	Задает линейные единицы измерения, которые будет использоваться для вертикальных z-значений. Дюйм–Линейными единицами измерения будут дюймы. Фут–Линейными единицами измерения будут футы. Футы США–Линейными единицами измерения будут геодезические футы США. Ярд–Линейными единицами измерения будут ярды. Мили США–Линейными единицами измерения будут геодезические мили США. Морская миля–Линейными единицами измерения будут морские мили. Миллиметр–Линейными единицами измерения будут миллиметры. Сантиметр–Линейными единицами измерения будут сантиметры. Метр–Линейными единицами измерения будут метры. Километр–Линейными единицами измерения будут километры. Дециметр–Линейными единицами измерения будут дециметры.	String
Имя выходной диаграммы (Дополнительный)	Имя выходной диаграммы для отображения. Диаграмма приведена в списке на панели Содержание в разделе Автономные таблицы.	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})

Имя	Объяснение	Тип данных
in_surface_raster	Входной растр непрерывной высотной поверхности.	Raster Layer
out_table	Выходная таблица содержит для каждой зоны площадь поверхности и общий объем для каждого приращения высоты.	Table
in_zone_data	Набор данных, который определяет зоны. Зоны могут быть определены слоем целочисленного растра или векторным слоем.	Raster Layer; Feature Layer
zone_field (Дополнительный)	Поле, которое содержит значения, определяющие каждую зону. Это может быть целочисленное или строковое поле набора данных зоны.	Field
analysis_type (Дополнительный)	Указывает тип анализа. `AREA_VOLUME`–При каждом приращении высоты рассчитываются как площадь поверхности, так и общие объёмы. Используется по умолчанию. `AREA`–Для каждого шага приращения высоты вычисляется площадь поверхности. `VOLUME`–Для каждого шага приращения высоты вычисляется суммарный объем.	String
min_elevation (Дополнительный)	Минимальная высота, от которой оцениваются вместимости (емкости хранения). По умолчанию, инструмент использует минимальное значение растровой поверхности в каждой зоне как минимальную высоту в этой зоне. Если значение задано, используется минимальная высота по всем зонам.	Double
max_elevation (Дополнительный)	Максимальная высота, от которой оцениваются емкости хранения. По умолчанию, инструмент использует максимальное значение растровой поверхности в каждой зоне как максимальную высоту в этой зоне. Если значение задано, используется максимальная высота по всем зонам.	Double
increment_type (Дополнительный)	Задает тип приращения, используемый при вычислении приращения высот между минимальной и максимальной высотой. `NUMBER_OF_INCREMENTS`–Используется количество шагов между минимальными и максимальными высотами. Используется по умолчанию. `VALUE_OF_INCREMENT`–Используется разница высот для каждого приращения.	String
increment (Дополнительный)	Значение инкремента, которое является либо числом инкрементов, либо разницей высот между инкрементами. Значение определяется в зависимости от значения параметра тип инкремента.	Double
z_unit (Дополнительный)	Задает линейные единицы измерения, которые будет использоваться для вертикальных z-значений. `INCH`–Линейными единицами измерения будут дюймы. `FOOT`–Линейными единицами измерения будут футы. `FOOT_US`–Линейными единицами измерения будут геодезические футы США. `YARD`–Линейными единицами измерения будут ярды. `MILE_US`–Линейными единицами измерения будут геодезические мили США. `NAUTICAL_MILE`–Линейными единицами измерения будут морские мили. `MILLIMETER`–Линейными единицами измерения будут миллиметры. `CENTIMETER`–Линейными единицами измерения будут сантиметры. `METER`–Линейными единицами измерения будут метры. `KILOMETER`–Линейными единицами измерения будут километры. `DECIMETER`–Линейными единицами измерения будут дециметры.	String
out_chart (Дополнительный)	Имя выходной диаграммы для отображения.	Chart

Пример кода

StorageCapacity пример 1 (окно Python)

Используйте инструмент StorageCapacity для создания таблицы площадей поверхности и общих объёмов с 10 приращениями высоты во входном растре поверхности для каждой зоны в объекте зоны.

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

StorageCapacity пример 2 (автономный скрипт)

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

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

# Set the analysis environments
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"

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

Параметры среды

Автоподтверждение, Размер ячейки, Метод проецирования размера ячейки, Сжатие, Текущая рабочая область, Экстент, Географические преобразования, Маска, Выходное ключевое слово конфигурации, Выходная система координат, Коэффициент параллельной обработки, Временная рабочая область, Растр привязки, Размер листа

Информация о лицензировании