Доступно с лицензией Spatial Analyst.
Краткая информация
Вычисляет расстояние вверх или вниз по течению, или взвешенное расстояние, вдоль потока для каждой ячейки.
Использование
Инструмент Длина линии стока главным образом применяется для вычисления длины самого длинного маршрута стока внутри заданного бассейна. Это измерение часто используется для вычисления времени заполнения бассейна. Эта операция может быть выполнена с использованием опции UPSTREAM.
Инструмент может быть также использован для создания графиков «расстояние-площадь» при моделировании осадков и поверхностного стока с применением растра весов как фактора сопротивления движению вниз по склону.
Тип значений для выходного растра инструмента Длина линии стока - число с плавающей точкой.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
FlowLength (in_flow_direction_raster, {direction_measurement}, {in_weight_raster})| Параметр | Объяснение | Тип данных |
in_flow_direction_raster | Входной растр, показывающий направление стока для каждой ячейки. Растр направления стока может быть создан с помощью инструмента Направление стока (Flow Direction). | Raster Layer |
direction_measurement (Дополнительный) | Направление измерений вдоль линии стока.
| String |
in_weight_raster (Дополнительный) | Дополнительный входной растр, представляющий веса для каждой ячейки. Если не задано никакого растра весов, каждой ячейке будет присвоен вес, равный единице, который используется по умолчанию. Для каждой ячейки в выходном растре результатом будет количество ячеек, из которых осуществляется сток в эту ячейку. | Raster Layer |
Возвращаемое значение
| Название | Объяснение | Тип данных |
| out_raster | Создаваемый растр, в котором для каждой ячейки вычисляется длина линии стока вверх или вниз по склону. | Raster |
Пример кода
Длина линии стока. Пример 1 (окно Python)
В этом примере вычисляется расстояние вдоль линии стока для каждой ячейки вверх по склону или вниз по склону.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFlowLength = FlowLength("flowdir", "DOWNSTREAM", "")
outFlowLength.save("c:/sapyexamples/output/outflowlen01")
FlowLength, пример 2 (автономный скрипт)
В этом примере вычисляется расстояние вдоль линии стока для каждой ячейки вверх по склону или вниз по склону.
# Name: _Ex_02.py
# Description:
# 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
inFlowDirectionRaster = "flowdir"
inWeightRaster = ""
directionType = "DOWNSTREAM"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute
outFlowLength = FlowLength(inFlowDirectionRaster, directionType, inWeightRaster)
# Save the output
outFlowLength.save("c:/sapyexamples/output/outflowlen02.tif")
Параметры среды
- Автоподтверждение (Auto Commit)
- Размер ячейки (Cell size)
- Текущая рабочая область (Current Workspace)
- Экстент (Extent)
- Географические преобразования (Geographic Transformations)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Выходная система координат (Output Coordinate System)
- Статистика растра (Raster Statistics)
- Временная рабочая область (Scratch Workspace)
- Растр привязки (Snap Raster)
- Размер листа (Tile Size)
Информация о лицензиях
- ArcGIS Desktop Basic: Требует Spatial Analyst
- ArcGIS Desktop Standard: Требует Spatial Analyst
- ArcGIS Desktop Advanced: Требует Spatial Analyst