Группировка (Region Group) (Spatial Analyst)
Резюме
Для каждой ячейки в выходных данных записывается принадлежность соответствующему региону, которому принадлежит эта ячейка. Каждому региону присваивается уникальный номер.
Более подробно о создании отдельных зон с помощью инструмента Группировка (Region Group)
Рисунок
 |
OutRas = RegionGroup(InRas1) |
Использование
-
Первому отсканированному региону присваивается значение один, второму Ї значение два и так далее, до тех пор, пока всем регионам не будут присвоены значения. Сканирование выполняется слева направо, сверху вниз. Значения, присвоенные выходным зонам, основаны на порядке, в котором они включаются в процесс сканирования.
-
По умолчанию, опция Добавить связь (Add Link) определена как истина (True). Использование этой опции приведет к созданию поля с именем LINK в таблице атрибутов выходного растра, в котором будут храниться исходные значения каждой ячейки входного растра.
-
Поле LINK позволяет вам отслеживать происхождение каждого из вновь созданных регионов при выполнении запросов или анализа.
Например, таблица атрибутов для выходного растра на рисунке выше, выглядит следующим образом:
Пример поля LINK в таблице атрибутов -
Определение опции Добавить связь (Add Link) как ложь (False) значительно ускорит процесс. Это особенно полезно в тех случаях, когда нет необходимости в исходном значении каждого региона.
-
Если в параметрах среды задана маска, ячейкам, которые попадают под маску, в выходном растре будет присвоено значение NoData. При использовании маски, пространственная конфигурация и количество регионов в выходном растре может быть изменено. Если регион был непрерывным, и наложение маски нарушает непрерывность, регион будет разделен на два региона с двумя различными значениями или будет выполнена группировка идентификаторов на выходном растре.
Маска может не только создавать дополнительные регионы путем деления региона на два или несколько отдельных регионов, она может также сокращать количество регионов на выходных данных. Если маска полностью покрывает или устраняет потенциальный регион из смежных ячеек, эти ячейки не будут рассматриваться как новая зона на выходных данных; им будут присвоены значения NoData.
-
Инструмент Группировка (Region Group) особенно полезен, когда анализ выполняется для регионов, а не для зон. Поскольку сохраняется входное значение зоны, исходный зональный класс может также быть использован в анализе.
-
Местоположениям ячеек, которые содержат исключенное значение, на выходном растре будет присвоено нулевое значение, с тем, чтобы эти зоны отличались от существующих ячеек со значением NoData. Поскольку инструмент Группировка (Region Group) выполняет нумерацию с единицы, ячейки, исключаемые из группировки, рассматриваются в качестве фоновых ячеек. Эти фоновые ячейки могут быть переклассифицированы или могут обрабатываться как любое другое значение. Местоположения, содержащие исключенные значения, могут быть легко преобразованы в значение NoData с помощью инструмента Условие (Con).
Синтаксис
| Параметр | Объяснение | Тип данных |
in_raster |
Входной растр, уникальные смежные регионы которого будут идентифицированы. Должен быть целочисленным. | Raster Layer |
number_neighbors (дополнительно) |
Количество соседних ячеек, используемое для оценки смежности между ячейками.
| String |
zone_connectivity (дополнительно) |
Определяет, какие значения ячеек должны учитываться при тестировании на связанность.
| String |
add_link (дополнительно) |
Устанавливает, будет ли добавлено в таблицу атрибутов выходного растра поле связи.
| Boolean |
excluded_value (дополнительно) |
Задает значение, при котором не будет установлено пространственной смежности независимо от того, как задано количество соседей (FOUR или EIGHT). Ячейки с исключенным значением будут обрабатываться как ячейки с значением NoData и будут исключены из вычислений. Ячейкам, содержащим исключенное значение, на выходном растре будет присвоено нулевое значение. Исключенное значение совпадает с концепцией значения фона или определением маски в параметрах среды для одного запуска инструмента. Для этого параметра должно быть задано значение, если указано ключевое слово CROSS. | Long |
Возвращено значение
| Имя | Объяснение | Тип данных |
| out_raster |
Выходной растр группировки. Выходной растр всегда будет целочисленным. | Raster |
Пример кода
В этом примере каждому региону входного растра присваивается уникальный номер с помощью связности в восьми направлениях.
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")
В этом примере каждому региону входного растра присваивается уникальный номер с помощью связности в восьми направлениях с исключенным значением.
# 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")