ArcMap

NbrWeight

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

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

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

Иллюстрация

Окрестность NbrWeight для функции FocalStatistics
Пример NbrWeight окрестности для функции FocalStatistics.
Окрестность NbrWeight для функции BlockStatistics
Пример NbrWeight окрестности для функции BlockStatistics.

Описание

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

Взвешенная окрестность задается с помощью файла описания. Файл описания весов задаёт, какие положения ячейки будут включены в окрестность, а также веса, которые будут использования при умножении значений клеток на входной растр.

Для фокальных инструментов положение 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. Пример 1 (окно Python)

Демонстрирует создание класса 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")
NbrWeight, пример 2 (автономный скрипт)

Реализует инструмент 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)

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

# Execute BlockStatistics
outBlStats =  BlockStatistics(inRaster, myNbrWeight, "MINIMUM", "DATA")

# Save the output 
outBlStats.save("C:/sapyexamples/output/blstat_wght3")

Связанные разделы