Доступно с лицензией Spatial Analyst.
Краткая информация
Вычисляет для каждой входной ячейки статистику значений в определенной вокруг нее окрестности.
Более подробно о том, как работает инструмент Фокальная статистика
Иллюстрация
Использование
Если тип значений входного растра – числа с плавающей точкой, возможно вычисление только среднего, максимального и минимального значений, а также диапазона, стандартного отклонения и суммы; статистика Большинство, Меньшинство, Медиана и Разнообразие не допускается. Если входной растр целочисленный, доступно использование всех типов статистики.
Если задана окрестность в виде круга, окрестность в форме кольца или клина, некоторые внешние ячейки диагонали могут не учитываться в вычислениях, т.к. центр ячейки должен быть заключён в окрестность.
Для типов окрестностей Нерегулярный и Вес требуется наличие керн-файла. Керн-файл должен иметь расширение .txt.
Более подробную информацию о создании и использовании керн-файлов см. в подразделах Нерегулярный и Вес в статье Как работает инструмент Фокальная статистика.
Окрестность может иметь значение Вес только для типов статистики Среднее, Среднеквадратическое отклонение или Сумма.
Входные ячейки NoData могут получать значение на выходе, если включена опция Игнорировать значение NoData при вычислениях, при условии, что по крайней мере одна ячейка в окрестности имеет корректное значение.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
FocalStatistics (in_raster, {neighborhood}, {statistics_type}, {ignore_nodata})
Параметр | Объяснение | Тип данных |
in_raster | Растр, для которого будут выполнены вычисления фокальной статистики. | Raster Layer |
neighborhood (Дополнительный) | Класс Neighborhood диктует форму области вокруг каждой ячейки, используемой для вычисления статистики. К доступным типам окрестностей относятся NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge, NbrIrregular, и NbrWeight. Ниже приведены формы окрестности:
Окрестность по умолчанию – это квадрат NbrRectangle со стороной три ячейки. | Neighborhood |
statistics_type (Дополнительный) | Тип вычисляемой статистики.
Типом статистики по умолчанию является MEAN. Если входной растр с плавающей точкой, доступна только статистика MEAN, MAXIMUM, MINIMUM, RANGE, STD и SUM. | String |
ignore_nodata (Дополнительный) | Устанавливает, игнорируются ли в вычислениях статистики значения NoData.
| Boolean |
Возвращаемое значение
Название | Объяснение | Тип данных |
out_raster | Выходной растр фокальной статистики. | Raster |
Пример кода
FocalStatistics Пример 1 (окно Python)
В этом примере вычисляется наименее часто возникающее значение в окрестности в форме кольца вокруг каждой ячейки входного растра.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFocalStat = FocalStatistics("elevation", NbrAnnulus(5, 10, "CELL"),
"MINORITY", "NODATA")
outFocalStat.save("C:/sapyexamples/output/focalstat01")
FocalStatistics, пример 2 (автономный скрипт)
В этом примере вычисляется наименее часто возникающее значение в окрестности 10 на 10 вокруг каждой ячейки входного растра.
# Name: FocalStatistics_Ex_02.py
# Description: Calculates a statistic on a raster over a specified
# neighborhood.
# 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
inRaster = "elevation"
neighborhood = NbrRectangle(10, 10, "CELL")
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute FocalStatistics
outFocalStatistics = FocalStatistics(inRaster, neighborhood, "MINORITY",
"")
# Save the output
outFocalStatistics.save("C:/sapyexamples/output/focalstatout")
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Требует Spatial Analyst
- ArcGIS Desktop Standard: Требует Spatial Analyst
- ArcGIS Desktop Advanced: Требует Spatial Analyst