NbrCircle (arcpy.sa)

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

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

Рисунок

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

Пример NbrCircle окрестности для функции статистики по блокам (BlockStatistics)

Обсуждение

Следующие инструменты используют окрестность в форме круга: Статистика по блокам (Block Statistics), Фокальная статистика (Focal Statistics), Точечная статистика (Point Statistics) и Плотность точек (Point Density).

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

Синтаксис

NbrCircle ({radius}, {units})

Параметр	Объяснение	Тип данных
radius	Радиус окрестности круга. (Значение по умолчанию — 3)	Double
units	Задает единицы измерения окрестности. CELL —Измерение осуществляется в ячейках. MAP —Измерение осуществляется в координатах карты. (Значение по умолчанию — CELL)	String

Свойства

Свойство	Объяснение	Тип данных
radius (чтение и запись)	Радиус окрестности круга.	Double
units (чтение и запись)	Задает единицы измерения окрестности.	String

Пример кода

NbrCircle. Пример 1 (окно Python)

Иллюстрирует создание класса NbrCircle и его применение в инструменте Статистика по блокам (BlockStatistics) в окне Python.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNbrC = BlockStatistics("block", NbrCircle(2, "MAP"))
outNbrC.save("C:/sapyexamples/output/blstatsnbrc2")

NbrCircle. Пример 2 (автономный скрипт)

Работа инструмента Статистика по блокам (BlockStatistics) с классом NbrCircle.

# Name: NbrCircle_Ex_02.py
# Description: Uses the NbrCircle 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
radius = 2
myNbrCirc = NbrCircle(radius, "MAP")

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute BlockStatistics
outBlkStat =  BlockStatistics(inRaster, myNbrCirc, "MINIMUM", "DATA")

# Save the output 
outBlkStat.save("C:/sapyexamples/output/blstat_cir3")