NbrIrregular

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

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

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

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

Обсуждение

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

Лицензия:

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

То, какие ячейки будут включены в окрестность, определяет файл Кернела.

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

\(x \space = \space (ширина \space + \space 1)/2 \space y \space = \space (высота \space + \space 1)/2\)

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

Файл описания:

Файл Кернела представляет собой текстовый ASCII-файл, который определяет значения и форму окрестности неправильной формы.
Первая строка задает ширину и высоту окрестности (количество ячеек в направлении x, за которым следует пробел и количество ячеек в направлении y).
Последующие строки содержат значения для каждого положения ячейки окрестности. Значения вводятся в той же конфигурации, в которой они появляются в представляемой ими окрестности. Пробел между значениями является обязательным.
Значения в файле Кернела должны быть либо 0, либо 1. При этом любое значение, отличное от нуля, будет интерпретироваться как 1.
Нулевое значение (не пробел) для положения ячейки указывает на то, что ячейка не является частью окрестности, и что она не будет включена в обработку. Значение, равное 1, указывает на то, что соответствующая ему ячейка (и ее значение) является частью окрестности.

Синтаксис

NbrIrregular(inKernelFile)

Имя	Объяснение	Тип данных
inKernelFile	The irregular `inKernelFile` is an ASCII text file that defines the shape of an irregular neighborhood. A value of 0 for a cell position indicates that the cell is not a member of the neighborhood, and a nonzero number at a corresponding cell's position indicates that the cell value be included as a member of the neighborhood.	File

Свойства

Имя	Объяснение	Тип данных
inKernelFile (Чтение / Запись)	`inKernelFile` для окрестности неправильной формы представляет собой текстовой ASCII-файл формата, который определяет форму окрестности неправильной формы. Значение 0 для положения ячейки указывает на то, что ячейка не является участником окрестности, а ненулевое число в соответствующем положении ячейки указывает, что значение ячейки должно быть включено в качестве участника окрестности.	String

Пример кода

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

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNbrKF = BlockStatistics("block", NbrIrregular("irreg.txt"))
outNbrKF.save("C:/sapyexamples/output/blstatsnbri2")

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

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

# Name: NbrIrregular_Ex_02.py
# Description: Uses the NbrIrregular object to run 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
inKernelFile = "C:/data/irreg.txt"
myNbrIrreg = NbrIrregular(inKernelFile)

# Run BlockStatistics
outBlkStat =  BlockStatistics(inRaster, myNbrIrreg, "MINIMUM", "DATA")

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