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

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

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

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

Иллюстрация

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

Этот инструмент портала для анализа растров доступен, если вы выполнили вход в ArcGIS Enterprise портал с расширением ArcGIS Image Server настроенный для Raster Analysis . Когда инструмент запускается, 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

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

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

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	Выходной растр.	Растровый слой

Пример кода

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)

Параметры среды

Размер ячейки, Экстент, Маска, Выходная система координат, Растр привязки

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

Иллюстрация

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

Параметры

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

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

Пример кода

Параметры среды

Особые случаи

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

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

В этом разделе