Выровнять водотоки по растру (Инструменты Spatial Analyst)

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

Корректирует входные данные объектов водотоков в соответствии с разрешением входного растра.

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

Параметр Выходные скорректированные объекты водотоков (out_stream_features в Python) представляет собой объекты линии потока в значении параметра Входные объекты водотоков (in_stream_features в Python) после корректировки в соответствии с разрешением значения параметра Входной растр (in_raster в Python).
Процесс корректировки гарантирует, что скорректированная линия потока пересекает каждую перекрывающуюся ячейку в значении параметра Входной растр в её центре, сохраняя при этом исходный путь линии потока.
Дополнительное значение параметра Группировать по полю (group_by_field в Python) группирует сегменты водотока на основе выбранного поля. По умолчанию к значению параметра Входные объекты водотоков не применяется группировка, если только оно не содержит линии потока, сегментированные на разные части, но принадлежащие одному сегменту водотока. В этом случае они будут объединены, чтобы гарантировать, что каждому сегменту водотока на выходе будет присвоен уникальный идентификатор. Если значения полей присваивают уникальный идентификатор каждому сегменту водотока, группировка не будет выполнена.
Растровое представление скорректированных линий потока можно сохранить, указав значение параметра Выходной скорректированный растр водотока (out_stream_raster в Python).
Дополнительное значение параметра Группировать по полю (group_by_field в Python) определяет значения ячейки в значении параметра Выходной скорректированный растр водотока.
Направление стока воды (D8) в каждой ячейке для скорректированных водотоков можно сохранить, указав значение параметра Выходной растр направления стока (out_flow_direction_raster в Python).
Используйте параметр Удалить острые углы (remove_sharp_angles в Python), чтобы убедиться в отсутствии линий шириной в одну ячейку, образующих углы в 90 градусов, в значении параметра Выходные скорректированные объекты водотоков.
Если ожидается, что значение параметра Входные объекты водотоков (in_stream_features в Python) будет иметь места, где поток разделяется на два, и один из них считается основным руслом, основное русло можно указать с помощью параметра Расходящийся поток или Поле дальнейшего пути (divergent_flow_or_next_field в Python). В этом случае, поле с именем HydroID должно быть представлено в таблице атрибутов значения параметра Входные объекты водотоков (in_stream_features в Python). Для водотока, который разбивается на два, выбранное поле должно указывать на HydroID водотока, который считается основным руслом.
Максимальное количество объектов водотоков, которые может обработать инструмент, – 2 147 483 647 (2^31 - 1).
По умолчанию, экстентом анализа является экстент значения параметра Входные объекты водотоков (in_stream_features в Python).
См. Параметры среды анализа и Spatial Analyst для получения дополнительной информации о параметрах среды геообработки, применимых к этому инструменту.

Подпись	Объяснение	Тип данных
Входные объекты водотоков	Объекты линий потока, которые будут скорректированы в соответствии с разрешением входного растра.	Feature Dataset
Входной растр	Растр, в соответствии с которым будут скорректированы входные объекты линий потока.	Raster Dataset
Выходные скорректированные объекты водотоков	Ступенчатое неровное представление входных объектов линий потока в соответствии с разрешением входного растра. Выходные объекты водотоков будут сгруппированы на основе значения параметра Группировать по полю. Помимо указанного поля, если таковое имеется, таблица атрибутов также будет иметь следующее поле: `StreamLink`—ID, назначенный связям водотоков. Связи – это фрагменты русла водотока, связывающие два последовательных соединения.	Feature Class
Группировать по полю (Дополнительный)	Поле, содержащее значения, которые будут использованы для группировки водотоков в значениях параметров Выходные скорректированные объекты водотоков и Выходной скорректированный растр водотока. Значения в этом поле должны быть целым числом.	Field
Удалить острые углы (Дополнительный)	Указывает, будут ли острые углы удалены из выходных объектов водотоков. Острые углы представляют собой 90-градусные сегменты линий шириной в одну ячейку. Отмечено–Все сегменты линий, соответствующие критериям, будут упрощены, а острые углы будут удалены из выходных данных. Используется по умолчанию. Не отмечено–Сегменты линий не будут изменены, а острые углы не будут удалены из выходных данных.	Boolean
Расходящийся поток или Поле дальнейшего пути (Дополнительный)	Поле в значении параметра Входные объекты водотоков, указывающее основное русло после разделения потока. Сегмент водотока, соответствующий основному руслу, должен быть указан с помощью идентификатора. Идентификатор должен присутствовать и быть указан в поле с именем `HydroID`.	Field
Выходной скорректированный растр водотока (Дополнительный)	Растровая версия значения параметра Выходные скорректированные объекты водотоков. Значения ячеек соответствуют значениям в поле, указанном в значении параметра Группировать по полю.	Raster Dataset
Выходной растр направления стока (Дополнительный)	Растр, который будет хранить направление стока (D8) в ячейках водотока, соответствующих направлению оцифровки входных объектов водотока.	Raster Dataset
Выходные разбивающие точечные объекты (Дополнительный)	Места, где происходит разбиение потоков, и связанные с ними узлы связности в выходных скорректированных объектах водотоков.	Feature Class

AdjustStreamToRaster(in_stream_features, in_raster, out_stream_features, {group_by_field}, {remove_sharp_angles}, {divergent_flow_or_next_field}, {out_stream_raster}, {out_flow_direction_raster}, {out_split_point_features})

Имя	Объяснение	Тип данных
in_stream_features	Объекты линий потока, которые будут скорректированы в соответствии с разрешением входного растра.	Feature Dataset
in_raster	Растр, в соответствии с которым будут скорректированы входные объекты линий потока.	Raster Dataset
out_stream_features	Ступенчатое неровное представление входных объектов линий потока в соответствии с разрешением входного растра. Выходные объекты водотоков будут сгруппированы на основе значения параметра `group_by_field`. Помимо указанного поля, если таковое имеется, таблица атрибутов также будет иметь следующее поле: `StreamLink`—ID, назначенный связям водотоков. Связи – это фрагменты русла водотока, связывающие два последовательных соединения.	Feature Class
group_by_field (Дополнительный)	Поле, содержащее значения, которые будут использованы для группировки водотоков в значениях параметров `out_stream_features` и `out_stream_raster`. Значения в этом поле должны быть целым числом.	Field
remove_sharp_angles (Дополнительный)	Указывает, будут ли острые углы удалены из выходных объектов водотоков. Острые углы представляют собой 90-градусные сегменты линий шириной в одну ячейку. `REMOVE`–Все сегменты линий, соответствующие критериям, будут упрощены, а острые углы будут удалены из выходных данных. Используется по умолчанию. `NO_REMOVE`–Сегменты линий не будут изменены, а острые углы не будут удалены из выходных данных.	Boolean
divergent_flow_or_next_field (Дополнительный)	Поле в значении параметра `in_stream_features`, указывающее основное русло после разделения потока. Сегмент водотока, соответствующий основному руслу, должен быть указан с помощью идентификатора. Идентификатор должен присутствовать и быть указан в поле с именем `HydroID`.	Field
out_stream_raster (Дополнительный)	Растровая версия значения параметра `out_stream_features`. Значения ячеек соответствуют значениям в поле, указанном в значении параметра `group_by_field`.	Raster Dataset
out_flow_direction_raster (Дополнительный)	Растр, который будет хранить направление стока (D8) в ячейках водотока, соответствующих направлению оцифровки входных объектов водотока.	Raster Dataset
out_split_point_features (Дополнительный)	Места, где происходит разбиение потоков, и связанные с ними узлы связности в выходных скорректированных объектах водотоков.	Feature Class

Пример кода

AdjustStreamToRaster пример 1 (окно Python)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/arcpyexamples/data.gdb"

AdjustStreamToRaster(in_stream_features="streams",
                     in_raster="elevation",
                     out_stream_features="out_stream_features",
                     group_by_field="NONE",
                     remove_sharp_angles="REMOVE",
                     divergent_flow_or_next_field="NONE",
                     out_stream_raster="out_stream_raster",
                     out_flow_direction_raster="out_stream_flowdir_raster",
                     out_split_point_features=None
                     )

AdjustStreamToRaster пример 2 (автономный скрипт)

# Name: AdjustStreamToRaster_standalone.py
# Description: Adjust the input streams features to the resolution of the input raster.
# No groupping specified, therefore, the result will have as many number of features as
# there are stream segments.
# Requirements: Spatial Analyst extension

# Import system modules
import arcpy
from arcpy.sa import *

# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/data"

# Set local variables
InStreamFeatures="streams.shp"
InRaster = "elevation.tif"
OutStreamFeatures = "out_adjusted_streams.shp"
OutStreamRaster = "out_adjusted_streams.tif"
OutFlowDirRaster = "out_streams_fdr.tif"

# Run the tool
AdjustStreamToRaster(InStreamFeatures,
                     InRaster,
                     OutStreamFeatures,
                     "NONE",
                     "",
                     "NONE",
                     OutStreamRaster,
                     OutFlowDirRaster,
                     "")

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

Автоподтверждение, Текущая рабочая область, Выходное Z-значение по умолчанию, Экстент, Географические преобразования, Разрешение M, Допуск M, Выходное ключевое слово конфигурации, Выходная система координат, Наличие выходных значений M, Выходные данные содержат Z значения, Выходной M домен, Выходной XY домен, Выходной Z домен, Временная рабочая область, Разрешение XY, Допуск XY, Разрешение Z, Допуск Z

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