NbrRectangle

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

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

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

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

Иллюстрация

Примеры окрестностей NbrRectangle для функции FocalStatistics.

Пример окрестности NbrRectangle для функции BlockStatistics (ширина 6 ячеек, высота 4 ячейки).

Обсуждение

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

Лицензия:

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

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

При использовании прямоугольника в фокальном инструменте, положение x,y для обрабатываемой ячейки в пределах окрестности, по отношению к верхнему левому углу окрестности, определяется следующими уравнениями:

 x = (width of the neighborhood + 1)/2 y = (height of the neighborhood + 1)/2

Если число входных ячеек четное, координаты x,y округляются в меньшую сторону.

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

Синтаксис

NbrRectangle ({width}, {height}, {units})

Параметр	Описание	Тип данных
width	Ширина прямоугольной окрестности. Если задана только ширина width, будет получена квадратная окрестность. (Значение по умолчанию — 3)	Double
height	Высота прямоугольной окрестности. Если задана только высота height, будет получена квадратная окрестность. (Значение по умолчанию — 3)	Double
units	Задает единицы измерения окрестности. CELL—Измерение осуществляется в ячейках. MAP—Измерение осуществляется в координатах карты. (Значение по умолчанию — CELL)	String

Свойства

Свойство	Описание	Тип данных
width (чтение и запись)	Ширина прямоугольной окрестности. Если задана только ширина width, значение высоты height по умолчанию будет равно значению ширины width, в результате окрестность будет иметь квадратную форму.	Double
height (чтение и запись)	Высота прямоугольной окрестности. Если задана только высота height, значение ширины width по умолчанию будет равно значению высоты height, в результате окрестность будет иметь квадратную форму.	Double
units (чтение и запись)	Задает единицы измерения окрестности.	String

Пример кода

NbrRectangle, пример 1 (окно Python)

Иллюстрирует создание класса NbrRectangle и его использование в инструменте BlockStatistics в окне Python.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNbrRec = BlockStatistics("block", NbrRectangle(4, 5, "MAP"))
outNbrRec.save("C:/sapyexamples/output/blstatsnbrr2")

NbrRectangle, пример 2 (автономный скрипт)

Работа инструмента BlockStatistics с использованием класса NbrRectangle.

# Name: NbrRectangle_Ex_02.py
# Description: Uses the NbrRectangle 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
width = 5
height = 6
myNbrRec = NbrRectangle(width, height, "MAP")

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

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