Группировка (Spatial Analyst)

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

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

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

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

Иллюстрация

Иллюстрация инструмента Группировка
OutRas = RegionGroup(InRas1, FOUR, WITHIN, #, #)

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

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

  • Существует два параметра, которые управляют тем, как устанавливается связь между регионами. Параметр Число соседних ячеек определяет геометрию связности, либо как ортогональную (четырехполосную), либо как диагональную, а также ортогональную (восьмиполосную). Параметр Метод группировки в зоны определяет, какие значения ячейки рассматривать для оценки связности.

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

    Этот параметр применяется, только когда параметр Метод группировки в зоны (zone_connectivity в Python) задан как Внутри. Если он задан как Пересекает,таблица атрибутов выходного растра будет содержать только обычные поля Value и Count fields.

  • Если поле LINK доступно, оно позволяет проследить происхождение каждого вновь созданного региона до исходных значений входных зон, которые будут использоваться для дополнительного анализа.

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входной растр

Входной растр, уникальные смежные регионы ячеек которого будут идентифицированы.

Должен быть целочисленным.

Raster Layer
Число соседних ячеек
(Дополнительный)

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

  • ЧетыреСмежность оценивается для четырех ближайших (ортогональных) соседей каждой входной ячейки. Только ячейки с одинаковым значением, которые разделяют хотя бы одну сторону, будут входить в состав отдельного региона. Если две ячейки расположены относительно друг друга по диагонали, они не считаются смежными. Это значение по умолчанию.
  • ВосемьСмежность оценивается для восьми ближайших (ортогональных и диагональных) соседей каждой входной ячейки. Ячейки с одинаковым значением, которые соединены либо вдоль общего ребра, либо под углом друг к другу, будут входить в состав отдельного региона.
String
Метод группировки в зоны
(Дополнительный)

Определяет, какие значения ячеек должны учитываться при тестировании на связанность.

  • ВнутриСмежность для региона оценивается для входных ячеек, которые являются частью одной и той же зоны (значения ячейки). Единственные ячейки, которые могут быть сгруппированы – это ячейки из одной и той же зоны, которые отвечают пространственным требованиям к связности, определенным параметром Число соседних ячеек (четыре или восемь). Это значение по умолчанию.
  • ПересекаетСмежность для региона оценивается между ячейками любого значения, за исключением ячеек зоны, идентифицированных как исключаемые параметром Исключенное значение, и при условии соблюдения пространственных требований, задаваемых параметром Число соседних ячеек. Группы регионов во входных данных, которые отделены от других групп буфером ячеек NoData, будут обрабатываться независимо друг от друга.
String
Добавить поле связи к выходному файлу
(Дополнительный)

Указывает, будет ли поле связи добавляться в таблицу выходных данных, когда параметр Метод группировки в зоны выбран как Внутри. Этот параметр игнорируется, если значением параметра является Пересекает.

  • Отмечено – поле LINK будет добавлено в таблицу выходного растра. В этом поле хранится значение зоны, к которой принадлежат ячейки каждого региона в выходных данных, в соответствии с правилом смежности, определенным в параметре Число соседних ячеек. Это значение по умолчанию.
  • Не отмечено – поле LINK не будет добавлено. Таблица атрибутов выходного растра будет содержать только поля Value и Count.
Boolean
Исключенное значение
(Дополнительный)

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

Ячейки с исключенным значением будут обрабатываться аналогично ячейкам NoData и исключаться из рассмотрения в ходе операции. Входные ячейки, содержащие исключенное значение, на выходном растре будет получат значение 0. Исключенное значение аналогично понятию значения фона.

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

Long

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

ПодписьОписаниеТип данных
Выходной растр

Выходной растр группировки.

Выходные данные всегда будут целочисленными.

Raster

RegionGroup(in_raster, {number_neighbors}, {zone_connectivity}, {add_link}, {excluded_value})
ИмяОписаниеТип данных
in_raster

Входной растр, уникальные смежные регионы ячеек которого будут идентифицированы.

Должен быть целочисленным.

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 и исключаться из рассмотрения в ходе операции. Входные ячейки, содержащие исключенное значение, на выходном растре будет получат значение 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

# 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

Связанные разделы