Группировка

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

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

Для каждой ячейки в выходных данных записывается принадлежность соответствующему региону, которому принадлежит эта ячейка. Каждому региону присваивается уникальный номер.

Более подробно о создании отдельных зон с помощью инструмента Группировка (Region Group)

Иллюстрация

OutRas = RegionGroup(InRas1)

Использование

• Первому отсканированному региону присваивается значение один, второму Ї значение два и так далее, до тех пор, пока всем регионам не будут присвоены значения. Сканирование выполняется слева направо, сверху вниз. Значения, присвоенные выходным зонам, основаны на порядке, в котором они включаются в процесс сканирования.

• По умолчанию, включена опция Добавить поле связи к выходным данным (ADD_LINK в Python). Использование этой опции приведет к созданию поля с именем LINK в таблице атрибутов выходного растра, в котором будут храниться исходные значения каждой ячейки входного растра.

• Поле LINK позволяет вам отслеживать происхождение каждого из вновь созданных регионов при выполнении запросов или анализа.

  Например, таблица атрибутов для выходного растра на приведенном выше рисунке выглядит следующим образом:

  

  Пример поля LINK в таблице атрибутов

• Отказ от создания поля LINK значительно ускорит обработку. Если нет необходимости в исходном значении каждого региона, отключите эту опцию.

• Если в параметрах среды задана маска, ячейкам, которые попадают под маску, в выходном растре будет присвоено значение NoData. При использовании маски, пространственная конфигурация и количество регионов в выходном растре может быть изменено. Если регион был непрерывным, и наложение маски нарушает непрерывность, регион будет разделен на два региона с двумя различными значениями или будет выполнена группировка идентификаторов на выходном растре.

  Маска может не только создавать дополнительные регионы путем деления региона на два или несколько отдельных регионов, она может также сокращать количество регионов на выходных данных. Если маска полностью покрывает или устраняет потенциальный регион из смежных ячеек, эти ячейки не будут рассматриваться как новая зона на выходных данных; им будут присвоены значения NoData.

• Инструмент Группировка (Region Group) особенно полезен, когда анализ выполняется для регионов, а не для зон. Поскольку сохраняется входное значение зоны, исходный зональный класс может также быть использован в анализе.

• Местоположениям ячеек, которые содержат исключенное значение, на выходном растре будет присвоено нулевое значение, с тем, чтобы эти зоны отличались от существующих ячеек со значением NoData. Поскольку инструмент Группировка (Region Group) выполняет нумерацию с единицы, ячейки, исключаемые из группировки, рассматриваются в качестве фоновых ячеек. Эти фоновые ячейки могут быть переклассифицированы или могут обрабатываться как любое другое значение. Местоположения, содержащие исключенные значения, могут быть легко преобразованы в значение NoData с помощью инструмента Условие (Con).

• См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Синтаксис

RegionGroup (in_raster, {number_neighbors}, {zone_connectivity}, {add_link}, {excluded_value})

Параметр	Объяснение	Тип данных
in_raster	Входной растр, уникальные смежные регионы которого будут идентифицированы. Должен быть целочисленным.	Raster Layer
number_neighbors (Дополнительный)	Количество соседних ячеек, используемое для оценки смежности между ячейками. FOUR — Определяет смежность ячеек с одинаковым значением только в том случае, если ячейки расположены непосредственно справа или слева или сверху или снизу каждой ячейки — четыре ближайших соседних ячейки. Если две ячейки расположены относительно друг друга по диагонали, они не считаются смежными. EIGHT — Определяет смежность ячеек с одинаковым значением в том случае, если они расположены в пределах непосредственной окрестности из восьми ячеек (восьми ближайших соседей) вокруг каждой ячейки. В эту окрестность включаются ячейки, расположенные справа или слева, сверху или по диагонали относительно друг друга.	String
zone_connectivity (Дополнительный)	Определяет, какие значения ячеек должны учитываться при тестировании на связанность. WITHIN — Проверяет связность между входными значениями, которые являются одинаковыми в пределах одной зоны.Единственные ячейки, которые могут быть сгруппированы — это ячейки из одной и той же зоны (значения), которые отвечают пространственным требованиям к связности, определенным ключевыми словами FOUR и EIGHT. CROSS — Тестирует связность через пространственные требования, заданные ключевыми словами FOUR и EIGHT, между ячейками с любыми значениями, кроме исключенного значения, определяемого аргументом, если таковое задано.При использовании CROSS в качестве входного должно использоваться значение аргумента Исключенное значение.	String
add_link (Дополнительный)	Устанавливает, будет ли добавлено в таблицу атрибутов выходного растра поле связи. ADD_LINK — Поле ADD_LINK будет добавлено в таблицу выходного растра. В этом поле хранятся исходные значения для каждой вновь созданной зоны, для несвязанных регионов, полученные с входного грида до выполнения перегруппировки. Это значение используется по умолчанию. NO_LINK — Таблица атрибутов выходного растра будет содержать только поля Value и Count.	Boolean
excluded_value (Дополнительный)	Задает значение, при котором не будет установлено пространственной смежности независимо от того, как задано количество соседей (FOUR or EIGHT). Ячейки с исключенным значением будут обрабатываться как ячейки с значением NoData и будут исключены из вычислений. Ячейкам, содержащим исключенное значение, на выходном растре будет присвоено нулевое значение. Исключенное значение совпадает с концепцией значения фона или определением маски в параметрах среды для одного запуска инструмента. Для этого параметра должно быть задано значение, если указано ключевое слово CROSS.	Long

Возвращаемое значение

Название	Объяснение	Тип данных
out_raster	Выходной растр группировки. Выходные данные всегда будут целочисленными.	Raster

Пример кода

Группировка. Пример 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")

Параметры среды

• Автоподтверждение (Auto Commit)
• Размер ячейки (Cell size)
• Сжатие (Compression)
• Текущая рабочая область (Current Workspace)
• Экстент (Extent)
• Географические преобразования (Geographic Transformations)
• Маска (Mask)
• Выходное ключевое слово CONFIG (Output CONFIG Keyword)
• Выходная система координат (Output Coordinate System)
• Временная рабочая область (Scratch Workspace)
• Растр привязки (Snap Raster)
• Размер листа (Tile Size)

Информация о лицензиях

• ArcGIS Desktop Basic: Требует Spatial Analyst
• ArcGIS Desktop Standard: Требует Spatial Analyst
• ArcGIS Desktop Advanced: Требует Spatial Analyst