ArcMap

Фокальная статистика

Доступно с лицензией Spatial Analyst.

Краткая информация

Вычисляет для каждой входной ячейки статистику значений в определенной вокруг нее окрестности.

Более подробно о том, как работает инструмент Фокальная статистика

Иллюстрация

Иллюстрация работы инструмента Фокальная статистика
OutRas = FocalStatistics(InRas1, NbrRectangle(3,3,MAP), "SUM", "")

Использование

  • Если тип значений входного растра – числа с плавающей точкой, возможно вычисление только среднего, максимального и минимального значений, а также диапазона, стандартного отклонения и суммы; статистика Большинство, Меньшинство, Медиана и Разнообразие не допускается. Если входной растр целочисленный, доступно использование всех типов статистики.

  • Если задана окрестность в виде круга, окрестность в форме кольца или клина, некоторые внешние ячейки диагонали могут не учитываться в вычислениях, т.к. центр ячейки должен быть заключён в окрестность.

  • Для типов окрестностей Нерегулярный и Вес требуется наличие керн-файла. Керн-файл должен иметь расширение .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.

Ниже приведены формы окрестности:

  • NbrAnnulus({innerRadius}, {outerRadius}, {units})
  • NbrCircle({radius}, {units}
  • NbrRectangle({width}, {height}, {units})
  • NbrWedge({radius}, {startAngle}, {endAngle}, {units})
  • NbrIrregular(inKernelFile)
  • NbrWeight(inKernelFile)

Окрестность по умолчанию – это квадрат NbrRectangle со стороной три ячейки.

Neighborhood
statistics_type
(Дополнительный)

Тип вычисляемой статистики.

  • MEAN — Вычисляет среднее значений ячеек окрестности.
  • MAJORITY — Вычисляет значение большинства (значения, которое встречается чаще других) для ячеек в окрестности.
  • MAXIMUM — Вычисляет максимальное (наибольшее) из значений ячеек в окрестности.
  • MEDIAN — Вычисляет значение медианы для ячеек в окрестности.
  • MINIMUM — Вычисляет минимальное (наименьшее) из значений ячеек в окрестности.
  • MINORITY — Вычисляет значение меньшинства (значения, встречающегося реже всего) для ячеек в окрестности.
  • RANGE — Вычисляет диапазон (разницу между наибольшим и наименьшим значением) значений ячеек в окрестности.
  • STD — Вычисляет стандартное (среднеквадратическое) отклонение значений ячеек в окрестности.
  • SUM — Вычисляет сумму значений ячеек в окрестности.
  • VARIETY — Вычисляет разнообразие (количество уникальных значений) значений ячеек в окрестности.

Типом статистики по умолчанию является MEAN.

Если входной растр с плавающей точкой, доступна только статистика MEAN, MAXIMUM, MINIMUM, RANGE, STD и SUM.

String
ignore_nodata
(Дополнительный)

Устанавливает, игнорируются ли в вычислениях статистики значения NoData.

  • DATA — Определяет, что если в окрестности есть значение NoData, значение NoData будет проигнорировано. При определении статистики значений будут использованы только ячейки, имеющие определенное значение. Используется по умолчанию.
  • NODATA —Определяет, что если какая-либо ячейка в окрестности имеет значение NoData, выходным значением обрабатываемой ячейки будет значение NoData. В этом случае, когда используется ключевое слово 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

Связанные разделы