Суммарный сток (Spatial Analyst)

Доступно с лицензией Spatial Analyst.

Краткая информация

Создает растр потока накопления в каждую ячейку. Можно дополнительно применить фактор веса.

Более подробно о том, как работает инструмент Суммарный сток

Иллюстрация

D8 Иллюстрация инструмента Суммарный сток
Flow_Acc = FlowAccumulation(Flow_Dir)

Использование

  • Результирующие данные инструмента Суммарный сток – это растр суммарного стока в каждую ячейку, определяемого как сумма весов для всех ячеек, которые стекают в каждую ячейку, расположенную вниз по склону.

  • Инструмент Суммарный сток поддерживает три алгоритма моделирования стоков при вычислении накопления. Это методы 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\ArcGISPro\Raster]).

    По умолчанию, этот инструмент будет использовать 50 процентов доступных ядер. Если размер входных данных меньше, чем 5000 на 5000 ячеек, может использоваться меньшее число ядер. Можно задавать число используемых инструментом ядер в среде Коэффициент параллельной обработки.

  • См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

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

Входной растр, показывающий направление стока для каждой ячейки.

Растр направления стока может быть создан с помощью инструмента Направление стока.

Растр направления стока может быть создан с помощью методов D8, Multiple Flow Direction (MFD) или D-Infinity (DINF). Используйте Тип направления стока, чтобы указать, какой метод применялся при создании растра направления стока.

Raster Layer
Входной растр весов
(Дополнительный)

Дополнительный входной растр, представляющий веса для каждой ячейки.

Если не задано никакого растра весов, каждой ячейке будет присвоен вес, равный единице, который используется по умолчанию. Для каждой ячейки в выходном растре результатом будет количество ячеек, из которых осуществляется сток в эту ячейку.

Raster Layer
Тип выходных данных
(Дополнительный)

Выходной растр суммарного стока может быть целочисленным, содержать значения с плавающей точкой или двойной точности.

  • Плавающая точкаВыходной растр всегда будет представлен числами с плавающей точкой. Используется по умолчанию.
  • ЦелочисленноеВыходной растр всегда будет целочисленным.
  • ДублированиеВыходной растр всегда будет двойной точности.
String
Тип входного направления стока
(Дополнительный)

Задает тип входного растра направления стока.

  • D8Входной растр направления стока имеет тип D8. Это значение по умолчанию.
  • MFDВходной растр направления стока имеет тип Multi Flow Direction (MFD).
  • DINFВходной растр направления стока имеет тип D-Infinity (DINF).
String

Возвращаемое значение

ПодписьОписаниеТип данных
Выходной растр суммарного стока

Выходной растр, содержащий информацию о суммарном стоке в каждой ячейке.

Raster

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
(Дополнительный)

Выходной растр суммарного стока может быть целочисленным, содержать значения с плавающей точкой или двойной точности.

  • FLOATВыходной растр всегда будет представлен числами с плавающей точкой. Используется по умолчанию.
  • INTEGERВыходной растр всегда будет целочисленным.
  • DOUBLEВыходной растр всегда будет двойной точности.
String
flow_direction_type
(Дополнительный)

Задает тип входного растра направления стока.

  • D8Входной растр направления стока имеет тип D8. Это значение по умолчанию.
  • MFDВходной растр направления стока имеет тип Multi Flow Direction (MFD).
  • DINFВходной растр направления стока имеет тип 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"

# Execute FlowDirection
outFlowAccumulation = FlowAccumulation(inFlowDirRaster, inWeightRaster, dataType)

# Save the output 
outFlowAccumulation.save("C:/sapyexamples/output/outflowacc02.img")

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

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

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