NbrRectangle (arcpy.sa)

Резюме

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

Рисунок

Функция статистики FocalStatistics для окрестности NbrRectangle.

Функция статистики BlockStatistics для окрестности NbrRectangle.

Обсуждение

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

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

При использовании в качестве фокального средства прямоугольника положение 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

Пример кода

Пример 1 NbrRectangle (окно 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")

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

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

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