Расстояние стока—Справка

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

Краткая информация
Иллюстрация
Использование
Синтаксис
Пример кода
Параметры среды
Информация о лицензиях

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

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

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

Иллюстрация

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

Чтобы ограничить направления вниз по склону, вдоль которых измеряется минимальное расстояние стока, укажите дополнительный растр направления стока, который можно получить с помощью инструмента Направление стока. При построении дополнительного входного растра направления стока выберите модели D8, D-бесконечность (DINF) или Множественные направления стока (MFD). Используйте Тип направления стока, чтобы указать, какой метод применялся при создании растра направления стока.
Если задан дополнительный входной растр направления стока, рекомендуется создавать этот растр с помощью инструмента Направление стока, используя тот же входной растр поверхности, который используется и в инструменте Расстояние стока.
Если в этом входном растре поверхности отсутствуют локальные понижения, измерения расстояний будут выполнены по ячейкам потоков, определяемым входным растром потоков.
Если во входном растре поверхности присутствуют локальные понижения, ряд линий стоков будет обрываться на локальном понижении и не достигнет потока. В этом случае измерение расстояния стока для этих ячеек вычисляется только до локального понижения, в которое осуществляется сток из этих ячеек.
Если инструмент запускается без указания дополнительного растра направления стока, минимальное расстояние стока будет рассчитываться вдоль всех возможных стоков вниз по течению от каждой ячейки в направлении потока, в который осуществляется сток.
Когда инструмент запускается с дополнительным растром направления потока D8, для каждой ячейки есть только один возможный путь вниз по склону до ячейки стока, и расстояние стока измеряется вдоль этого единственного пути.
Рекомендуется создать входной растр водотоков, используя тот же самый входной растр поверхности, который применяется в инструменте. Вы можете создать растры потоков из входного растра поверхности, используя инструмент Направление стока, Суммарный сток и Условия, соответственно. Если вы хотите использовать потоки, полученные из других источников данных, для получения наилучших результатов следует сначала внести их во входной растр поверхности, а затем обработать полученный результат инструментом Расстояние стока.
Этот инструмент поддерживает параллельную обработку. Если ваш компьютер имеет несколько процессоров или процессор с несколькими ядрами, то для больших наборов данных будет достигаться лучшая производительность. В разделе Параллельная обработка в Spatial Analyst эта функция и ее настройки описаны более подробно.
При использовании параллельной обработки, для управления обрабатываемыми фрагментами записываются временные данные. Расположение папки временных файлов по умолчанию будет на вашем локальном диске C. Вы можете управлять расположением этой папки, настроив Переменную системной среды с именем TempFolders и указав путь к папке, которая будет использоваться (например, E:\RasterCache). Если у вас права администратора на вашей машине, вы можете также использовать ключ регистрации (например, [HKEY_CURRENT_USER\SOFTWARE\ESRI\Desktop10.6\Raster]).
По умолчанию, этот инструмент использует 50 процентов доступных ядер. Если входные данные меньше, чем 5,000 на 5,000 ячеек, может использоваться меньше ядер. Можно задавать число используемых инструментом ядер в среде Коэффициент параллельной обработки.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Синтаксис

FlowDistance (in_stream_raster, in_surface_raster, {in_flow_direction_raster}, {distance_type}, {flow_direction_type})

Параметр	Объяснение	Тип данных
in_stream_raster	Входной растр, который содержит линейную сеть водотоков.	Raster Layer
in_surface_raster	Входной растр непрерывной высотной поверхности.	Raster Layer
in_flow_direction_raster (Дополнительный)	Входной растр, показывающий направление стока для каждой ячейки. Если указан дополнительный растр направления стока, направления вниз по склону будут ограничиваться заданными входным растром направлениями стока. Растр направления стока может быть создан с помощью инструмента Направление стока. Входное направление стока может быть создано с помощью методов D8, Multiple Flow Direction (MFD) и D-Infinity (DINF). Используйте flow_direction_type, чтобы указать, какой метод применялся при создании растра направления стока.	Raster Layer
distance_type (Дополнительный)	Определяет, вычисляется ли вертикальный или горизонтальный компонент расстояния стока. VERTICAL —Вычисления расстояния стока представляют собой вертикальную составляющую минимального расстояния стока, следующую по пути потока из каждой ячейки домена к ячейкам потока, в который они впадают. Используется по умолчанию. HORIZONTAL —Вычисления расстояния стока представляют собой горизонтальную составляющую минимального расстояния стока, следующую по пути потока из каждой ячейки домена к ячейкам потока, в который они впадают.	String
flow_direction_type (Дополнительный)	Входной растр направления стока может быть типов: D8, Multi Flow Direction (MFD) или D-Infinity (DINF). D8 —Входной растр направления стока имеет тип D8. Используется по умолчанию. MFD —Входной растр направления стока имеет тип Multi Flow Direction (MFD)..Опция MFD доступна в ниспадающем списке, только когда для инструмента предоставлен растр направления стока с типом MFD. DINF —Входной растр направления стока имеет тип D-Infinity (DINF).	String

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

Название	Объяснение	Тип данных
out_raster	Выходной растр расстояния стока.	Raster

Пример кода

FlowDistance, пример 1 (окно Python)

В этом примере создается растр расстояния стока.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFlowDistance = FlowDistance("streams", "elevation", "", "VERTICAL")
outFlowDistance.save("C:/sapyexamples/output/outflowdist01")

FlowDistance, пример 2 (автономный скрипт)

В этом примере создается растр расстояния стока.

# Name: FlowDistance_Example.py
# Description: Creates a raster of horizontal flow distance from each cell to a cell 
# on the stream into which it drains.
# 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
inStreamRaster = "streams"
inSurfaceRaster = "elevation"
inFlowDirectionRaster = "flowdir"


# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute FlowDistance
outFlowDistance = FlowDistance(inStreamRaster, inSurfaceRaster, inFlowDirectionRaster, "HORIZONTAL")

# Save the output 
outFlowDistance.save("C:/sapyexamples/output/outflowdist02")

ArcMap

Расстояние стока