Сводка
Присоединяет атрибуты из одного слоя к другому на основе пространственных, временных или атрибутивных отношений, или любой их комбинации.
Иллюстрация
Использование
Пространственное соединение сопоставляет объекты (строки) входных данных (Целевой слой и Присоединяемый слой) в зависимости от их пространственного расположения. Временное соединение сопоставляет объекты (строки) входных данных на основе их временных отношений. Атрибутивное соединение сопоставляет объекты на основе полей значений.
Вы можете соединять их на основании пространственного отношения, временного отношения, атрибутивного отношения, или любой их комбинации.
Опции Описание Пространственное отношение
Пространственное отношение, определяющее, будут ли объекты присоединяться друг к другу. Доступные отношения будут зависеть от типа геометрии (точки, линии, полигоны) соединяемых слоёв. Доступны следующие пространственные отношения:
- Пересекает
- Равен
- Ближайший (На плоскости) – использует расстояния на плоскости.
- Ближайший (Геодезически) – использует геодезические расстояния. Этот параметр доступен только в ArcGIS Enterprise версии 10.6 и позже.
- Содержит
- Внутри
- Касается
- Перекрещивается
- Перекрывает
Узнайте больше о пространственных отношениях в инструментах GeoAnalytics для Server
Временное отношение
Временное отношение, определяющее, будут ли объекты присоединяться друг к другу. Доступные отношения будут зависеть от типа времени (мгновенный или интервальный) соединяемых слоёв. Доступны следующие временные отношения:
- Удовлетворяет
- Удовлетворил
- Перекрывает
- Перекрыт
- Во время
- Содержит
- Равен
- Завершает
- Завершен
- Начинает
- Начат
- Пересекает
- Ближайший
- Ближайший объект до
- Ближайший объект после
Узнайте больше о временных отношениях в инструментах GeoAnalytics для Server
Атрибутивное отношение
Атрибутивное отношение, определяющее, будут ли объекты присоединяться друг к другу. Атрибуты объектов соединяются, если значения поля в присоединяемом слое идентичны значениям поля в целевом слое.
Если целевые и присоединяемые объекты находятся в разных системах координат, будет использована система координат целевых объектов. Если выбрана выходная система координат, все объекты проецируются в эту систему, а затем соединяются.
Если для Пространственного отношения выбрано Планарный, рядом, для инструмента Присоединить объекты требуется, чтобы Целевой слой был спроецирован, или чтобы для выходной системы координат была задана система координат проекции.
Если несколько пространственных объектов совпадают с одним и тем же целевым объектом, вы можете определить, соединять ли все совпадающие объекты (Присоединить один-ко-многим) или суммировать все объекты вместе (Присоединить один-к-одному):
- Присоединить один-ко-многим – присоединяет все совпадающие объекты в присоединяемом слое с объектами целевого слоя. Полученный в результате слой будет содержать несколько записей для целевого объекта.
- Присоединить один-к-одному – суммирует все совпадающие присоединяемые объекты, и присоединяет их к каждому объекту в целевом слое. Только совпадающие объекты будут включены в суммирование и результат. Количество присоединённых объектов будет добавлено в дополнение к другой статистике, такой как сумма, минимум, максимум, диапазон, дисперсия, среднее и стандартное отклонение. По умолчанию, только те целевые объекты, которые имеют заданное отношение с соединяемыми объектами, будут сохраняться в выходном классе объектов (внутреннее соединение). Если отмечена опция Сохранить все целевые объекты, в выходной класс объектов будут записаны все входные целевые объекты (это называется левым внешним соединением).
Примеры операции присоединения один-ко-многим и один-к-одному. В этом примере присоединение один-к одному включает только количество; дополнительные статистические параметры могут быть вычислены, как показано ниже. Дополнительно вы можете построить выражение для присоединения пространственных объектов с помощью параметра Условие присоединения. Если вы указываете выражение, будут использоваться только соответствующие условию пространственные объекты. Например, используя выражение $target["Magnitude"] > $join["Explosion"] вы можете только соединить целевые объекты из поля Magnitude, если значение поля больше, чем у присоединяемого объекта в поле Explosion. См. раздел Выражения присоединения объектов для дополнительной информации.
При выполнении соединения "один ко многим" в выходные объекты включаются следующие поля:
- Все поля из целевых слоев
- Все поля из присоединяемого слоя
Если одно и то же имя поля существует в целевом и присоединяемом наборах данных, поле соединения будет начинаться со слова join (например, join_fieldname).
Имя поля Описание start_datetime
Это поле представляет время начала и создается, когда для входных данные задано время в виде момента или интервала.
end_datetime
Это поле представляет время окончания и создается, когда для входных данные задано время в виде интервала.
В дополнение ко всем полям из целевого слоя, следующие поля включаются в выходные объекты при выполнении соединения один к одному:
Имя поля Описание count
Число пространственных объектов, которые были присоединены.
statistic_fieldname
Каждая указанная статистика будет создавать поле атрибутов с именем в следующем формате: statistics_field name. Например, максимум и стандартное отклонение для поля id - MAX_id и SD_id, соответственно.
start_datetime
Это поле представляет время начала и создается, когда для входных данные задано время в виде момента или интервала.
end_datetime
Это поле представляет время окончания и создается, когда для входных данные задано время в виде интервала.
Вы можете повысить производительность инструмента Заново создать треки следующими способами:
- Установите параметр среды Экстент так, чтобы вы анализировали только интересующие вас данные.
- Используйте планарный метод вместо геодезического.
- Не применяйте буфер.
- Разбивайте треки, используя параметры Разбиение по времени, Разбиение по временной границе, Разбиение по расстоянию и Выражение разбиения. Использование параметра Разбиение по временной границе обеспечивает наилучшую производительность.
- Используйте локальные данные там, где запускается анализ.
Аналогичный анализ можно выполнить при помощи инструмента Пространственное соединение из набора инструментов Анализ.
Этот инструмент геообработки работает на 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
Синтаксис
arcpy.geoanalytics.JoinFeatures(target_layer, join_layer, output_name, join_operation, {spatial_relationship}, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {attribute_relationship}, {summary_fields}, {join_condition}, {data_store}, {keep_all_target_features})| Parameter | Объяснение | Тип данных |
target_layer | Содержит целевые объекты. Атрибуты целевых объектов, к которым присоединяются атрибуты присоединяемых объектов и которые будут перенесены в выходной. | Record Set |
join_layer | Содержит присоединяемые объекты. Атрибуты, которые будут присоединены к объектам целевого класса. Дополнительные сведения о том, как тип операции соединения влияет на объединение присоединяемых атрибутов, см. в описании параметра Операции соединения (join_operation в Python). | Record Set |
output_name | String | |
join_operation | Определяет, как будут осуществляться соединения между значениями target_layer и join_layer в выходном классе объектов, если найдено несколько присоединяемых объектов, которые имеют то же пространственное расположение по отношению к одному целевому объекту.
| String |
spatial_relationship (Дополнительный) | Задает критерии, которые будут использованы для пространственного соединения объектов.
| String |
spatial_near_distance (Дополнительный) |
Расстояние от целевого объекта, в пределах которого будут рассматриваться объекты соединения, для пространственного соединения. Радиус поиска действует, только когда для параметра spatial_relationship задано NEAR или NEAR_GEODESIC. | Linear Unit |
temporal_relationship (Дополнительный) | Задает критерии времени, которые будут использованы для сопоставления объектов.
Задает критерии времени, которые будут использованы для сопоставления объектов.
| String |
temporal_near_distance (Дополнительный) |
Расстояние во времени от целевого объекта, в пределах которого будут рассматриваться объекты соединения, для пространственного соединения. Время действует, только когда для temporal_relationship выбрано NEAR, NEAR_BEFORE или NEAR_AFTER, и оба объекта содержат информацию о времени. | Time Unit |
attribute_relationship [attribute_relationship,...] (Дополнительный) | Соединяет объекты по значениям атрибутивного поля. Указывает, какое атрибутивное поле целевого слоя должно быть сопоставлено с атрибутивным полем слоя соединения.
| Value Table |
summary_fields [summary_fields,...] (Дополнительный) | Статистика, которая будет рассчитываться по определенным полям.
| Value Table |
join_condition (Дополнительный) | Применяет к указанным полям условие. Будут присоединены только объекты, значение полей которых соответствуют этим условиям. Например, вы можете применить условие присоединения к объектам, у которых атрибутивное значение HealthSpending в слое соединения на 20 процентов больше, чем значение Income в целевом слое. В 10.5 и 10.5.1 выражение условия соединения выглядит так join["HealthSpending"] > target["Income"] * .2. В версии 10.6 и выше, используйте выражения Arcade, например, $join["HealthSpending"] > $target["Income"] * .2. | String |
data_store (Дополнительный) | Задает ArcGIS Data Store, где будут сохраняться выходные данные. По умолчанию – SPATIOTEMPORAL_DATA_STORE. Все результаты, находящиеся в хранилище пространственно-временных больших данных, будут храниться в системе WGS84. Результаты в реляционном хранилище данных сохраняют свои систему координат.
| String |
keep_all_target_features (Дополнительный) | Определяет, будут ли поддерживаться в выходном классе объектов (внешнее соединение) все целевые объекты или только те, у которых имеется заданное отношение с соединяемыми объектами (внутреннее соединение).
| Boolean |
Производные выходные данные
| Name | Объяснение | Тип данных |
| output | Присоединенные выходные данные. | Набор записей |
Пример кода
В следующем автономном скрипте показано, как использовать инструмент JoinFeatures.
# Name: JoinFeatures.py
# Description: Join crime events that are close together in time and space, and
# return the count of nearby crimes. This example is a self join
# (joining the same layer to itself).
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
inFeatures = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Crimes/BigDataCatalogServer/Chicago"
spatialOperation = "NEAR"
nearDistance = "1 Kilometers"
temporalOperation = "NEAR"
nearTime = "3 Hours"
outFS = "CloseCrimes"
dataStore = "SPATIOTEMPORAL_DATA_STORE"
# Execute Join Features
arcpy.geoanalytics.JoinFeatures(inFeatures, inFeatures, outFS, "JOIN_ONE_TO_ONE",
spatialOperation, nearDistance, temporalOperation,
nearTime, None, None, None, dataStore)Environments
- Выходная система координат
Система координат, используемая при анализе. Если данный параметр не указан, анализ будет выполнен во входной системе координат. Для Инструменты GeoAnalytics готовые результаты будут храниться в пространственно-временном хранилище данных в системе координат WGS84.
Информация о лицензиях
- Basic: Требуется ArcGIS GeoAnalytics Server
- Standard: Требуется ArcGIS GeoAnalytics Server
- Advanced: Требуется ArcGIS GeoAnalytics Server