Доступно с лицензией Spatial Analyst.
Доступно с лицензией Image Analyst.
Краткая информация
Определяет взвешенную окрестность, которая создается с помощью файла описания со значениями, на которые умножаются ячейки, входящие в окрестность.
Иллюстрация
Обсуждение
Инструменты, которые используют объект взвешенной окрестности: Статистика по блокам и Фокальная статистика.
Лицензия:
Этот класс также доступен, если у вас есть лицензия модуля Image Analyst, но только для инструмента Фокальная статистика.
Взвешенная окрестность задается с помощью файла описания. Файл описания весов задает, какие положения ячейки будут включены в окрестность, а также веса, которые будут использования при умножении значений клеток на входной растр.
Для фокальных инструментов положение x,y обрабатываемой ячейки в пределах окрестности по отношению к верхнему левому углу окрестности, определяется следующими уравнениями:
x = (width + 1)/2 y = (height + 1)/2Если число входных ячеек четное, координаты x,y округляются методом отбрасывания дробной части.
Файл описания:
Файл описания представляет собой текстовый ASCII-файл, который определяет значения и форму взвешенной окрестности.
Первая строка задает ширину и высоту окрестности (количество ячеек в направлении x, за которым следует пробел и количество ячеек в направлении y).
Последующие строки содержат значения для каждого положения ячейки окрестности. Значения вводятся в той же конфигурации, в которой они появляются в представляемой ими окрестности. Положительные, отрицательные и десятичные значения являются корректными опциями в качестве весов. Пробел между значениями является обязательным.
Для местоположений в окрестности, которые не участвуют в вычислениях, используйте для соответствующего местоположения в керн-файле значение, равное 0.
Синтаксис
NbrWeight (inKernelFile)
| Параметр | Описание | Тип данных |
inKernelFile | Данный inKernelFile является текстовым файлом формата ASCII, определяющим форму окрестности и вес каждой из ячеек в данной окрестности. Значение 0 для положения ячейки указывает на то, что эта ячейка не является членом массива окрестности, а какое-либо число на месте соответствующей ячейки указывает, что значение ячейки следует включить в качестве члена массива окрестности. Ненулевое значение также выступает в качестве веса, являющегося множителем значения соответствующей ячейки. | File |
Свойства
| Свойство | Описание | Тип данных |
| inKernelFile (чтение и запись) | Данный файл inKernelFile является текстовым файлом формата ASCII, определяющим форму окрестности и вес каждой из ячеек в данной окрестности. Значение 0 для положения ячейки указывает на то, что эта ячейка не является членом массива окрестности, а какое-либо число на месте соответствующей ячейки указывает, что значение ячейки следует включить в качестве члена массива окрестности. Ненулевое значение также выступает в качестве веса, являющегося множителем значения соответствующей ячейки. | String |
Пример кода
Иллюстрирует создание класса NbrWeight и его использование в инструменте BlockStatistics в окне Python.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNbrWF = BlockStatistics("block", NbrWeight("weight.txt"))
outNbrWF.save("C:/sapyexamples/output/blstatsnbrwf2")Работа инструмента BlockStatistics с использованием класса NbrWeight.
# Name: NbrWeight_Ex_02.py
# Description: Uses the NbrWeight 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
inWeightFile = "C:/data/weight.txt"
myNbrWeight = NbrWeight(inWeightFile)
# Execute BlockStatistics
outBlStats = BlockStatistics(inRaster, myNbrWeight, "MINIMUM", "DATA")
# Save the output
outBlStats.save("C:/sapyexamples/output/blstat_wght3")