Доступно с лицензией Spatial Analyst.
Краткая информация
Создает растр, определяющий локальные понижения или районы внутреннего дренажа.
Более подробно о том, как работает инструмент Локальное понижение
Использование
Локальное понижение – это ячейка или набор пространственно смежных ячеек, направлению стока из которых не может быть присвоено ни одного из восьми корректных значений направлений в растре направления стока. Такое происходит в том случае, если все соседние ячейки выше, чем обрабатываемая ячейка, либо когда две ячейки перетекают друг в друга, образуя петлю из двух ячеек.
Инструмент Локальное понижение поддерживает только входной растр направления стока D8. Направления стока D8 можно создать с помощью инструмента Направление стока, выбрав по умолчанию тип направления стока D8.
Выходные данные инструмента Локальное понижение - это целочисленный растр, в котором каждому локальному понижению присваивается уникальное значение. Локальные понижения нумеруются от единицы до числа, равного количеству локальных понижений.
Этот инструмент поддерживает параллельную обработку. Если ваш компьютер имеет несколько процессоров или процессор с несколькими ядрами, то для больших наборов данных будет достигаться лучшая производительность. В разделе Параллельная обработка в Spatial Analyst эта функция и ее настройки описаны более подробно.
При использовании параллельной обработки, для управления обрабатываемыми фрагментами записываются временные данные. Расположение папки временных файлов по умолчанию будет на вашем локальном диске C. Вы можете управлять расположением этой папки, настроив Переменную системной среды с именем TempFolders и указав путь к папке, которая будет использоваться (например, E:\RasterCache). Если у вас права администратора на вашей машине, вы можете также использовать ключ регистрации (например, [HKEY_CURRENT_USER\SOFTWARE\ESRI\Desktop10.6\Raster]).
По умолчанию, этот инструмент использует 50 процентов доступных ядер. Если входные данные меньше, чем 5,000 на 5,000 ячеек, может использоваться меньше ядер. Можно задавать число используемых инструментом ядер в среде Коэффициент параллельной обработки.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
Sink (in_flow_direction_raster)
Параметр | Объяснение | Тип данных |
in_flow_direction_raster | Входной растр, показывающий направление стока для каждой ячейки. Растр направления стока можно создать с помощью инструмента Направление стока, выбрав по умолчанию тип направления стока D8. | Raster Layer |
Возвращаемое значение
Название | Объяснение | Тип данных |
out_raster | Выходной растр, показывающий все локальные понижения (области внутреннего стока) на входной поверхности. Эти выходные данные будут целочисленными. | Raster |
Пример кода
Sink, пример 1 (окно Python)
В этом примере определяются локальные понижения на входном растре Grid направления потока.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outSink = Sink("flowdir")
outSink.save("C:/sapyexamples/output/outsink01")
Sink, пример 2 (автономный скрипт)
В этом примере определяются локальные понижения на входном растре Grid направления потока.
# Name: Sink_Ex_02.py
# Description: Creates a raster identifying all sinks or areas of internal drainage.
# 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
inFlowDirectionRaster = "flowdir"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute FlowDirection
outSink = Sink(inFlowDirectionRaster)
# Save the output
outSink.save("C:/sapyexamples/output/outsink02")
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Требует Spatial Analyst
- ArcGIS Desktop Standard: Требует Spatial Analyst
- ArcGIS Desktop Advanced: Требует Spatial Analyst