ArcMap

Привязка точки устья

Доступно с лицензией Spatial Analyst.

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

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

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

  • Инструмент Привязка точки устья (Snap Pour Point) используется для обеспечения выборки точек с высоким суммарным стоком при выделении водосборных бассейнов с использованием инструмента Водораздел (Watershed). Инструмент Привязка точки устья (Snap Pour Point) будет выполнять поиск ячеек с наивысшим суммарным стоком в пределах величины допуска вокруг заданных точек устьев и сдвигать точку устья в это положение.

  • Если входные данные точки устьев представлены в виде класса точечных объектов, они будут внутренне конвертированы в растр для последующей обработки.

  • Выходные данные – это целочисленный растр, на котором исходные положения точек устьев привязаны к местоположениям с высоким суммарным стоком.

  • Если существует только одно входное положение точек устьев, экстент выходных данных будет соответствовать экстенту растра суммарного стока. Если существует больше одной точки устья, экстент выходных данных определяется параметром среды Выходной экстент (Output extent).

  • При указании входных положений точек устьев в качестве данных объектов полем по умолчанию будет первое доступное и допустимое поле. Если допустимых полей нет, по умолчанию используется поле ObjectID (например, OID или FID).

  • См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Синтаксис

SnapPourPoint (in_pour_point_data, in_accumulation_raster, snap_distance, {pour_point_field})
ПараметрОбъяснениеТип данных
in_pour_point_data

Входное положение точек устьев.

Для входных данных растров все ячейки, значение которых отличается от значения NoData (т.е. которые имеют значение), будут рассматриваться как точки устьев и будут привязаны.

Для входных данных точечных объектов будут указаны положения ячеек, для которых будет выполняться привязка.

Raster Layer | Feature Layer
in_accumulation_raster

Входной растр суммарного стока.

Он может быть создан с использованием инструмента Суммарный сток (Flow Accumulation).

Raster Layer
snap_distance

Максимальное расстояние, в единицах карты, в пределах которого выполняется поиск ячейки с самым высоким суммарным стоком.

Double
pour_point_field
(Дополнительный)

Поле, используемое для присвоения значений местоположениям точек устьев.

Если входные данные по точкам устьев – растр, используйте поле Value.

Если входные данные по точкам устьев – векторные данные, используйте числовое поле. Если поле содержит значения с плавающей точкой, они будут округлены до целых чисел.

Field

Возвращаемое значение

НазваниеОбъяснениеТип данных
out_raster

Выходной растр точек устья, на котором исходные положения точек устьев привязаны к местоположениям с высоким суммарным стоком.

Эти выходные данные будут целочисленными.

Raster

Пример кода

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

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outSnapPour = SnapPourPoint("pourpoint", "flowaccumulation.img", 5,"VALUE") 
outSnapPour.save("c:/sapyexamples/output/outsnpprpnt01")
SnapPourPoint, пример 2 (автономный скрипт)

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

# Name: SnapPourPoints_Ex_02.py
# Description: Snaps pour points to the cell of highest 
#              flow accumulation within a specified distance.
# 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
inPourPoint = "pourpoint"
inFlowAccum = "flowaccumulation.img"
tolerance = 5
pourField = "VALUE"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute SnapPourPoints
outSnapPour = SnapPourPoint(inPourPoint, inFlowAccum, tolerance, 
                            pourField) 

# Save the output 
outSnapPour.save("c:/sapyexamples/output/outsnpprpnt02")

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

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

  • ArcGIS Desktop Basic: Требует Spatial Analyst
  • ArcGIS Desktop Standard: Требует Spatial Analyst
  • ArcGIS Desktop Advanced: Требует Spatial Analyst

Связанные разделы