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

Доступно с лицензией 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-единицами при вычислении объемов.

  • По умолчанию этот инструмент будет использовать многоядерные процессоры, если они доступны. Максимальное число использующихся ядер – четыре.

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

Параметры

ПодписьОписаниеТип данных
Входная растровая поверхность

Входной растр непрерывной высотной поверхности.

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 (автономный скрипт)

Используйте инструмент 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)

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

  • Basic: Обязательно Spatial Analyst
  • Standard: Обязательно Spatial Analyst
  • Advanced: Обязательно Spatial Analyst

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