Доступно с лицензией Spatial Analyst.
Краткая информация
Создает растр потока накопления в каждую ячейку. Можно дополнительно применить фактор веса.
Более подробно о том, как работает инструмент Суммарный сток
Иллюстрация
Использование
Результирующие данные инструмента Суммарный сток – это растр суммарного стока в каждую ячейку, определяемого как сумма весов для всех ячеек, которые стекают в каждую ячейку, расположенную вниз по склону.
Инструмент Суммарный сток поддерживает три алгоритма моделирования стоков при вычислении накопления. Это методы D8, Множественные направления стока (MFD) и Сток D-Infinity (DINF).
Если входной растр направления стока создан не с помощью инструмента Направление стока, существует вероятность, что определяемый сток будет образовывать петли. Если направление стока образует петлю, инструмент Суммарный сток будет выполняться бесконечно (произойдет зацикливание).
Входное направление стока может быть создано с помощью методов D8, Множественные направления стока (MFD) и Сток D-Infinity (DINF). Тип входного растра направления стока, в этих трех случаях, влияет на способ, которым инструмент Суммарный сток разделяет и накапливает сток в каждой ячейке. Используйте Тип направления стока, чтобы указать, какой метод применялся при создании растра направления стока.
Ячейки с неопределенным направлением стока будут только накапливать поток; они не будут вносить вклад в сток в направлении вниз по склону.
Для входного растра направления D8 считается, что ячейка имеет неопределенное направление стока в том случае, если ее значение в растре направления стока не равно 1, 2, 4, 8, 16, 32, 64 или 128.
Для входного растра направления стока D-Infinity, считается, что ячейка имеет неопределенное направление стока в том случае, если ее значение в растре направления стока равно 128.
Суммарный сток основывается на количестве целых или фрагментарных ячеек, из которых осуществляется сток в каждую конкретную ячейку в выходном растре. Та ячейка, которая обрабатывается в текущий момент времени, не учитывается в сумме.
Выходные ячейки с высоким суммарным стоком - это участки концентрированного стока; они могут быть использованы для определения русел водотоков.
Выходные ячейки с суммарным стоком, равным нулю, - это локальные топографические пики; они могут быть использованы для выделения хребтов или линий водораздела.
Инструмент Суммарный сток игнорирует параметр среды Сжатие. Выходной растр никогда не будет сжатым.
Этот инструмент поддерживает параллельную обработку. Если ваш компьютер имеет несколько процессоров или процессор с несколькими ядрами, то для больших наборов данных будет достигаться лучшая производительность. В разделе Параллельная обработка в Spatial Analyst эта функция и ее настройки описаны более подробно.
При использовании параллельной обработки, для управления обрабатываемыми фрагментами записываются временные данные. Расположение папки временных файлов по умолчанию будет на вашем локальном диске C. Вы можете управлять расположением этой папки, настроив Переменную системной среды с именем TempFolders и указав путь к папке, которая будет использоваться (например, E:\RasterCache). Если у вас права администратора на вашей машине, вы можете также использовать ключ регистрации (например, [HKEY_CURRENT_USER\SOFTWARE\ESRI\Desktop10.6\Raster]).
По умолчанию, этот инструмент использует 50 процентов доступных ядер. Если входные данные меньше, чем 5,000 на 5,000 ячеек, может использоваться меньше ядер. Можно задавать число используемых инструментом ядер в среде Коэффициент параллельной обработки.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
FlowAccumulation (in_flow_direction_raster, {in_weight_raster}, {data_type}, {flow_direction_type})
Параметр | Объяснение | Тип данных |
in_flow_direction_raster | Входной растр, показывающий направление стока для каждой ячейки. Растр направления стока может быть создан с помощью инструмента Направление стока. Входное направление стока может быть создано с помощью методов D8, Multiple Flow Direction (MFD) и D-Infinity (DINF). Используйте flow_direction_type, чтобы указать, какой метод применялся при создании растра направления стока. | Raster Layer |
in_weight_raster (Дополнительный) | Дополнительный входной растр, представляющий веса для каждой ячейки. Если не задано никакого растра весов, каждой ячейке будет присвоен вес, равный единице, который используется по умолчанию. Для каждой ячейки в выходном растре результатом будет количество ячеек, из которых осуществляется сток в эту ячейку. | Raster Layer |
data_type (Дополнительный) | Выходной растр суммарного стока может быть целочисленным, содержать значения с плавающей точкой или двойной точности.
| String |
flow_direction_type (Дополнительный) | Входной растр направления стока может быть типов: D8, Multi Flow Direction (MFD) или D-Infinity (DINF).
| String |
Возвращаемое значение
Название | Объяснение | Тип данных |
out_accumulation_raster | Выходной растр, содержащий информацию о суммарном стоке в каждой ячейке. | Raster |
Пример кода
FlowAccumulation, пример 1 (окно Python)
В этом примере создается растр суммарного стока в каждой ячейке входного растра направления стока Grid.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFlowAccumulation = FlowAccumulation("flowdir")
outFlowAccumulation.save("C:/sapyexamples/output/outflowacc01")
FlowAccumulation, пример 2 (автономный скрипт)
В этом примере создается растр суммарного стока в каждой ячейке входного растра направления стока IMG.
# Name: FlowAccumulation_Ex_02.py
# Description: Creates a raster of accumulated flow to each cell.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inFlowDirRaster = "flowdir"
inWeightRaster = ""
dataType = "INTEGER"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute FlowDirection
outFlowAccumulation = FlowAccumulation(inFlowDirRaster, inWeightRaster, dataType)
# Save the output
outFlowAccumulation.save("C:/sapyexamples/output/outflowacc02.img")
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Требует Spatial Analyst
- ArcGIS Desktop Standard: Требует Spatial Analyst
- ArcGIS Desktop Advanced: Требует Spatial Analyst