NbrWedge (arcpy.sa)

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

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

Рисунок

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

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

Обсуждение

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

Клин определяется радиусом, начальным углом (startAngle), конечным углом (endAngle) и единицами. Клин строится в направлении против часовой стрелки от начального угла до конечного угла. Углы задаются в арифметических градусах (в направлении против часовой стрелки от положительного направления оси x). Можно использовать отрицательные значения углов.

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

Синтаксис

NbrWedge ({radius}, {startAngle}, {endAngle}, {units})

Параметр	Объяснение	Тип данных
radius	Радиус – это расстояние от угла клина до его внешней границы. Значения радиуса является целочисленными или числами с плавающей точкой. (Значение по умолчанию — 3)	Double
startAngle	Значение startAngle является целым числом или числом с плавающей точкой от 0 до 360. Начальный угол измеряется против часовой стрелки от положительного участка оси x (положение на циферблате часов 3:00) до ближайшего ребра клина. (Значение по умолчанию — 0)	Double
endAngle	Значение endAngle является целым числом или числом с плавающей точкой от 0 до 360. Конечный угол измеряется против часовой стрелки от положительной оси x (позиция 3:00 на часах) до внешнего ребра клина. (Значение по умолчанию — 90)	Double
units	Задает единицы измерения окрестности. CELL —Измерение осуществляется в ячейках. MAP —Измерение осуществляется в координатах карты. (Значение по умолчанию — CELL)	String

Свойства

Свойство	Объяснение	Тип данных
radius (чтение и запись)	Радиус – это расстояние от угла клина до его внешнего ограничения. Значения радиуса являются целочисленными или числами с плавающей точкой.	Double
startAngle (чтение и запись)	Значение startAngle является целым числом или числом с плавающей точкой от 0 до 360. Начальный угол измеряется против часовой стрелки от положительного участка оси x (положение на циферблате часов 3:00) до ближайшего ребра клина.	Double
endAngle (чтение и запись)	Значение endAngle варьируется от 0 до 360. Это может быть целочисленное значение или значение с плавающей точкой. Значение endAngle измеряется против часовой стрелки от положительной оси x (позиция 3:00 на часах) до внешнего ребра клина.	Double
units (чтение и запись)	Задает единицы измерения окрестности.	String

Пример кода

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

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNbrWedge = BlockStatistics("block", NbrWedge(5, 10.5, 40, "MAP"))
outNbrWedge.save("C:/sapyexamples/output/blstatsnbrw2")

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

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

# Name: NbrWedge_Ex_02.py
# Description: Uses the NbrWedge 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 = 5
startAngle = 5
endAngle = 10

myNbrWedge = NbrWedge(radius, startAngle, endAngle, "")

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

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

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