Доступно с лицензией Spatial Analyst.
Краткая информация
Создает растр потока накопления в каждую ячейку. Можно дополнительно применить фактор веса.
Более подробно о том, как работает инструмент Суммарный сток
Рисунок
Использование
Результирующие данные инструмента Суммарный сток (Flow Accumulation) – это растр суммарного стока в каждую ячейку, определяемого как сумма весов для всех ячеек, которые стекают в каждую ячейку, расположенную вниз по склону.
Ячейки с неопределенным направлением стока будут только накапливать поток; они не будут вносить вклад в сток в направлении вниз по склону. Считается, что ячейка имеет неопределенное направление стока в том случае, если ее значение в растре направления стока не равно 1, 2, 4, 8, 16, 32, 64 или 128.
Суммарный сток основывается на количестве ячеек, из которых осуществляется сток в каждую конкретную ячейку в выходном растре. Та ячейка, которая обрабатывается в текущий момент времени, не учитывается в сумме.
Выходные ячейки с высоким суммарным стоком – это участки концентрированного стока; они могут быть использованы для определения русел водотоков.
Выходные ячейки с суммарным стоком, равным нулю, – это локальные топографические пики; они могут быть использованы для выделения хребтов или линий водораздела.
Если входной растр направления стока создан не с помощью инструмента FlowDirection (Направление стока), существует вероятность, что определяемый сток будет образовывать петли. Если направление стока образует петли, инструмент Суммарный сток (Flow Accumulation) будет выполняться бесконечно (произойдет зацикливание).
Инструмент Суммарный сток (Flow Accumulation) игнорирует параметр среды Сжатие (Compression). Выходной растр никогда не будет сжатым.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
FlowAccumulation (in_flow_direction_raster, {in_weight_raster}, {data_type})
Параметр | Объяснение | Тип данных |
in_flow_direction_raster | Входной растр, показывающий направление стока для каждой ячейки. Растр направления стока может быть создан с помощью инструмента Направление стока (Flow Direction). | Raster Layer |
in_weight_raster (дополнительно) |
Дополнительный входной растр, представляющий веса для каждой ячейки. Если не задано никакого растра весов, каждой ячейке будет присвоен вес, равный единице, который используется по умолчанию. Для каждой ячейки в выходном растре результатом будет количество ячеек, из которых осуществляется сток в эту ячейку. | Raster Layer |
data_type (дополнительно) |
Выходной растр суммарного стока может быть целочисленным или содержать значения с плавающей точкой.
| 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")
Параметры среды
- Автоподтверждение (Auto Commit)
- Размер ячейки (Cell size)
- Сжатие (Compression)
- Текущая рабочая область (Current Workspace)
- Экстент (Extent)
- Географические преобразования (Geographic Transformations)
- Маска (Mask)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Выходная система координат (Output Coordinate System)
- Статистика растра (Raster Statistics)
- Временная рабочая область (Scratch Workspace)
- Растр привязки (Snap Raster)
- Размер листа (Tile Size)