Водораздел (Watershed) (Spatial Analyst)
Краткая информация
Определяет водосборную область, расположенную выше набора ячеек растра.
Более подробно о том, как работает инструмент Водосборная область
Использование
-
Значение для каждой водосборной области будет определено, исходя из источника во входном растре или векторных данных по точкам устьев. Когда точки устьев представлены в виде набора растровых данных, будут использованы значения ячеек. Когда точки устьев даны в виде набора точечных данных, значения будут взяты из заданного пользователем поля.
-
Лучшие результаты будут получены в том случае, если сначала будет использован инструмент Привязка точки устья (Snap Pour Point), который позволит определить положение точек устьев, привязав их к ячейкам с высоким суммарным стоком.
При указании входных положений точек устьев в качестве данных объектов полем по умолчанию будет первое доступное и допустимое поле. Если допустимых полей нет, по умолчанию используется поле ObjectID (например, OID или FID).
Синтаксис
| Параметр | Объяснение | Тип данных |
in_flow_direction_raster |
Входной растр направления стока. Растр направления потока может быть создан с помощью инструмента Направление потока (Flow Direction). | Raster Layer |
in_pour_point_data |
Входные положения точек устьев. Для растра этот параметр представляет ячейки, выше которых будет определяться водосборная область. В качестве входных ячеек будут использоваться все ячейки, значение которых отличается от значения NoData. Для набора данных точечных объектов этот параметр представляет местоположения, для которых будет определяться расположенная выше них водосборная область. | Raster Layer | Feature Layer |
pour_point_field (дополнительно) |
Поле, используемое для присвоения значений местоположениям точек устьев. Если входные данные по точкам устьев - растр, используйте поле Value. Если входные данные по точкам устьев - векторные данные, используйте числовое поле. Если поле содержит значения с плавающей точкой, они будут округлены до целых чисел. | Field |
Возвращено значение
| Имя | Объяснение | Тип данных |
| out_raster |
Выходной растр, показывающий область водосборов. Он будет целочисленного типа. | Raster |
Пример кода
В этом примере определяется область водоразделов для выбранного местоположения точки устья на растре направления водотоков GRID.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outWatershed = Watershed("flowdir", "pourpoint")
outWatershed.save("C:/sapyexamples/output/outwtrshd01")
В этом примере определяется область водоразделов для выбранного местоположения точки устья на растре направления водотоков GRID, и выводится водораздел как растр TIFF.
# Name: Watershed_Ex_02.py
# Description: Determines the contributing area above a set of cells in a
# raster.
# 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
inFlowDirection = "flowdir"
inPourPointData = "pourpoint"
inPourPointField = "VALUE"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Watershed
outWatershed = Watershed(inFlowDirection, inPourPointData, inPourPointField)
# Save the output
outWatershed.save("C:/sapyexamples/output/outwtrshd02.tif")