Доступно с лицензией Spatial Analyst.
Краткая информация
Преобразует растр, представляющий линейную сеть в векторные объекты, представляющие сеть линий.
Более подробно о том, как работает инструмент Водоток в пространственный объект
Использование
Входная растровая линейная сеть водотоков должна быть представлена в виде значений, больше или равных единице, на фоне значений NoData (Нет данных).
-
Для создания растровой сети водотоков могут быть использованы результаты инструмента Направление стока (Flow Accumulation), к которым применяется пороговое значение, позволяющее выбрать ячейки с высоким суммарным стоком. Например, для определения сети водотоков будут использоваться ячейки, в которые выполняется сток из более чем 100 ячеек. Для создания растра сети водотоков из ячеек с суммарным стоком больше или равным 100 воспользуйтесь инструментами Условие (Con) или Установить Null, которые позволяют присвоить таким ячейкам значение, равное единице, а остальным ячейкам – значение фона (NoData – нет данных). Результирующая сеть водотоков может быть использована в инструментах Идентификация водотоков (Stream Link) и Водоток в пространственный объект (Stream to Feature).
Должны существовать непрерывные объекты с одним и тем же значением, например, результаты инструментов Порядок водотоков (Stream Order) или Связь водотоков (Stream Link). Инструмент Водоток в пространственный объект не должен применяться к растру, на котором есть несколько смежных ячеек с одинаковым значением.
Выходные объекты будут направлены вниз по течению.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
StreamToFeature (in_stream_raster, in_flow_direction_raster, out_polyline_features, {simplify})
Параметр | Объяснение | Тип данных |
in_stream_raster |
Входной растр, который представляет линейную сеть водотоков. | Raster Layer |
in_flow_direction_raster | Входной растр, показывающий направление стока для каждой ячейки. Растр направления стока может быть создан с помощью инструмента Направление стока (Flow Direction). | Raster Layer |
out_polyline_features | Выходной класс векторных объектов, в котором будут храниться преобразованные водотоки. | Feature Class |
simplify (дополнительно) | Определяет, будет ли использоваться прореживание.
По умолчанию прореживание применяется. | Boolean |
Пример кода
StreamToFeature, пример 1 (окно Python)
В этом примере конвертируется растр, представляющий линейную сеть в пространственные объекты.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
StreamToFeature("stream", "flowdir", "c:/sapyexamples/output/outstrm01.shp",
"NO_SIMPLIFY")
StreamToFeature, пример 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
inStreamRaster = "stream"
inFlowDir = "flowdir"
outStreamFeats = "c:/sapyexamples/output.gdb/outstrm02"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute
StreamToFeature(inStreamRaster, inFlowDir, outStreamFeats,
"NO_SIMPLIFY")
Параметры среды
- Автоподтверждение (Auto Commit)
- Текущая рабочая область (Current Workspace)
- Выходное значение Z по умолчанию (Default Output Z Value)
- Экстент (Extent)
- Географические преобразования (Geographic Transformations)
- Маска (Mask)
- Разрешение M (M Resolution)
- Допуск M (M Tolerance)
- Сохранять пространственный индекс (Maintain Spatial Index)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Выходная система координат (Output Coordinate System)
- Выходные данные содержат значения M (Output has M values)
- Выходные данные содержат Z значения (Output has Z values)
- Выходной домен M (Output M Domain)
- Выходной XY домен (Output XY Domain)
- Выходной домен Z (Output Z Domain)
- Временная рабочая область (Scratch Workspace)
- Растр привязки (Snap Raster)
- Разрешение XY (XY Resolution)
- Допуск XY (XY Tolerance)
- Разрешение Z (Z Resolution)
- Допуск Z (Z Tolerance)