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

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

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

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

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

Иллюстрация

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

• Этот инструмент геообработки доступен с версией ArcGIS Enterprise 10.9.1 или более новой.

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

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

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

  Метод наложения	Описание
  Пересекает	Объекты пересекаются, когда объекты или части объектов перекрываются. Это значение по умолчанию
  Касается	Объекты касаются другого объекта, если эти объекты имеют пересекающуюся вершину, но не накладываются один на другой.
  Ближайший, геодезический	Объекты находятся рядом, если вершина или ребро находятся в пределах заданного геодезического расстояния от другого объекта.
  Ближайший, планарный	Объекты находятся рядом, если вершина или ребро находятся в пределах заданного плоскостного расстояния от другого объекта.

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

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

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

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

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

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

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

• Этот инструмент геообработки работает на ArcGIS GeoAnalytics Server. Анализ выполняется на вашем GeoAnalytics Server, а результаты сохраняются в ресурсы на ArcGIS Enterprise.

• При запуске инструментов GeoAnalytics Server анализ выполняется на GeoAnalytics Server. Для оптимальной производительности сделайте данные доступными для GeoAnalytics Server через векторные слои, размещенные на вашем портале ArcGIS Enterprise или через файловое хранилище больших данных. Данные, которые не являются локальными для GeoAnalytics Server, будут перемещены на GeoAnalytics Server до начала анализа. Это означает, что для запуска инструмента потребуется больше времени, а в некоторых случаях перемещение данных с ArcGIS Pro на GeoAnalytics Server может завершиться ошибкой. Порог сбоя зависит от скорости сети, а также от размера и сложности данных. Рекомендуется всегда публиковать данные или создавать файловое хранилище больших данных.

  Более подробно о публикации локаторов на портале

  Более подробно о создании файловых хранилищ больших данных в Server Manager

Параметры

Диалог

Подпись	Описание	Тип данных
Входной слой	Точечные, линейные или полигональные объекты, которые будут сгруппированы.	Feature Set
Выходное имя	Имя выходного сервиса пространственных объектов. Имя выходного сервиса объектов с сгруппированными объектами, представленное новым полем с именем group_id	String
Пространственное отношение	Задает тип отношения, по которому будут группироваться объекты. Пересекает—Объекты будут сгруппированы, когда объекты или части объектов перекрываются. Это значение по умолчанию Касается—Объекты будут сгруппированы, если они имеют пересекающуюся вершину, но не накладываются один на другой. Ближайший, планарный—Объекты будут сгруппированы, если вершина или ребро находятся в пределах заданного плоскостного расстояния от другого объекта. Ближайший, геодезический—Объекты будут сгруппированы, если вершина или ребро находятся в пределах заданного геодезического расстояния от другого объекта.	String
Расстояние отношения Рядом (Дополнительный)	Расстояние, которое будет использоваться для группировки ближайших объектов. Этот параметр используется только в том случае, если для параметра Пространственное отношение установлено значение Ближайший, планарный или Ближайший, геодезический.	Linear Unit
Временное отношение (Дополнительный)	Задает критерии времени, которые будут использованы для сопоставления объектов. Если для параметра установлено значение Пересечение или Ближайший объект, объекты группируются при соблюдении как пространственных, так и временных критериев. Для поддержки этой опции для входных данных должно быть включено время. Пересекает—Объекты будут сгруппированы, когда какая-то часть времени одного объекта перекрывает другой объект. Это значение по умолчанию Ближайший объект—Объекты будут сгруппированы, когда время объекта находится в пределах диапазона времени другого объекта. Нет—Время не будет использоваться для группировки объектов.	String
Расстояние временного отношения Рядом (Дополнительный)	Временное расстояние, которое будет использоваться для группировки ближайших объектов. Этот параметр используется только в том случае, если для параметра Временное отношение установлено значение Ближайший объект.	Time Unit
Хранилище данных (Дополнительный)	Задает ArcGIS Data Store, где будут сохраняться выходные данные. По умолчанию это Хранилище больших пространственно-временных данных. Все результаты, находящиеся в хранилище пространственно-временных больших данных, будут храниться в системе WGS84. Результаты в реляционном хранилище данных сохраняют свои систему координат. Хранилище пространственно-временных больших данных—Результаты будут храниться в хранилище больших пространственно-временных данных. Это значение по умолчанию Реляционное хранилище данных—Результаты будут храниться в хранилище реляционных данных.	String

Производные выходные данные

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

Python

arcpy.geoanalytics.GroupByProximity(input_layer, output_name, spatial_relationship, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {data_store})

Имя	Описание	Тип данных
input_layer	Точечные, линейные или полигональные объекты, которые будут сгруппированы.	Feature Set
output_name	Имя выходного сервиса пространственных объектов. Имя выходного сервиса объектов с сгруппированными объектами, представленное новым полем с именем group_id	String
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
data_store (Дополнительный)	Задает ArcGIS Data Store, где будут сохраняться выходные данные. По умолчанию – SPATIOTEMPORAL_DATA_STORE. Все результаты, находящиеся в хранилище пространственно-временных больших данных, будут храниться в системе WGS84. Результаты в реляционном хранилище данных сохраняют свои систему координат. SPATIOTEMPORAL_DATA_STORE—Результаты будут храниться в хранилище больших пространственно-временных данных. Это значение по умолчанию RELATIONAL_DATA_STORE—Результаты будут храниться в хранилище реляционных данных.	String

Производные выходные данные

Имя	Описание	Тип данных
output	Новый класс пространственных объектов с сгруппированными объектами, представленными с помощью нового поля с именем group_id.	Feature Set

Пример кода

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

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

# Name: GroupByProximity.py
# Description: Group roads together that touch
#
# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inFeatures = "https://myGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_cityData/BigDataCatalogServer/roads"
outFS = "groupedRoads"
overlayType = "TOUCHES"
dataStore = "SPATIOTEMPORAL_DATA_STORE"

# Execute Group By Proximity
result = arcpy.geoanalytics.GroupByProximity(inFeatures, outFS, 
                                 overlayType, data_store=dataStore)

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

Выходная система координат, Экстент, Текущая рабочая область

Особые случаи

Выходная система координат

Система координат, используемая при анализе. Если данный параметр не указан, анализ будет выполнен во входной системе координат. Для GeoAnalytics Tools готовые результаты будут храниться в пространственно-временном хранилище данных в WGS84.

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

• Basic: Обязательно ArcGIS GeoAnalytics Server
• Standard: Обязательно ArcGIS GeoAnalytics Server
• Advanced: Обязательно ArcGIS GeoAnalytics Server