NbrAnnulus (arcpy.sa)

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

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

Рисунок

NbrAnnulus окрестность для фокальной статистики (FocalStatistics)
Пример NbrAnnulus окрестности для функции фокальной статистики (FocalStatistics)
NbrAnnulus окрестность для фокальной статистики (FocalStatistics)
Пример NbrAnnulus окрестности для функции статистики по блокам (BlockStatitistcs)

Обсуждение

Следующие инструменты используют окрестность в форме кольца: Статистика по блокам (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Измерение осуществляется в ячейках.
  • MAPИзмерение осуществляется в координатах карты.

(Значение по умолчанию — 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")

Связанные темы

5/10/2014