Доступно с лицензией 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 ячеек, может использоваться меньшее число ядер. Можно задавать число используемых инструментом ядер в среде Коэффициент параллельной обработки.
См. раздел Среда анализа и 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