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

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

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

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

Иллюстрация

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

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

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

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

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

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

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

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

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

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

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

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

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

Параметры

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

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

Raster Layer; Image Service; String
Растр входной поверхности

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

Raster Layer; Image Service; String
Выходное имя

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Raster Layer

arcpy.ra.FlowDistance(inputStreamRaster, inputSurfaceRaster, outputName, {inputFlowDirectionRaster}, {distanceType}, {flowDirectionType}, {statisticsType})
ИмяОписаниеТип данных
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

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

ИмяОписаниеТип данных
outputRaster

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

Raster Layer

Пример кода

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

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

import arcpy
arcpy.ra.FlowDistance("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.ra.FlowDistance(inStreams, inSurface, outputFlowDistance, inFlowDirection, distanceType)

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

  • Basic: Обязательно ArcGIS Image Server
  • Standard: Обязательно ArcGIS Image Server
  • Advanced: Обязательно ArcGIS Image Server

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