NbrAnnulus

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

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

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

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

Иллюстрация

Окрестности NbrAnnulus для функции FocalStatistics
Пример окрестности NbrRectangle для функции FocalStatistics (внутренний радиус 1 ячейка, внешний радиус 3 ячейки).
Окрестности NbrAnnulus для функции BlockStatistics
Пример окрестности NbrRectangle для функции BlockStatistics (внутренний радиус 1 ячейка, внешний радиус 3 ячейки).

Обсуждение

Следующие инструменты используют окрестность в форме кольца: Статистика по блокам, Фокальная статистика, Точечная статистика и Плотность точек.

Лицензия:

Этот класс также доступен, если у вас есть лицензия модуля Image Analyst, но только для инструмента Фокальная статистика.

Форма плоского кольца состоит из двух окружностей, одно внутри другого, формирующих форму бублика. В обрабатываемую окрестность будут включены ячейки, центры которых попадают между кругами большего и меньшего радиуса; следовательно, область между ними составляет кольцевую окрестность.

Если используется кольцевой объект, а innerRadius или outerRadius не указаны, используются их значения по умолчанию.

Значение innerRadius должно быть меньше или равно outerRadius.

Радиус определяется в ячейках или единицах карты и измеряется перпендикулярно оси x или оси y. Если радиус указан в единицах карты, то они конвертируются в единицы ячеек. Итоговый радиус в единицах ячеек задаёт область, которая наиболее точно представляет область, определенную ранее в единицах карты. Все ячейки, центры которых попадают между окружностями, будут включены в обрабатываемую окрестность.

Синтаксис

NbrAnnulus ({innerRadius}, {outerRadius}, {units})
ПараметрОписаниеТип данных
innerRadius

The inner radius of an annulus neighborhood.

(Значение по умолчанию — 1)

Double
outerRadius

The outer radius of an annulus neighborhood.

(Значение по умолчанию — 3)

Double
units

Defines the units of the neighborhood.

  • CELLThe unit of measurement is in cells.
  • MAPThe units are in map coordinates.

(Значение по умолчанию — CELL)

String

Свойства

СвойствоОписаниеТип данных
innerRadius
(чтение и запись)

Внутренний радиус кольцевой окрестности.

Double
outerRadius
(чтение и запись)

Внешний радиус кольцевой окрестности.

Double
units
(чтение и запись)

Задает единицы измерения окрестности.

  • CELLЕдиницы измерения - число ячеек.
  • MAPЕдиницы измерения - координаты карты.
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")

# Execute BlockStatistics
outBlkStats =  BlockStatistics(inRaster, myNbrAnnulus, "MINIMUM", "DATA")

# Save the output 
outBlkStats.save("C:/sapyexamples/output/blstat_Ann3")

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