Расстояние стока (Анализ растра)

Сводка

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

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

Иллюстрация

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

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

  • Этот инструмент портала для анализа растров доступен, если вы выполнили вход в ArcGIS Enterprise Ссылка на разбор анализа в ArcGIS Enterprise портал с расширением ArcGIS Image Server Ссылка на раздел Что такое ArcGIS Image Server настроенный для Raster Analysis Ссылка на настройку и развертывание аналитики растров. Когда инструмент запускается, ArcGIS Pro выступает в качестве клиента, и обработка проходит на серверах, интегрированных с ArcGIS Enterprise. Инструмент портала использует слои портала в качестве входных данных и создает выходные данные на этом же портале.

    Параметр Входной растровый слой поддерживает слой портала, URI или URL сервиса изображений или выходные данные инструмента Создать слой сервера изображений. Указанный инструмент не поддерживает локальные наборы растровых данных или слои.

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

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

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

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

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

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

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

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

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

Синтаксис

arcpy.ra.FlowDistance(inputStreamRaster, inputSurfaceRaster, outputName, {inputFlowDirectionRaster}, {distanceType}, {flowDirectionType}, {statisticsType})
ParameterОбъяснениеТип данных
inputStreamRaster

Входной растр, содержащий сеть водотоков.

Raster Layer; Image Service; String
inputSurfaceRaster

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

Raster Layer; Image Service; String
outputName

Имя выходного сервиса растра расстояния стока.

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

String
inputFlowDirectionRaster
(Дополнительный)

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

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

Растр направления стока может быть создан с помощью методов D8, MFD и DINF. Используйте параметр flowDirectionType, чтобы указать, какой метод применялся при создании растра направления стока.

Raster Layer; Image Service; String
distanceType
(Дополнительный)

Тип вычисляемого расстояния.

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

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

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

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

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

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

Производные выходные данные

NameОбъяснениеТип данных
outputRaster

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

Растровый слой

Пример кода

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

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

import arcpy
arcpy.FlowDistance_ra("https://myserver/rest/services/streams/ImageServer","https://myserver/rest/services/elevation_fill/ImageServer","outFlowDistanceVertical1")
FlowDistance, пример 2 (автономный скрипт)

В этом примере вычисляется минимальное вертикальное расстояние стока вниз по склону до ячейки растра водотоков.

#---------------------------------------------------------------------------
# Name: FlowDistance_example02.py
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inStreams = "https://myserver/rest/services/streams/ImageServer"
inSurface = "https://myserver/rest/services/elevation_fill/ImageServer"
outputFlowDistance = "outFlowDistanceVertical2"
inFlowDirection = ""
distanceType = "VERTICAL"

# Execute Flow Distance raster analysis tool
arcpy.FlowDistance_ra(inStreams, inSurface, outputFlowDistance, inFlowDirection, distanceType)

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

  • Basic: Требуется ArcGIS Image Server
  • Standard: Требуется ArcGIS Image Server
  • Advanced: Требуется ArcGIS Image Server

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