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

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

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

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

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

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

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

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

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

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

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

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входные растровые или векторные данные точек устьев	Входное положение точек устьев. Для входных данных растров все ячейки, значение которых отличается от значения NoData (т.е. которые имеют значение), будут рассматриваться как точки устьев и будут привязаны. Для входных данных точечных объектов будут указаны положения ячеек, для которых будет выполняться привязка.	Raster Layer; Feature Layer
Входной растр суммарного стока	Входной растр суммарного стока. Он может быть создан с использованием инструмента Суммарный сток.	Raster Layer
Расстояние привязки	Максимальное расстояние, в единицах карты, в пределах которого выполняется поиск ячейки с самым высоким суммарным стоком.	Double
Поле точек устьев (Дополнительный)	Поле, используемое для присвоения значений местоположениям точек устьев. Если входные данные по точкам устьев – растровые, используйте Value. Если входные данные по точкам устьев – векторные данные, используйте числовое поле. Если поле содержит значения с плавающей точкой, они будут округлены до целых чисел.	Field

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

Подпись	Описание	Тип данных
Выходной растр	Выходной растр точек устья, на котором исходные положения точек устьев привязаны к местоположениям с высоким суммарным стоком. Эти выходные данные будут целочисленными.	Raster

Python

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")

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

Автоматическое подтверждение, Размер ячейки, Метод проецирования размера ячейки, Сжатие, Текущая рабочая область, Экстент, Географические преобразования, Маска, Выходное ключевое слово CONFIG, Выходная система координат, Пирамидные слои, Временная рабочая область, Растр привязки, Размер листа

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

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