Для каждой ячейки в выходных данных записывается принадлежность соответствующему региону, которому принадлежит эта ячейка. Каждому региону присваивается уникальный номер.
В общем, первому отсканированному региону присваивается значение один, второму Ї значение два и так далее, до тех пор, пока всем регионам не будут присвоены значения. Сканирование выполняется слева направо, сверху вниз. Значения, присвоенные выходным зонам, основаны на порядке, в котором они включаются в процесс сканирования.
Настройкой связности между регионами управляют два параметра. Параметр Число соседних ячеек определяет геометрию связности, либо как ортогональную (четырехполосную), либо как диагональную, а также ортогональную (восьмиполосную). Параметр Метод группировки в зоны определяет, какие значения ячейки рассматривать для оценки связности.
По умолчанию включена опция Добавить поле связи к выходным данным (ADD_LINK в Python). Это приведет к созданию поля с именем LINK в таблице атрибутов выходного растра, в котором будут храниться исходные значения зоны каждой ячейки входного растра.
Этот параметр применяется, только когда параметр Метод группировки в зоны (zone_connectivity в Python) задан как Внутри. Если он задан как Пересечение, то таблица атрибутов выходного растра будет содержать только типовые поля Value и Count.
Если доступно, поле LINK позволяет определять родство каждого нового создаваемого региона по отношению к исходным входным значениям зон, это может пригодиться для последующего анализа.
Например, таблица атрибутов для выходного растра на приведенном выше рисунке выглядит следующим образом:
При использовании параметра среды [Маска(../environment-settings/mask.yml) пространственная конфигурация и количество регионов в выходном растре могут быть изменены.
Местоположениям ячеек, которые содержат исключенное значение, на выходном растре будет присвоено нулевое значение, с тем, чтобы эти зоны отличались от существующих ячеек со значением NoData. Поскольку нумерация начинается с единицы, ячейки, исключаемые из группировки, рассматриваются в качестве фоновых ячеек. Эти фоновые ячейки могут быть переклассифицированы или могут обрабатываться как любое другое значение.
Входной растр, уникальные смежные регионы которого будут идентифицированы.
Должен быть целочисленным.
Raster Layer
Число соседних ячеек
(Дополнительный)
Определяет количество соседних ячеек, используемое для оценки смежности между ячейками, задающими регион.
Четверка–Смежность оценивается для четырех ближайших (ортогональных) соседей каждой входной ячейки. Только ячейки с таким же значением, у которых есть хотя бы одна общая сторона, будут представлять собой отдельный регион. Если две ячейки расположены относительно друг друга по диагонали, они не считаются смежными. Используется по умолчанию.
Восьмерка–Смежность оценивается для восьми ближайших (ортогональных и диагональных) соседей каждой входной ячейки. Ячейки с одинаковым значением, которые имеют либо общее ребро, либо общий угол, будут представлять собой отдельный регион.
String
Метод группировки в зоны
(Дополнительный)
Определяет, какие значения ячеек должны учитываться при тестировании на связанность.
Внутри–Смежность для региона оценивается для входных ячеек, которые являются частью одной и той же зоны (значения ячейки). Единственные ячейки, которые могут быть сгруппированы — это ячейки из одной и той же зоны, которые отвечают пространственным требованиям к связности, определенным параметром Число соседних ячеек (четыре или восемь). Используется по умолчанию.
Крест–Смежность для региона оценивается между ячейками любого значения, за исключением ячеек зоны, идентифицированных как исключаемые параметром Исключенное значение, и при условии соблюдения пространственных требований, задаваемых параметром Число соседних ячеек. Группировки регионов во входных данных, которые отделены от других группировок буферами из ячеек со значениями NoData, будут обрабатываться независимо друг от друга.
String
Добавить поле связи к выходному файлу
(Дополнительный)
Указывает, будет ли поле связи добавляться в таблицу выходных данных, когда параметр Метод группировки в зоны выбран как Внутри. Игнорируется, если значением параметра является Пересекает.
Отмечено–Поле LINK будет добавлено в таблицу выходного растра. В этом поле хранится значение зоны, к которой принадлежат ячейки каждого региона в выходных данных, в соответствии с правилом смежности, определенным в параметре Число соседних ячеек. Используется по умолчанию.
Не отмечено–Поле LINK не будет добавлено. Таблица атрибутов выходного растра будет содержать только поля Value и Count.
Boolean
Исключенное значение
(Дополнительный)
Значение, исключающее все ячейки этой зоны из оценки смежности. Если местоположение ячейки содержит значение, пространственная связность установлена не будет, независимо от того, как задано количество соседей.
Ячейки с исключенным значением будут обрабатываться аналогично ячейкам NoData и исключаются из рассмотрения в операции. Входным ячейкам, содержащим исключенное значение, на выходном растре будет присвоено нулевое значение. Исключенное значение аналогично понятию фонового значения.
По умолчанию для этого параметра не определено значение, что означает, что в операции будут учитываться все входные ячейки.
Входной растр, уникальные смежные регионы которого будут идентифицированы.
Должен быть целочисленным.
Raster Layer
number_neighbors
(Дополнительный)
Определяет количество соседних ячеек, используемое для оценки смежности между ячейками, задающими регион.
FOUR–Смежность оценивается для четырех ближайших (ортогональных) соседей каждой входной ячейки. Только ячейки с таким же значением, у которых есть хотя бы одна общая сторона, будут представлять собой отдельный регион. Если две ячейки расположены относительно друг друга по диагонали, они не считаются смежными. Используется по умолчанию.
EIGHT–Смежность оценивается для восьми ближайших (ортогональных и диагональных) соседей каждой входной ячейки. Ячейки с одинаковым значением, которые имеют либо общее ребро, либо общий угол, будут представлять собой отдельный регион.
String
zone_connectivity
(Дополнительный)
Определяет, какие значения ячеек должны учитываться при тестировании на связанность.
WITHIN–Смежность для региона оценивается для входных ячеек, которые являются частью одной и той же зоны (значения ячейки). Группируются только ячейки, которые находятся в одной зоне и отвечают пространственным требованиям к смежности, определенным параметром number_neighbors (четыре или восемь). Используется по умолчанию.
CROSS–Смежность для региона оценивается между ячейками любого значения, за исключением ячеек зоны, идентифицированных как исключаемые параметром excluded_value, и при условии соблюдения пространственных требований, задаваемых параметром .ребований, задаваемых параметром number_neighbors. Группировки регионов во входных данных, которые отделены от других группировок буферами из ячеек со значениями NoData, будут обрабатываться независимо друг от друга.
String
add_link
(Дополнительный)
Указывает, будет ли поле связи добавляться в таблицу выходных данных, когда параметр zone_connectivityвыбран как WITHIN. Этот параметр игнорируется, если значением параметра является CROSS.
ADD_LINK–Поле LINK будет добавлено в таблицу выходного растра. В этом поле хранится значение зоны, к которой принадлежат ячейки каждого региона в выходных данных, в соответствии с правилом смежности, определенным в параметре number_neighbors. Используется по умолчанию.
NO_LINK–Поле LINK не будет добавлено. Таблица атрибутов выходного растра будет содержать только поля Value и Count.
Boolean
excluded_value
(Дополнительный)
Значение, исключающее все ячейки этой зоны из оценки смежности. Если местоположение ячейки содержит значение, пространственная связность установлена не будет, независимо от того, как задано количество соседей.
Ячейки с исключенным значением будут обрабатываться аналогично ячейкам NoData и исключаются из рассмотрения в операции. Входным ячейкам, содержащим исключенное значение, на выходном растре будет присвоено нулевое значение. Исключенное значение аналогично понятию фонового значения.
По умолчанию для этого параметра не определено значение, что означает, что в операции будут учитываться все входные ячейки.
Long
Возвращаемое значение
Имя
Объяснение
Тип данных
out_raster
Выходной растр группировки.
Выходные данные всегда будут целочисленными.
Raster
Пример кода
RegionGroup пример 1 (окно Python)
В этом примере каждому региону входного растра присваивается уникальный номер с помощью связности в восьми направлениях.
В этом примере каждому региону входного растра присваивается уникальный номер с помощью связности в восьми направлениях с исключенным значением.
# Name: RegionGroup_Ex_02.py
# Description: Records, for each cell in the output, the
# identity of the connected region to which
# it belongs within the Analysis window. A
# unique number is assigned to each region.
# 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 = "land"
valToIgnore = 5
# Run RegionGroup
outRegionGrp = RegionGroup(inRaster, "EIGHT", "CROSS",
"NO_LINK", valToIgnore)
# Save the output
outRegionGrp.save("C:/sapyexamples/output/reggrpout")
