| Подпись | Описание | Тип данных |
Входной слой | Точечные, линейные или полигональные объекты, которые будут сгруппированы. | Feature Layer |
Выходные данные | Выходной класс пространственных объектов с сгруппированными объектами, представленными с помощью нового поля с именем group_id. | Feature Class |
Пространственное отношение | Задает тип отношения, по которому будут группироваться объекты.
| String |
Расстояние отношения Рядом (Дополнительный) |
Расстояние, которое будет использоваться для группировки ближайших объектов. Этот параметр используется только в том случае, если для параметра Пространственное отношение установлено значение Ближайший, планарный или Ближайший, геодезический. | Linear Unit |
Временное отношение (Дополнительный) | Задает критерии времени, которые будут использованы для сопоставления объектов. Если для параметра установлено значение Пересечение или Ближайший объект, объекты группируются при соблюдении как пространственных, так и временных критериев. Для поддержки этой опции для входных данных должно быть включено время.
| String |
Расстояние временного отношения Рядом (Дополнительный) |
Временное расстояние, которое будет использоваться для группировки ближайших объектов. Этот параметр используется только в том случае, если для параметра Временное отношение установлено значение Ближайший объект. | Time Unit |
Атрибутивное отношение (Дополнительный) | Выражение ArcGIS Arcade, которое будет использовать для группировки объектов. Например, $a["Amount"] == $b["Amount"] группирует объекты, если поле Amount содержит одинаковые значения. | String |
Краткая информация
Группирует объекты, попадающие в рамки пространственной или пространственно-временной близости относительно друг друга.
Ниже приведены примеры вопросов, на которые можно ответить с помощью рабочих процессов Группировать по близости:
- Какие дороги соединены?
- Где можно выделить группы преступлений, произошедших на близком расстоянии друг от друга?
- Есть ли группы полигонов, перекрывающих друг друга?
Иллюстрация
Использование
Итоговые выходные данные представляют копию входных данных с новым полем с именем group_id. Поле group_id содержит информацию о группировании объектов. Объекты с одинаковым значением group_id находятся в одной группе. Номера групп представляют участие в определенной группе и не подразумевают другой значимости. При повторном использовании инструмента номера групп могут быть в другой последовательности или с теми же значениями. Условные обозначения для результатов будут разбиты на восемь групп. Если в результатах представлено больше 8 групп, то все группы по умолчанию будут показаны восемью цветами. Вы можете изменить условные символы, чтобы показать каждую уникальную группу отдельным символом по полю group_id.
Инструмент поддерживает следующие сочетания отношений:
- Пространственное отношение
- Пространственное отношение и временное отношение
- Пространственное отношение и атрибутивное отношение
- Пространственное отношение, временное отношение и атрибутивное отношение
Поддерживаемые пространственные отношения и входные геометрии описаны в следующей таблице:
Тип входной геометрии Пересекает Касается Ближайший, геодезический Ближайший, планарный Точка
Полилиния
Полигон
Метод наложения Описание Пересекает
Объекты пересекаются, когда объекты или части объектов перекрываются. Это значение по умолчанию
Касается
Объекты касаются другого объекта, если эти объекты имеют пересекающуюся вершину, но не накладываются один на другой.
Ближайший, геодезический
Объекты находятся рядом, если вершина или ребро находятся в пределах заданного геодезического расстояния от другого объекта.
Ближайший, планарный
Объекты находятся рядом, если вершина или ребро находятся в пределах заданного плоскостного расстояния от другого объекта.
Чтобы использовать опцию Ближайший, планарный параметра Пространственное отношение, значение параметра Входной слой должно быть спроецировано или для выходной системы координат должна быть установлена система координат проекции.
Поддерживаемые временные отношения и временные типы описаны в следующей таблице:
Входной временной тип Пересекает Ближайший объект Нет
Мгновение
Интервал
Метод временных отношений Описание Пересекает
Объекты пересекаются, когда какая-либо часть времени объекта перекрывает другую.
Ближайший объект
Объекты являются ближайшими, если время одного объекта находится на заданном временном расстоянии от другого объекта.
Чтобы использовать временные отношения, вы должны включить время для входных данных. Вы можете включить время, выполнив следующие действия:
- Включить время для входных данных подключения к многофайловым объектам (MFC).
- Включите время для слоя на карте. При желании вы можете сохранить слой с включенным временем как файл .lyrx.
Атрибутивные выражения - это симметричная операция. Инструмент берет один входной слой, который сравнивается с самим собой при группировании. Из-за этого входной слой обозначается в выраженииArcGIS Arcade и как a, и как b, и все выражения должны включать и a, и b. Например, чтобы сгруппировать все записи, когда поле Amount содержит одинаковое значение, используйте следующее выражение: $a["Amount"] == $b["Amount"].
Вы можете повысить производительность инструмента Группировать по близости, выполнив одно или несколько из следующих действий:
- Установите параметр среды Экстент так, чтобы вы анализировали только интересующие вас данные.
- При использовании опции Ближайший, планарный или Ближайший, геодезический параметра Пространственное отношение используйте меньшее значение параметра Расстояние временного отношения Рядом.
- При использовании параметра Пространственное отношение опция Ближайший, планарный работает быстрее, чем опция Ближайший, геодезический.
- При использовании опции Ближайший параметра Временное отношение используйте меньшее значение параметра Расстояние временного отношения Рядом.
- Используйте локальные данные там, где запускается анализ.
Этот инструмент геообработки работает от Spark. Анализ выполняется на настольном компьютере с использованием нескольких ядер параллельно. См. Информация по инструментами GeoAnalytics Desktop, чтобы узнать больше о выполнении анализа.
При запуске инструментов GeoAnalytics Desktop анализ выполняется на настольном компьютере. Для оптимальной производительности данные должны быть доступны на настольном компьютере. Если используется размещенный векторный слой, рекомендуется применить ArcGIS GeoAnalytics Server. Если данные находятся не на жестком диске, для запуска инструмента потребуется больше времени. Чтобы использовать ArcGIS GeoAnalytics Server для выполнения анализа, см. GeoAnalytics Tools.
Параметры
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 | Задает тип отношения, по которому будут группироваться объекты.
| String |
spatial_near_distance (Дополнительный) |
Расстояние, которое будет использоваться для группировки ближайших объектов. Этот параметр используется только в том случае, если значение параметра spatial_relationship равно NEAR_PLANAR или NEAR_GEODESIC. | Linear Unit |
temporal_relationship (Дополнительный) |
Задает критерии времени, которые будут использованы для сопоставления объектов. Если для параметра установлено значение INTERSECTS или NEAR, объекты группируются при соблюдении как пространственных, так и временных критериев. Для поддержки этой опции для входных данных должно быть включено время.
| String |
temporal_near_distance (Дополнительный) |
Временное расстояние, которое будет использоваться для группировки ближайших объектов. Этот параметр используется только в том случае, если значение параметра temporal_relationship равно Near. | Time Unit |
attribute_relationship (Дополнительный) | Выражение ArcGIS Arcade, которое будет использовать для группировки объектов. Например, $a["Amount"] == $b["Amount"] группирует объекты, если поле Amount содержит одинаковые значения. | String |
Пример кода
Пример скрипта в окне 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)