Доступно с лицензией 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 для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
FlowDistance(in_stream_raster, in_surface_raster, {in_flow_direction_raster}, {distance_type}, {flow_direction_type}, {statistics_type})
Parameter | Объяснение | Тип данных |
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 (Дополнительный) | Определяет, вычисляется ли вертикальный или горизонтальный компонент расстояния стока.
| String |
flow_direction_type (Дополнительный) | Задает тип входного растра направления стока.
| String |
statistics_type (Дополнительный) | Определяет тип статистики, используемый для вычисления расстояния стока по нескольким путям. Если из каждой ячейки в другую возможен только один путь стока, все типы статистики дадут одинаковый результат.
| String |
Значение отраженного сигнала
Name | Объяснение | Тип данных |
out_raster | Выходной растр расстояния стока. | Raster |
Пример кода
В этом примере создается растр расстояния стока.
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")
В этом примере создается растр расстояния стока.
# 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")
Environments
Информация о лицензиях
- Basic: Требуется Spatial Analyst
- Standard: Требуется Spatial Analyst
- Advanced: Требуется Spatial Analyst