Доступно с лицензией 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.
Синтаксис
StorageCapacity(in_surface_raster, out_table, in_zone_data, {zone_field}, {analysis_type}, {min_elevation}, {max_elevation}, {increment_type}, {increment}, {z_unit}, {out_chart})| Parameter | Объяснение | Тип данных |
in_surface_raster | Входной растр непрерывной высотной поверхности. | Raster Layer |
out_table | Выходная таблица, которая содержит площади поверхности и общие объемы для каждого инкремента каждой зоны. | Table |
in_zone_data | Набор данных, определяющий зоны. Зоны могут быть определены слоем целочисленного растра или векторным слоем. | Raster Layer; Feature Layer |
zone_field (Дополнительный) | Поле, которое содержит значения, определяющие каждую зону. Это может быть целочисленное или строковое поле набора данных зоны. | Field |
analysis_type (Дополнительный) | Задает тип анализа.
| String |
min_elevation (Дополнительный) | Минимальная высота, с которой начинаются вместимости. По умолчанию, инструмент использует минимальное значение растровой поверхности в каждой зоне как минимальную высоту в этой зоне. Если значение задано, используется минимальная высота по всем зонам. | Double |
max_elevation (Дополнительный) | Максимальная высота, с которой начинаются вместимости. По умолчанию, инструмент использует максимальное значение растровой поверхности в каждой зоне как максимальную высоту в этой зоне. Если значение задано, используется максимальная высота по всем зонам. | Double |
increment_type (Дополнительный) | Задает тип инкремента, используемый при вычислении инкремента высот между минимальной и максимальной высотой.
| String |
increment (Дополнительный) | Значение инкремента, которое является либо числом инкрементов, либо разницей высот между инкрементами. Значение определяется в зависимости от значения параметра Тип инкремента. | Double |
z_unit (Дополнительный) | Линейные единицы измерения для вертикальных z-значений.
| String |
out_chart (Дополнительный) | Имя выходной диаграммы для отображения. | Chart |
Пример кода
Используйте инструмент 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 для создания таблицы площадей поверхности и объемов с 10 инкрементами высот на входной растровой поверхности для каждой уникальной зоны в объекте зон.
# 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)Environments
Информация о лицензиях
- Basic: Требуется Spatial Analyst
- Standard: Требуется Spatial Analyst
- Advanced: Требуется Spatial Analyst