Доступно с лицензией 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\Desktop10.6\Raster]).
По умолчанию, этот инструмент использует 50 процентов доступных ядер. Если входные данные меньше, чем 5,000 на 5,000 ячеек, может использоваться меньше ядер. Можно задавать число используемых инструментом ядер в среде Коэффициент параллельной обработки.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
Fill (in_surface_raster, {z_limit})| Параметр | Объяснение | Тип данных |
in_surface_raster | Входной растр непрерывной высотной поверхности. | Raster Layer |
z_limit (Дополнительный) | Максимальная разница в высотах между заполняемым локальным понижением и его точкой устья. Если различия в z-значениях между локальным понижением и его точкой устья больше, чем значение ограничения по высоте, это локальное понижение не будет заполнено. Значение ограничения z должно быть больше нуля. При не указании этого значения будут заполнены все понижения - независимо от их глубины. | Double |
Возвращаемое значение
| Название | Объяснение | Тип данных |
| out_surface_raster | Выходной набор растровых данных поверхности после заполнения локальных понижений. Если входной растр целочисленный, растр заполнения будет также целочисленным. Если входной растр с плавающей точкой, выходной растр также будет с плавающей точкой. | Raster |
Пример кода
Fill, пример 1 (окно Python)
В этом примере заполняются локальные понижения входного растра поверхности рельефа 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")
Fill, пример 2 (автономный скрипт)
В этом примере заполняются локальные понижения входного растра поверхности рельефа 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
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute FlowDirection
outFill = Fill(inSurfaceRaster, zLimit)
# Save the output
outFill.save("C:/sapyexamples/output/outfill02")
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Требует Spatial Analyst
- ArcGIS Desktop Standard: Требует Spatial Analyst
- ArcGIS Desktop Advanced: Требует Spatial Analyst