Доступно с лицензией Spatial Analyst.
Сводка
Заполняет локальные понижения на поверхности растра для устранения небольших дефектов данных.
Иллюстрация
Использование
Локальное понижение - это ячейка с неопределенным направлением стока; вокруг нее не существует ячеек с меньшей, чем у этой ячейки, высотой. Точка устья - это пограничная ячейка с наименьшей высотой для водосборной области локального понижения. Если бы локальные понижения были заполнены водой, в этих точках вода «утекала бы» с поверхности.
Ограничение z задает максимальное допустимое различие между глубиной понижения и точкой устья и определяет, какие понижения заполнятся, а какие нет. Ограничение по z не является значением максимальной глубины, до которой будет заполнено локальное понижение.
Например, представьте себе понижение с точкой устья, имеющей высоту 210 футов, и глубочайшей точкой понижения в 204 футов (разница в 6 футов). Если значение ограничения z равно 8, такое понижение будет заполнено. Однако в случае, если значение ограничения по z составляет 4, понижение не заполнится, пока его глубина не превысит данную разность и не станет, таким образом, корректным понижением.
Все локальные понижения, которые по глубине меньше, чем ограничение по z, ниже, чем самая низкая из прилегающих соседних ячеек, и будут заполнены до высоты своих точек устьев.
Инструмент Заполнение требователен к объему памяти, процессору и месту на диске. Он может требовать до четырех раз большего объема дискового пространства, чем входной растр.
Число локальных понижений, определяемых с использованием ограничения по z, будет задавать время, требуемое на обработку. Чем больше понижений, тем больше времени займет расчет.
Инструмент Локальное понижение можно использовать вместо инструмента Заполнение - для нахождения числа понижений и определения их глубин. Знание глубины локальных понижений может помочь в определении подходящего значения ограничения по z.
Инструмент Заполнение локальных понижений может быть также использован для удаления пиков. Пик - это ячейка, вокруг которой нет ячеек выше нее. Для удаления пиков входной растр поверхности должен быть инвертирован. Эту операцию можно выполнить с помощью инструмента Вычесть. Задайте наибольшее значение растра поверхности в качестве первых входных данных инструмента Вычесть и растр поверхности в качестве вторых входных данных. Выполните заполнение. Инвертируйте результаты с тем, чтобы получить поверхность, имеющую исходные значения растра поверхности с удаленными пиками. Ограничение по z может быть применено и к этому процессу. Если для ограничения по z не задано никакого значения, будут удалены все пики. Если значение определено, в тех случаях, когда разница в значении z между пиком и самой высокой соседней ячейкой больше, чем ограничение по z, этот пик удален не будет.
Этот инструмент поддерживает параллельную обработку. Если ваш компьютер имеет несколько процессоров или процессор с несколькими ядрами, то его производительность будет более высокой, особенно на больших наборах данных. Раздел справки Параллельная обработка и Spatial Analyst содержит более подробные сведения об этой возможности и способах ее настройки.
При использовании параллельной обработки будут записаны временные данные для управления обрабатываемыми фрагментами данных. Расположение папки временных файлов по умолчанию будет на вашем локальном диске C. Вы можете управлять расположением этой папки, настроив Переменную системной среды с именем TempFolders и указав путь к папке, которая будет использоваться (например, E:\RasterCache). Если вы обладаете правами доступа администратора на данном компьютере, можете использовать также ключ реестра (например, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]).
По умолчанию, этот инструмент будет использовать 50 процентов доступных ядер. Если размер входных данных меньше, чем 5000 на 5000 ячеек, может использоваться меньшее число ядер. Можно задавать число используемых инструментом ядер в среде Коэффициент параллельной обработки environment.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
Fill(in_surface_raster, {z_limit})| Parameter | Объяснение | Тип данных |
in_surface_raster | Входной растр непрерывной высотной поверхности. | Raster Layer |
z_limit (Дополнительный) | Максимальная разница в высотах между заполняемым локальным понижением и его точкой устья. Если различия в z-значениях между локальным понижением и его точкой устья больше, чем значение ограничения по высоте, это локальное понижение не будет заполнено. Значение ограничения z должно быть больше нуля. При не указании этого значения будут заполнены все понижения - независимо от их глубины. | Double |
Значение отраженного сигнала
| Name | Объяснение | Тип данных |
| out_surface_raster | Выходной набор растровых данных поверхности после заполнения локальных понижений. Если входной растр целочисленный, растр заполнения будет также целочисленным. Если входной растр с плавающей точкой, выходной растр также будет с плавающей точкой. | Raster |
Пример кода
В этом примере заполняются локальные понижения входного растра Grid поверхности рельефа.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFill = Fill("elevation")
outFill.save("C:/sapyexamples/output/outfill01")В этом примере заполняются локальные понижения входного растра Grid поверхности рельефа с применение ограничения по z.
# Name: Fill_Ex_02.py
# Description: Fills sinks in a surface 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
inSurfaceRaster = "elevation"
zLimit = 3.28
# Execute FlowDirection
outFill = Fill(inSurfaceRaster, zLimit)
# Save the output
outFill.save("C:/sapyexamples/output/outfill02")Environments
Информация о лицензиях
- Basic: Требуется Spatial Analyst
- Standard: Требуется Spatial Analyst
- Advanced: Требуется Spatial Analyst