Сводка
Подсчитывает для каждой ячейки горизонтальный или вертикальный компонент расстояния вниз по склону, вдоль линии стока к ячейкам, в которые осуществляется сток. В случае нескольких путей стока может быть вычислено минимальное, взвешенное среднее или максимальное расстояние стока.
При использовании дополнительного растра направления стока, направления вниз по склону будут ограничены теми, которые находятся во входном растре направления.
Иллюстрация
Использование
Этот инструмент портала для анализа растров доступен, если вы выполнили вход в ArcGIS Enterprise портал с расширением ArcGIS Image Server настроенный для Raster Analysis . При вызове инструмента сервера ArcGIS Pro являются клиентами, и обработка будет выполнятся на серверах, интегрированных с ArcGIS Enterprise. Инструмент портала использует слои портала в качестве входных данных и создает выходные данные на этом же портале.
Параметр Входной растровый слой поддерживает следующие элементы: слой портала, URI или URL сервиса изображений, выходные данные инструмента Создать слой сервера изображений. Указанный инструмент не поддерживает локальные наборы растровых данных или слои.
Чтобы ограничить направления вниз по склону, вдоль которых измеряется расстояние стока, укажите дополнительный растр направления стока, который можно получить с помощью инструмента Направление стока. При построении дополнительного входного растра направления стока выберите модели D8, D-бесконечность (DINF) или Множественные направления стока (MFD). Используйте Тип направления стока, чтобы указать, какой метод применялся при создании растра направления стока.
Если задан дополнительный входной растр направления стока, лучше, чтобы при его создании инструментом Направление стока использовался тот же входной растр поверхности, который вы будете указывать в инструменте Расстояние стока.
Если в этом входном растре поверхности отсутствуют локальные понижения, измерения расстояний будут выполнены по ячейкам потоков, определяемым входным растром потоков.
Если во входном растре поверхности присутствуют локальные понижения, ряд линий стоков будет обрываться на локальном понижении и не достигнет потока. В этом случае измерение расстояния стока для этих ячеек вычисляется только до локального понижения, в которое осуществляется сток из этих ячеек.
Если инструмент запускается без указания дополнительного растра направления стока, расстояние стока будет рассчитываться вдоль всех возможных стоков вниз по течению от каждой ячейки в направлении потока, в который осуществляется сток.
Когда инструмент запускается с дополнительным растром направления потока D8, для каждой ячейки есть только один возможный путь вниз по склону до ячейки стока, и расстояние стока измеряется вдоль этого единственного пути.
Рекомендуется создавать входной растр водотоков, используя тот же входной растр поверхности, что применяется в качестве входных данных в инструменте. Если у вам доступна лицензия на дополнительный модуль Spatial Analyst, вы можете создать растры потоков из входного растра поверхности, используя инструмент Направление стока, Суммарный сток и Условия, соответственно. Если вы хотите использовать потоки, полученные из других источников данных, для получения наилучших результатов следует сначала внести их во входной растр поверхности, а затем обработать полученный результат инструментом Расстояние стока.
Если существует несколько путей стока из каждой ячейки в ячейки стока, используйте Тип статистики для вычисления минимального, средневзвешенного или максимального расстояния стока.
Если существует только один путь стока из каждой ячейки в ячейки стока, для всех типов статистики будет вычислено одинаковое значение.
Синтаксис
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, Multiple Flow Direction (MFD) или D-Infinity (DINF). Используйте параметр flowDirectionType, чтобы указать, какой метод применялся при создании растра направления стока. | Raster Layer; Image Service; String |
distanceType (Дополнительный) | Тип вычисляемого расстояния.
| String |
flowDirectionType (Дополнительный) | Задает тип входного растра направления стока.
| String |
statisticsType (Дополнительный) | Определяет тип статистики, используемый для вычисления расстояния стока по нескольким путям стока. Если существует только один путь стока из каждой ячейки в ячейки стока, для всех типов статистики будет вычислено одинаковое значение.
| String |
Производные выходные данные
Name | Объяснение | Тип данных |
outputRaster | Выходной растр. | Растровый слой |
Пример кода
В этом примере вычисляется минимальное горизонтальное расстояние стока вниз по склону до ячейки растра водотоков.
import arcpy
arcpy.FlowDistance_ra("https://myserver/rest/services/streams/ImageServer","https://myserver/rest/services/elevation_fill/ImageServer","outFlowDistanceVertical1")
В этом примере вычисляется минимальное вертикальное расстояние стока вниз по склону до ячейки растра водотоков.
#---------------------------------------------------------------------------
# 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)
Environments
Информация о лицензиях
- Basic: Требуется ArcGIS Image Server
- Standard: Требуется ArcGIS Image Server
- Advanced: Требуется ArcGIS Image Server