Группировать по близости (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

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

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