ArcMap

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

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

Сводка

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

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

Иллюстрация

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

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

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

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

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

    Более подробную информацию о создании и использовании керн-файлов см. в подразделах Нерегулярный и Вес в статье Как работает инструмент Фокальная статистика.

  • Тип Окрестность может быть задан для Веса только в типах статистики Среднее, Средне-квадратическое отклонение и Суммарная статистика.

  • Входные ячейки NoData могут получать значение на выходе, если включена параметр Игнорировать значение NoData при вычислениях, при условии, что по крайней мере одна ячейка в окрестности имеет корректное значение.

  • См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Синтаксис

FocalStatistics(in_raster, {neighborhood}, {statistics_type}, {ignore_nodata}, {percentile_value})
ПараметрОбъяснениеТип данных
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 со стороной 3 ячейки.

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

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

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

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

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

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

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

  • DATA —Если в окрестности есть значение NoData, значение NoData будет проигнорировано. При определении статистики значений будут использованы только ячейки, имеющие определенное значение. Это означает, что если значение обрабатываемой ячейки равно NoData, обрабатываемая ячейка может получить значение в выходном растре, если этот параметр выбран. Это работает при условии, что хотя бы одна ячейка в окрестности имеет допустимое значение. Используется по умолчанию.
  • NODATA —Если какая-либо ячейка в окрестности имеет значение NoData, выходным значением обрабатываемой ячейки будет значение NoData. В этом случае, когда используется ключевое слово NoData, наличие значения NoData указывает на то, что для вычисления статистики значений в пределах окрестности информации недостаточно.
Boolean
percentile_value
(Дополнительный)

Вычисляемый процентиль. Значение по умолчанию – 90, для 90-го процентиля.

Значения могут варьироваться от 0 до 100. 0-й процентиль по существу эквивалентен Минимума в статистике, а 100-й процентиль эквивалентен Максимуму. Значение 50 даст по существу тот же результат, что и Медиана в статистике.

Эта опция доступна, только если для параметра statistics_type задано значение percentile.

Double

Значение отраженного сигнала

ИмяОбъяснениеТип данных
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")

Параметры среды

Информация о лицензиях

  • Basic: Требуется Spatial Analyst
  • Standard: Требуется Spatial Analyst
  • Advanced: Требуется Spatial Analyst

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