Привязка точки устья (Spatial Analyst)

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

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

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

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

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

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

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

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

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

  • Если формат выходного растра .crf, этот инструмент поддерживает параметр среды хранения растровых изображений Пирамида. Пирамиды будут созданы в выходных данных по умолчанию. Для любого другого формата вывода этот параметр среды не поддерживается, и пирамиды создаваться не будут.

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

Параметры

ПодписьОписаниеТип данных
Входные растровые или векторные данные точек устьев

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

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

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

Raster Layer; Feature Layer
Входной растр суммарного стока

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

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

Raster Layer
Расстояние привязки

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

Double
Поле точек устьев
(Дополнительный)

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

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

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

Field

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

ПодписьОписаниеТип данных
Выходной растр

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

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

Raster

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

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

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

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"

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

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

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

  • Basic: Обязательно Spatial Analyst
  • Standard: Обязательно Spatial Analyst
  • Advanced: Обязательно Spatial Analyst

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