Доступно с лицензией Spatial Analyst.
Краткая информация
Определяет окрестность в форме кольца, которая создаётся указанием радиусов внутренней и внешней окружностей в единицах карты или в количестве ячеек.
Рисунок
Обсуждение
Следующие инструменты используют окрестность в форме кольца: Статистика по блокам (Block Statistics), Фокальная статистика (Focal Statistics), Точечная статистика (Point Statistics) и Плотность точек (Point Density).
Форма плоского кольца состоит из двух окружностей, одно внутри другого, формирующих форму бублика. В обрабатываемую окрестность будут включены ячейки, центры которых попадают между кругами большего и меньшего радиуса; следовательно, область между ними составляет кольцевую окрестность.
Если используется кольцевой объект и не указаны внутренний радиус innerRadius или внешний радиус outerRadius, то используются их значения по умолчанию.
Внутренний радиус innerRadius должен быть меньше или равен внешнему радиусу outerRadius окружностей.
Радиус определяется в ячейках или единицах карты и измеряется перпендикулярно оси x или оси y. Если радиус указан в единицах карты, то они конвертируются в единицы ячеек. Итоговый радиус в единицах ячеек задаёт область, которая наиболее точно представляет область, определенную ранее в единицах карты. Все ячейки, центры которых попадают между окружностями, будут включены в обрабатываемую окрестность.
Синтаксис
NbrAnnulus ({innerRadius}, {outerRadius}, {units})| Параметр | Объяснение | Тип данных |
innerRadius | Внутренний радиус кольца окрестности. (Значение по умолчанию — 1) | Double |
outerRadius | Внешний радиус окрестности кольца. (Значение по умолчанию — 3) | Double |
units | Задает единицы измерения окрестности.
(Значение по умолчанию — CELL) | String |
Свойства
| Свойство | Объяснение | Тип данных |
| innerRadius (чтение и запись) | Внутренний радиус кольца окрестности. | Double |
| outerRadius (чтение и запись) | Внешний радиус окрестности кольца. | Double |
| units (чтение и запись) | Задает единицы измерения окрестности. | String |
Пример кода
NbrAnnulus. Пример 1 (окно Python)
Иллюстрирует создание класса NbrAnnulus и его применение в инструменте Статистика по блокам (BlockStatistics) в окне Python.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNbrA = BlockStatistics("block", NbrAnnulus(1, 2, "CELL"))
outNbrA.save("C:/sapyexamples/output/blstatnbra2")
NbrAnnulus, пример 2 (автономный скрипт)
Работа инструмента Статистика по блокам (BlockStatistics) с классом NbrAnnulus.
# Name: NbrAnnulus_Ex_02.py
# Description: Uses the NbrAnnulus object to execute BlockStatistics tool.
# 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 = "block"
# Create the Neighborhood Object
innerRadius = 1
outerRadius = 3
myNbrAnnulus = NbrAnnulus(innerRadius, outerRadius, "MAP")
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute BlockStatistics
outBlkStats = BlockStatistics(inRaster, myNbrAnnulus, "MINIMUM", "DATA")
# Save the output
outBlkStats.save("C:/sapyexamples/output/blstat_Ann3")