Доступно с лицензией Spatial Analyst.
Сводка
Для каждой ячейки в выходных данных записывается принадлежность соответствующему региону, которому принадлежит эта ячейка. Каждому региону присваивается уникальный номер.
Более подробно о создании отдельных зон с помощью инструмента Группировка
Иллюстрация
Использование
Первому отсканированному региону присваивается значение один, второму – значение два и так далее, до тех пор, пока всем регионам не будут присвоены значения. Сканирование выполняется слева направо, сверху вниз. Значения, присвоенные выходным зонам, основаны на порядке, в котором они включаются в процесс сканирования.
Существует два параметра, которые управляют тем, как устанавливается связь между регионами. Параметр Число соседних ячеек определяет геометрию связности, либо как ортогональную (четырехполосную), либо как диагональную, а также ортогональную (восьмиполосную). Параметр Метод группировки в зоны определяет, какие значения ячейки рассматривать для оценки связности.
По умолчанию, включена опция Добавить поле связи к выходным данным (ADD_LINK в Python). Использование этой опции приведет к созданию поля LINK в таблице атрибутов выходного растра, в котором будут храниться исходные значения зоны каждой ячейки входного растра.
Этот параметр применяется, только когда параметр Метод группировки в зоны (zone_connectivity в Python) задан как Внутри. Если он задан как Пересекает,таблица атрибутов выходного растра будет содержать только обычные поля Value и Count fields.
Если поле LINK доступно, оно позволяет проследить происхождение каждого вновь созданного региона до исходных значений входных зон, которые будут использоваться для дополнительного анализа.
Например, таблица атрибутов для выходного растра на приведенном выше рисунке выглядит следующим образом:
Скорость обработки увеличивается, если поле LINK не создается. Если нет необходимости в исходном значении каждого региона, отключите эту опцию.
При использовании параметра среды Маска, пространственная конфигурация и количество регионов в выходном растре могут быть изменены.
Местоположениям ячеек, которые содержат исключенное значение, на выходном растре будет присвоено нулевое значение, с тем, чтобы эти зоны отличались от существующих ячеек со значением NoData. Поскольку нумерация начинается с единицы, ячейки, исключаемые из группировки, рассматриваются в качестве фоновых ячеек. Эти фоновые ячейки могут быть переклассифицированы или могут обрабатываться как любое другое значение.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
RegionGroup(in_raster, {number_neighbors}, {zone_connectivity}, {add_link}, {excluded_value})| Параметр | Объяснение | Тип данных |
in_raster | Входной растр, уникальные смежные регионы ячеек которого будут идентифицированы. Должен быть целочисленным. | Raster Layer |
number_neighbors (Дополнительный) | Указывает количество соседних ячеек, используемое для оценки смежности между ячейками, которые задают регион.
| String |
zone_connectivity (Дополнительный) | Определяет, какие значения ячеек должны учитываться при тестировании на связанность.
| String |
add_link (Дополнительный) | Указывает, будет ли поле связи добавляться в таблицу выходных данных, когда параметр zone_connectivity выбран как WITHIN. Этот параметр игнорируется, если значением параметра является CROSS.
| Boolean |
excluded_value (Дополнительный) | Значение, исключающее все ячейки этой зоны из оценки смежности. Если местоположение ячейки содержит это значение, то пространственная смежность не будет оцениваться, независимо от того, как указано число соседей. Ячейки с исключенным значением будут обрабатываться аналогично ячейкам NoData и исключаться из рассмотрения в ходе операции. Входные ячейки, содержащие исключенное значение, на выходном растре будет получат значение 0. Исключенное значение аналогично понятию значения фона. По умолчанию для этого параметра не определено значение, что означает, что в операции будут учитываться все входные ячейки. | Long |
Значение отраженного сигнала
| Имя | Объяснение | Тип данных |
| out_raster | Выходной растр группировки. Выходные данные всегда будут целочисленными. | Raster |
Пример кода
RegionGroup, пример 1 (окно Python)
В этом примере каждому региону входного растра присваивается уникальный номер с помощью связности в восьми направлениях.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRgnGrp = RegionGroup("land", "EIGHT", "", "", 5)
outRgnGrp.save("c:/sapyexamples/output/reggrp_ex5")
RegionGroup, пример 2 (автономный скрипт)
В этом примере каждому региону входного растра присваивается уникальный номер с помощью связности в восьми направлениях с исключенным значением.
# 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
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute RegionGroup
outRegionGrp = RegionGroup(inRaster, "EIGHT", "CROSS",
"NO_LINK", valToIgnore)
# Save the output
outRegionGrp.save("C:/sapyexamples/output/reggrpout")
Параметры среды
Информация о лицензиях
- Basic: Требуется Spatial Analyst
- Standard: Требуется Spatial Analyst
- Advanced: Требуется Spatial Analyst