Вместимость (Spatial Analyst)—ArcGIS Pro

Доступно с лицензией Spatial Analyst.

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

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

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

Инструмент создает таблицу площади поверхности и объемов в серии увеличивающихся высот. Таблица содержит запись для каждого инкремента высоты для каждой зоны.
Выходная таблица имеет следующую схему:
- Это поля ELEVATION, AREA и VOLUME.
- Поля площади и объема содержат вычисления вместимости при каждом инкременте высоты.
- Поля высоты и объема вычисляются в z-единицах. Поле площади вычисляется в единицах x,y входного растра поверхности.
- Если зоны не заданы, поле ZONE_CODE добавляется со значением 1 для всех записей, при этом экстент анализа используется как одна зона.
- Если зоны заданы, поле добавляется в зависимости от значения параметра Поле зоны (zone_field в Python). Для целочисленного поля зоны, в выходную таблицу добавляется поле с таким же именем. Для строкового поля зоны, в выходную таблицу добавляется поле с таким же именем и дополнительное поле ZONE_CODE.
Дополнительно создаются две диаграммы кривых площади и объема высот. Диаграммы добавляются на панель Содержание вместе с выходной таблицей. Диаграмме присваивается имя в формате <out_chart> Elevation Area Curve и <out_chart> Elevation Volume Curve, где <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-единицами при вычислении объемов.
По умолчанию, этот инструмент использует преимущества многоядерных процессоров. Максимальное число ядер, которое может быть использовано,– четыре.
Чтобы инструмент использовал меньшее число ядер, измените параметр среды parallelProcessingFactor.

Параметры

Подпись	Описание	Тип данных
Входная растровая поверхность	Входной растр непрерывной высотной поверхности.	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—Линейными единицами измерения могут быть футы. 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.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)

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

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

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

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

Параметры

Пример кода

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

Особые случаи

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

Связанные разделы

В этом разделе