Доступно с лицензией Spatial Analyst.
Краткая информация
Заполняет локальные понижения в растре поверхности для удаления всех небольших ошибок и неточностей, присущих данным.
Использование
Локальное понижение – это ячейка с неопределенным направлением стока; вокруг нее не существует ячеек с меньшей, чем у этой ячейки, высотой. Точка устья – это пограничная ячейка с наименьшей высотой для водосборной области локального понижения. Если бы локальные понижения были заполнены водой, в этих точках вода «утекала бы» с поверхности.
Ограничение z задает максимальное допустимое различие между глубиной понижения и точкой устья и определяет, какие понижения заполнятся, а какие нет. Ограничение по z не является значением максимальной глубины, до которой будет заполнено локальное понижение.
Например, представьте себе понижение с точкой устья, имеющей высоту 210 футов, и глубочайшей точкой понижения в 204 футов (разница в 6 футов). Если значение ограничения z равно 8, такое понижение будет заполнено. Однако в случае, если значение ограничения по z составляет 4, понижение не заполнится, пока его глубина не превысит данную разность и не станет, таким образом, корректным понижением.
Все локальные понижения, которые по глубине меньше, чем ограничение по z, ниже, чем самая низкая из прилегающих соседних ячеек, и будут заполнены до высоты своих точек устьев.
Инструмент Заполнение (Fill) требователен к объему памяти, процессору и месту на диске. Он может требовать до четырех раз большего объема дискового пространства, чем входной растр.
Число локальных понижений, определяемых с использованием ограничения по z, будет задавать время, требуемое на обработку. Чем больше понижений, тем больше времени займет расчет.
Инструмент Локальное понижение (Sink) можно использовать вместо инструмента Заполнение (Fill) – для нахождения числа понижений и определения их глубин. Знание глубины локальных понижений может помочь в определении подходящего значения ограничения по z.
Инструмент Заполнение локальных понижений может быть также использован для удаления пиков. Пик – это ячейка, вокруг которой нет ячеек выше нее. Для удаления пиков входной растр поверхности должен быть инвертирован. Эту операцию можно выполнить с помощью инструмента Минус (Minus). Задайте наибольшее значение растра поверхности в качестве первых входных данных инструмента Вычитание (Minus) и растр поверхности в качестве вторых входных данных. Выполните заполнение. Инвертируйте результаты с тем, чтобы получить поверхность, имеющую исходные значения растра поверхности с удаленными пиками. Ограничение по z может быть применено и к этому процессу. Если для ограничения по z не задано никакого значения, будут удалены все пики. Если значение определено, в тех случаях, когда разница в значении z между пиком и самой высокой соседней ячейкой больше, чем ограничение по z, этот пик удален не будет.
См. раздел Параметры среды анализа и 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")
Параметры среды
- Автоподтверждение (Auto Commit)
- Размер ячейки (Cell size)
- Сжатие (Compression)
- Текущая рабочая область (Current Workspace)
- Экстент (Extent)
- Географические преобразования (Geographic Transformations)
- Маска (Mask)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Выходная система координат (Output Coordinate System)
- Статистика растра (Raster Statistics)
- Временная рабочая область (Scratch Workspace)
- Растр привязки (Snap Raster)
- Размер листа (Tile Size)
Информация о лицензиях
- ArcGIS Desktop Basic: Требует Spatial Analyst
- ArcGIS Desktop Standard: Требует Spatial Analyst
- ArcGIS Desktop Advanced: Требует Spatial Analyst