Группировать по близости (GeoAnalytics Desktop)

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

Группирует объекты, попадающие в рамки пространственной или пространственно-временной близости относительно друг друга.

Ниже приведены примеры вопросов, на которые можно ответить с помощью рабочих процессов Группировать по близости:

  • Какие дороги соединены?
  • Где можно выделить группы преступлений, произошедших на близком расстоянии друг от друга?
  • Есть ли группы полигонов, перекрывающих друг друга?

Иллюстрация

Иллюстрация инструмента Группировать по близости

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

  • Итоговые выходные данные представляют копию входных данных с новым полем с именем group_id. Поле group_id содержит информацию о группировании объектов. Объекты с одинаковым значением group_id находятся в одной группе. Номера групп представляют участие в определенной группе и не подразумевают другой значимости. При повторном использовании инструмента номера групп могут быть в другой последовательности или с теми же значениями. Условные обозначения для результатов будут разбиты на восемь групп. Если в результатах представлено больше 8 групп, то все группы по умолчанию будут показаны восемью цветами. Вы можете изменить условные символы, чтобы показать каждую уникальную группу отдельным символом по полю group_id.

  • Инструмент поддерживает следующие сочетания отношений:

    • Пространственное отношение
    • Пространственное отношение и временное отношение
    • Пространственное отношение и атрибутивное отношение
    • Пространственное отношение, временное отношение и атрибутивное отношение
    Объекты будут сгруппированы, когда выполнены все указанные отношения.

  • Поддерживаемые пространственные отношения и входные геометрии описаны в следующей таблице:

    Тип входной геометрииПересекаетКасаетсяБлижайший, геодезическийБлижайший, планарный

    Точка

    ОтметкаОтметкаОтметка

    Полилиния

    ОтметкаОтметкаОтметкаОтметка

    Полигон

    ОтметкаОтметкаОтметкаОтметка

    Метод наложенияОписание

    Пересекает

    Объекты пересекаются, когда объекты или части объектов перекрываются. Это значение по умолчанию

    Касается

    Объекты касаются другого объекта, если эти объекты имеют пересекающуюся вершину, но не накладываются один на другой.

    Ближайший, геодезический

    Объекты находятся рядом, если вершина или ребро находятся в пределах заданного геодезического расстояния от другого объекта.

    Ближайший, планарный

    Объекты находятся рядом, если вершина или ребро находятся в пределах заданного плоскостного расстояния от другого объекта.

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

  • Поддерживаемые временные отношения и временные типы описаны в следующей таблице:

    Входной временной типПересекаетБлижайший объект

    Нет

    Мгновение

    ОтметкаОтметка

    Интервал

    ОтметкаОтметка

    Метод временных отношенийОписание

    Пересекает

    Объекты пересекаются, когда какая-либо часть времени объекта перекрывает другую.

    Ближайший объект

    Объекты являются ближайшими, если время одного объекта находится на заданном временном расстоянии от другого объекта.

  • Чтобы использовать временные отношения, вы должны включить время для входных данных. Вы можете включить время, выполнив следующие действия:

  • Атрибутивные выражения - это симметричная операция. Инструмент берет один входной слой, который сравнивается с самим собой при группировании. Из-за этого входной слой обозначается в выраженииArcGIS Arcade и как a, и как b, и все выражения должны включать и a, и b. Например, чтобы сгруппировать все записи, когда поле Amount содержит одинаковое значение, используйте следующее выражение: $a["Amount"] == $b["Amount"].

  • Вы можете повысить производительность инструмента Группировать по близости, выполнив одно или несколько из следующих действий:

    • Установите параметр среды Экстент так, чтобы вы анализировали только интересующие вас данные.
    • При использовании опции Ближайший, планарный или Ближайший, геодезический параметра Пространственное отношение используйте меньшее значение параметра Расстояние временного отношения Рядом.
    • При использовании параметра Пространственное отношение опция Ближайший, планарный работает быстрее, чем опция Ближайший, геодезический.
    • При использовании опции Ближайший параметра Временное отношение используйте меньшее значение параметра Расстояние временного отношения Рядом.
    • Используйте локальные данные там, где запускается анализ.

  • Этот инструмент геообработки работает от Spark. Анализ выполняется на настольном компьютере с использованием нескольких ядер параллельно. См. Информация по инструментами GeoAnalytics Desktop, чтобы узнать больше о выполнении анализа.

  • При запуске инструментов GeoAnalytics Desktop анализ выполняется на настольном компьютере. Для оптимальной производительности данные должны быть доступны на настольном компьютере. Если используется размещенный векторный слой, рекомендуется применить ArcGIS GeoAnalytics Server. Если данные находятся не на жестком диске, для запуска инструмента потребуется больше времени. Чтобы использовать ArcGIS GeoAnalytics Server для выполнения анализа, см. GeoAnalytics Tools.

Параметры

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

Точечные, линейные или полигональные объекты, которые будут сгруппированы.

Feature Layer
Выходные данные

Выходной класс пространственных объектов с сгруппированными объектами, представленными с помощью нового поля с именем group_id.

Feature Class
Пространственное отношение

Задает тип отношения, по которому будут группироваться объекты.

  • ПересекаетОбъекты будут сгруппированы, когда объекты или части объектов перекрываются. Это значение по умолчанию
  • КасаетсяОбъекты будут сгруппированы, если они имеют пересекающуюся вершину, но не накладываются один на другой.
  • Ближайший, планарныйОбъекты будут сгруппированы, если вершина или ребро находятся в пределах заданного плоскостного расстояния от другого объекта.
  • Ближайший, геодезическийОбъекты будут сгруппированы, если вершина или ребро находятся в пределах заданного геодезического расстояния от другого объекта.
String
Расстояние отношения Рядом
(Дополнительный)

Расстояние, которое будет использоваться для группировки ближайших объектов. Этот параметр используется только в том случае, если для параметра Пространственное отношение установлено значение Ближайший, планарный или Ближайший, геодезический.

Linear Unit
Временное отношение
(Дополнительный)

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

  • ПересекаетОбъекты будут сгруппированы, когда какая-то часть времени одного объекта перекрывает другой объект. Это значение по умолчанию
  • Ближайший объектОбъекты будут сгруппированы, когда время объекта находится в пределах диапазона времени другого объекта.
  • НетВремя не будет использоваться для группировки объектов.
String
Расстояние временного отношения Рядом
(Дополнительный)

Временное расстояние, которое будет использоваться для группировки ближайших объектов. Этот параметр используется только в том случае, если для параметра Временное отношение установлено значение Ближайший объект.

Time Unit
Атрибутивное отношение
(Дополнительный)

Выражение ArcGIS Arcade, которое будет использовать для группировки объектов. Например, $a["Amount"] == $b["Amount"] группирует объекты, если поле Amount содержит одинаковые значения.

String

arcpy.geoanalytics.GroupByProximity(input_layer, output, spatial_relationship, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {attribute_relationship})
ИмяОписаниеТип данных
input_layer

Точечные, линейные или полигональные объекты, которые будут сгруппированы.

Feature Layer
output

Выходной класс пространственных объектов с сгруппированными объектами, представленными с помощью нового поля с именем group_id.

Feature Class
spatial_relationship

Задает тип отношения, по которому будут группироваться объекты.

  • INTERSECTSОбъекты будут сгруппированы, когда объекты или части объектов перекрываются. Это значение по умолчанию
  • TOUCHESОбъекты будут сгруппированы, если они имеют пересекающуюся вершину, но не накладываются один на другой.
  • NEAR_PLANARОбъекты будут сгруппированы, если вершина или ребро находятся в пределах заданного плоскостного расстояния от другого объекта.
  • NEAR_GEODESICОбъекты будут сгруппированы, если вершина или ребро находятся в пределах заданного геодезического расстояния от другого объекта.
String
spatial_near_distance
(Дополнительный)

Расстояние, которое будет использоваться для группировки ближайших объектов. Этот параметр используется только в том случае, если значение параметра spatial_relationship равно NEAR_PLANAR или NEAR_GEODESIC.

Linear Unit
temporal_relationship
(Дополнительный)

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

  • INTERSECTSОбъекты будут сгруппированы, когда какая-то часть времени одного объекта перекрывает другой объект. Это значение по умолчанию
  • NEARОбъекты будут сгруппированы, когда время объекта находится в пределах диапазона времени другого объекта.
  • NONEВремя не будет использоваться для группировки объектов.
String
temporal_near_distance
(Дополнительный)

Временное расстояние, которое будет использоваться для группировки ближайших объектов. Этот параметр используется только в том случае, если значение параметра temporal_relationship равно Near.

Time Unit
attribute_relationship
(Дополнительный)

Выражение ArcGIS Arcade, которое будет использовать для группировки объектов. Например, $a["Amount"] == $b["Amount"] группирует объекты, если поле Amount содержит одинаковые значения.

String

Пример кода

GroupByProximity, пример (автономный скрипт)

Пример скрипта в окне Python для использования функции GroupByProximity.

# Name: GroupByProximity.py
# Description: Group roads together that touch
#
# Requirements: An advanced license

# Import system modules
import arcpy

# Set local variables
inFeatures = "C:\myData\cities.gdb\roads"
outname = "groupedRoads"
overlayType = "TOUCHES"

# Run Group By Proximity
result = arcpy.gapro.GroupByProximity(inFeatures, outname, overlayType)