Расстояние стока (Spatial Analyst)

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

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

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

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

Иллюстрация

Иллюстрация инструмента Расстояние стока

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

  • Чтобы ограничить направления вниз по склону, вдоль которых измеряется расстояние стока, укажите дополнительный растр направления стока, который можно получить с помощью инструмента Направление стока. При построении дополнительного входного растра направления стока выберите модели D8, D-бесконечность (DINF) или Множественные направления стока (MFD). Используйте Тип направления стока, чтобы указать, какой метод применялся при создании растра направления стока.

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

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

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

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

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

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

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

  • Рекомендуется создавать входной растр водотоков, используя тот же входной растр поверхности, что применяется в качестве входных данных в инструменте. Вы можете создать растры потоков из входного растра поверхности, используя инструмент Направление стока, Суммарный сток и Условия, соответственно. Если вы хотите использовать потоки, полученные из других источников данных, для получения наилучших результатов следует сначала внести их во входной растр поверхности, а затем обработать полученный результат инструментом Расстояние стока.

  • Этот инструмент поддерживает параллельную обработку. Если ваш компьютер имеет несколько процессоров или процессор с несколькими ядрами, то его производительность будет более высокой, особенно на больших наборах данных. Раздел справки Параллельная обработка в Spatial Analyst содержит более подробные сведения об этой возможности и способах ее настройки.

    При использовании параллельной обработки будут записаны временные данные для управления обрабатываемыми фрагментами данных. Расположение папки временных файлов по умолчанию будет на вашем локальном диске C:. Вы можете управлять расположением этой папки, настроив Переменную системной среды с именем TempFolders и указав путь к папке, которая будет использоваться (например, E:\RasterCache). Если у вас есть права администратора на вашей машине, вы можете также использовать ключ регистрации (например, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]).

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

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

Параметры

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

Входной растр, который содержит линейную сеть водотоков.

Raster Layer
Входная растровая поверхность

Входной растр непрерывной высотной поверхности.

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

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

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

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

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

Raster Layer
Тип расстояния
(Дополнительный)

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

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

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

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

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

  • МинимумЕсли имеется несколько путей, вычисляется минимальный. Используется по умолчанию.
  • Взвешенное среднееПри наличии нескольких путей стока, будет вычислено средневзвешенное значение расстояния стока. Величина стока от ячейки к соседним ячейкам вниз по течению используется в качестве весов при вычислении средневзвешенного значения.
  • МаксимумПри наличии нескольких путей стока, будет вычислено максимальное значение расстояния стока.
String

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

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

Выходной растр расстояния стока.

Raster

FlowDistance(in_stream_raster, in_surface_raster, {in_flow_direction_raster}, {distance_type}, {flow_direction_type}, {statistics_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Входной растр направления стока имеет тип D8. Это значение по умолчанию.
  • MFDВходной растр направления стока имеет тип Multi Flow Direction (MFD).
  • DINFВходной растр направления стока имеет тип D-Infinity (DINF).
String
statistics_type
(Дополнительный)

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

  • MINIMUMЕсли имеется несколько путей, вычисляется минимальный. Используется по умолчанию.
  • WEIGHTED_MEANПри наличии нескольких путей стока, будет вычислено средневзвешенное значение расстояния стока. Величина стока от ячейки к соседним ячейкам вниз по течению используется в качестве весов при вычислении средневзвешенного значения.
  • MAXIMUMПри наличии нескольких путей стока, будет вычислено максимальное значение расстояния стока.
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")

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

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

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