Водосборная область (Spatial Analyst)

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

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

Определяет область распространения для набора ячеек растра.

Более подробно о том, как работает инструмент Водосборная область

Иллюстрация

Иллюстрация инструмента Водосборная область

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

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

  • Инструмент Водосборная область поддерживает только входной растр направления стока с типом D8. Он может быть создан с помощью инструмента Направление стока, который запускается с типом стока по умолчанию D8 (в Python, с опцией D8).

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

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

  • Этот инструмент поддерживает параллельную обработку. Если ваш компьютер имеет несколько процессоров или процессор с несколькими ядрами, то его производительность будет более высокой, особенно на больших наборах данных. Раздел справки Параллельная обработка в Spatial Analyst содержит более подробные сведения об этой возможности и способах ее настройки.

    При использовании параллельной обработки будут записаны временные данные для управления обрабатываемыми фрагментами данных. Расположение папки временных файлов по умолчанию будет на вашем локальном диске C:. Вы можете управлять расположением этой папки, настроив Переменную системной среды с именем TempFolders и указав путь к папке, которая будет использоваться (например, E:\RasterCache). Если у вас есть права администратора на вашей машине, вы можете также использовать ключ регистрации (например, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]).

    По умолчанию, этот инструмент будет использовать 50 процентов доступных ядер. Если размер входных данных меньше, чем 5000 на 5000 ячеек, может использоваться меньшее число ядер. Можно задавать число используемых инструментом ядер в среде Коэффициент параллельной обработки.

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

Параметры

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

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

Растр направления стока можно создать с помощью инструмента Направление стока, выбрав тип направления стока D8 по умолчанию.

Raster Layer
Входные растровые или векторные данные точек устьев

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

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

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

Raster Layer; Feature Layer
Поле точек устьев
(Дополнительный)

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

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

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

Field

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

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

Выходной растр, показывающий область водосборов.

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

Raster

Watershed(in_flow_direction_raster, in_pour_point_data, {pour_point_field})
ИмяОписаниеТип данных
in_flow_direction_raster

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

Растр направления стока можно создать с помощью инструмента Направление стока, выбрав по умолчанию тип направления стока D8.

Raster Layer
in_pour_point_data

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

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

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

Raster Layer; Feature Layer
pour_point_field
(Дополнительный)

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

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

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

Field

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

ИмяОписаниеТип данных
out_raster

Выходной растр, показывающий область водосборов.

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

Raster

Пример кода

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

В этом примере определяется водосборная область для выбранного местоположения точки устья на растре 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")
Watershed, пример 2 (автономный скрипт)

В этом примере определяется водосборная область для выбранного местоположения точки устья на растре направления стока 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"

# Execute Watershed
outWatershed = Watershed(inFlowDirection, inPourPointData, inPourPointField)

# Save the output 
outWatershed.save("C:/sapyexamples/output/outwtrshd02.tif")

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

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

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