Суммарный сток (Flow Accumulation) (Spatial Analyst)
Краткая информация
Создает растр потока накопления в каждую ячейку. Можно дополнительно применить фактор веса.
Более подробно о том, как работает инструмент Суммарный сток
Рисунок
Использование
-
Результирующие данные инструмента Суммарный сток (Flow Accumulation) — это растр суммарного стока в каждую ячейку, определяемого как сумма весов для всех ячеек, которые стекают в каждую ячейку, расположенную вниз по склону.
-
Ячейки с неопределенным направлением стока будут только накапливать поток; они не будут вносить вклад в сток в направлении вниз по склону. Считается, что ячейка имеет неопределенное направление стока в том случае, если ее значение в растре направления стока не равно 1, 2, 4, 8, 16, 32, 64 или 128.
-
Суммарный сток основывается на количестве ячеек, из которых осуществляется сток в каждую конкретную ячейку в выходном растре. Та ячейка, которая обрабатывается в текущий момент времени, не учитывается в сумме.
-
Выходные ячейки с высоким суммарным стоком - это участки концентрированного стока; они могут быть использованы для определения русел водотоков.
-
Выходные ячейки с суммарным стоком, равным нулю, - это локальные топографические пики; они могут быть использованы для выделения хребтов или линий водораздела.
-
Если входной растр направления стока создан не с помощью инструмента FlowDirection (Направление стока), существует вероятность, что определяемый сток будет образовывать петли. Если направление стока образует петли, инструмент Суммарный сток (Flow Accumulation) будет выполняться бесконечно (произойдет зацикливание).
Инструмент Суммарный сток (Flow Accumulation) игнорирует параметр среды Сжатие (Compression). Выходной растр никогда не будет сжатым.
Синтаксис
Параметр | Объяснение | Тип данных |
in_flow_direction_raster |
Входной растр направления стока. Растр направления потока может быть создан с помощью инструмента Направление потока (Flow Direction). | Raster Layer |
in_weight_raster (дополнительно) |
Дополнительный входной растр, представляющий веса, для каждой ячейки. Если не задано никакого растра весов, каждой ячейке будет присвоен вес, равный единице, который используется по умолчанию. Для каждой ячейки в выходном растре результатом будет количество ячеек, из которых осуществляется сток в эту ячейку. | Raster Layer |
data_type (дополнительно) |
Выходной растр суммарного стока может быть целочисленным или содержать значения с плавающей точкой.
| String |
Возвращено значение
Имя | Объяснение | Тип данных |
out_accumulation_raster |
Выходной растр, содержащий информацию о суммарном стоке в каждой ячейке. | Raster |
Пример кода
В этом примере создается растр суммарного стока в каждой ячейке входного растра направления стока 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")
В этом примере создается растр суммарного стока в каждой ячейке входного растра направления стока 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")