Доступен в аналитике реального времени и больших данных.
Инструмент Присоединить объекты 
переносит атрибуты от объектов в одном канале, слое или таблицы к другим объектам в том же или другом канале или в наборе данных, на основе пространственных, временных и атрибутивных отношений или любой их комбинации. Дополнительно вы можете рассчитать статистику для присоединенных объектов.
Схема рабочего процесса
Примеры
Ниже следуют примеры использования инструмента Присоединить объекты:
- У аналитика есть данные о преступлениях в городе. Чтобы проанализировать и изучить влияние этих преступлений, необходимо понять связь между местами совершения преступления и различными объектами городской инфраструктуры, такими как школьные округа, полицейские районы и кварталы. При помощи инструмента Присоединить объекты к каждому месту совершения преступления можно присоединить дополнительную информацию, чтобы можно было проследить влияние различных объектов городской инфраструктуры.
- Когда судно из одного канала входит в движущуюся ячейку для суровых погодных условий другого канала, обогатите судно атрибутами из объекта сурового погодного явления.
Примечания по использованию
При работе с инструментом Присоединить объекты следует учитывать следующее:
- Вы можете соединять их на основании пространственного отношения, временного отношения, атрибутивного отношения или любой их комбинации.
Опция Описание 
Пространственное отношение
Пространственное отношение, определяющее, будут ли объекты присоединяться друг к другу. Доступные отношения будут зависеть от типа геометрии (точки, линии, полигоны) соединяемых слоёв. Доступные пространственные отношения:
- пересекает
- вход
- равно
- выход
- ближайший на плоскости
- ближайший геодезически
- содержит
- внутри
- касается
- перекрещивается
- перекрывает
Примечание:
Целевой объект должен удовлетворять своим пространственным отношениям ко всем присоединяемым объектам, если был указан выход и существует более одного присоединяемого объекта. Для любого другого пространственного отношения и там, где имеется более одного присоединенного объекта, целевой объект может удовлетворять своему пространственному отношению к любому отдельному присоединяемому объекту соединен.
Временное отношение
Временное отношение, определяющее, будут ли объекты присоединяться друг к другу. Доступные отношения будут зависеть от типа времени (мгновенный или интервальный) соединяемых слоёв. Доступные временные отношения:
- встречает
- встречено
- перекрывает
- перекрывается
- во время
- содержит
- равно
- завершает
- завершено
- начинает
- начато
- пересекает
- рядом
Атрибутивное отношение
Атрибутивное отношение, определяющее, будут ли объекты присоединяться друг к другу. Атрибуты объектов соединяются, если значения поля в присоединяемом слое идентичны значениям поля в целевом слое.
- Если несколько пространственных объектов совпадают с одним и тем же целевым объектом, вы можете определить, соединять ли все совпадающие объекты (Присоединить один-ко-многим) или суммировать все объекты вместе (Присоединить один-к-одному):
- Присоединить один-к-одному – эта опция суммирует все атрибуты всех совпадающих присоединяемых объектов и присоединяет эти полученные значения к каждому объекту в целевом слое. Только целевые объекты будут включены в результат. Количество присоединенных объектов будет добавлено в дополнение к другой статистике, такой как сумма, минимум, максимум, диапазон, дисперсия, среднее и стандартное отклонение. Суммарную статистику можно вычислить, только если выбрана операция Присоединить один-к-одному.
- Присоединить один-ко-многим – эта опция присоединяет все совпадающие объекты в присоединяемом слое с объектами целевого слоя. Полученный в результате слой будет содержать несколько записей для целевого объекта.
Показаны примеры операции присоединения один-ко-многим и один-к-одному. В этом примере присоединение один-к одному включает только количество; дополнительные статистические параметры могут быть вычислены, как показано ниже в разделе Как работает Присоединить объекты - Вычисления. Если для параметра Операции соединения указано значение Один-ко-многим, в выходном классе пространственных объектов может быть несколько строк для каждого целевого объекта.
- При настройке инструмента Присоединить объекты для соединения один-к-одному, можно выбрать опцию Сохранить только присоединенные объекты или Сохранить все объекты, независимо от результатов соединения.
- Если вы выберете Сохранить только присоединенные объекты, в выходных данных будут присутствовать только те объекты, которые были успешно соединены с объектами из набора данных соединения.
- Если вы выберете Сохранить все объекты, независимо от результатов соединения, все объекты из целевого набора данных будут существовать в выходных данных, независимо от того, были ли к ним присоединены какие-либо атрибуты.
- При сохранении всех объектов, если объект сохраняется, но не имеет соединения, значение COUNT будет равно 0, и все атрибутивные значения полей суммирования будут нулевыми
- Эта опция доступна только соединения один-к-одному.
- Если целевые и присоединяемые объекты находятся в разных системах координат, будет использована система координат целевых объектов.
- Если присоединяемый объект имеет пространственное отношение с несколькими целевыми объектами, он учитывается столько раз, сколько он был сопоставлен с целевым объектом. Например, если точка находится внутри трех полигонов, она считается три раза, по одному разу для каждого полигона.
- Если для параметра Пространственное отношение задано Ближайший геодезически или Ближайший на плоскости, целевой слой должен быть спроецирован, или в качестве выходной системы координат должна быть установлена система координат проекции.
- Дополнительно вы можете построить выражение для присоединения объектов. Если вы указываете выражение, будут использоваться только соответствующие условию пространственные объекты. Например, используя выражение $target["Magnitude"] > $join["Explosion"] вы можете присоединить целевые пространственные объекты, значение в поле Magnitude которых больше, чем значения присоединяемых объектов в поле Explosion. Более подробно о выражениях Arcade с командой Присоединить объекты.
- Когда Пространственное отношение задано как вход или выход в аналитике в реальном времени, верно следующее:
- Инструмент будет работать с отслеживанием состояния, это позволяет сравнивать последовательные наблюдения друг с другом, чтобы выявлять, когда состояние изменилось, например, отличается ли текущее состояние от состояния предыдущего наблюдения. С другими пространственными отношениями в аналитике в реальном времени инструменту не нужно сравнивать какие-либо наблюдения с предыдущими, поэтому он может работать без сохранения состояния, это менее ресурсозатратно.
- При работе с отслеживанием состояния инструмент Присоединить объекты поддерживает хранилище состояний текущего наблюдения для каждого Track ID. Когда получено новое наблюдение, оно сравнивается с текущим наблюдением того же Track ID, если оно присутствует. Если у нового наблюдения более новая временная метка, чем у текущего наблюдения в хранилище состояний, то текущее наблюдение будет заменено. Если же временная метка такая же, как у текущего наблюдения для того же Track ID, то инструмент не может найти различий между двумя наблюдениями. Это значит, что инструмент не заменит текущее наблюдение в хранилище состояний на новое, а новое наблюдение не будет добавлено к хранилищу состояний, и новые наблюдения для этого Track ID будут сравниваться с текущим наблюдением, которое останется в хранилище состояний до тех пор, пока не появится новое наблюдение с более поздней меткой времени. Инструмент запишет предупреждение о том, что это произошло.
- Если отмечено Первое наблюдение может вызвать вход или Первое наблюдение может вызвать выход, т о это говорит о том, что первый полученный целевой объект удовлетворяет условию фильтра, если он находится внутри любого присоединяемого объекта (в случае входа) или снаружи объекта (в случае выхода), несмотря на отсутствие предыдущей целевой функции, с которой можно было бы сравнить местоположение текущей целевой функции. Значение по умолчанию - false (не отмечено).
- Параметр Целевое временное окно в аналитике реального времени должно быть по продолжительности равным по меньшей мере наибольшему ожидаемому интервалу между наблюдениями для любого трека. Наблюдения старше этой продолжительности будут удалены из памяти для управления ресурсами.
- Если канал подключен к порту соединения, расчеты расстояния будут выполняться динамически на основе изменяющихся объектов как в целевом, так и в присоединенном каналах.
- В динамическом геозонировании необходимо установить параметр Временное окно присоединения. Если в присоединенном канале нет поля с тегами END_TIME, а последнее известное наблюдение для объекта соединения старше этого окна, оно будет удалено из памяти инструмента и не будет включено в анализ. Если в канале присоединения есть поле с тегами END_TIME, объект будет удален из хранилища геозоны в соответствии со значением в поле, отмеченном как END_TIME или по окончании временного окна присоединения, в зависимости от того, что наступит раньше.
- Статистика вычисляется только для тех пространственных объектов, которые соответствуют указанным пространственному, временному или атрибутивному отношениям, используемым в операции Присоединить один-к-одному. Вы можете вычислить статистику по числам и строкам.
Параметры
При работе с инструментом Присоединить объекты следует учитывать следующее:
| Параметр | Описание | Тип данных |
|---|---|---|
Целевой слой | Целевой слой содержит объекты для обработки. | Возможности |
Присоединяемый слой | Слой, объекты которого будут присоединены к объектам целевого слоя. | Возможности |
Операция соединения | Определяет, будет ли соединение один-к-одному или один-ко-многим.
| Строка |
Сохранить все объекты | Определяет, будут ли сохранены только успешно присоединенные объекты или будут сохранены все объекты, независимо от того, были ли к ним успешно присоединены другие объекты. Эта опция доступна только соединения один-к-одному. Для соединений один-ко-многим, эта опция не доступна, возвращаются только успешно соединенные объекты. Если сохраняются все объекты, у объектов без соединения, значение count будет равно 0, и все атрибутивные значения полей суммирования будут нулевыми. | Строка |
Пространственное отношение | Определяет критерии, использующиеся для пространственного соединения объектов. Этот параметр появляется, если отмечено Пространственный. | Строка |
Расстояние отношения Рядом | Указанное расстояние от целевого объекта, в пределах которого присоединяемые объекты будут учитываться для пространственного соединения. Расстояние отношения Рядом допустимо только в том случае, если пространственное отношение задано как Ближайший геодезически или Ближайший на плоскости. | Линейные единицы измерения |
Временное отношение | Определяет критерии времени для сопоставления объектов. Этот параметр появляется, если отмечено Временный. В зависимости от временных объектов Мгновенный или Интервальный, доступны различные временные критерии.
| Строка |
Расстояние временного отношения Рядом | Количество времени между событиями. Соединения будут происходить между событиями, которые происходят в пределах этого временного окна. Этот параметр доступен, если Временное отношение установлено на Рядом. | Единицы времени |
Атрибутивное отношение | Соединение объектов происходит по значениям атрибутивного поля. Указывает, какое атрибутивное поле целевого слоя должно быть сопоставлено с атрибутивным полем слоя соединения. Этот параметр доступен, если отмечено Атрибут.
| Строка |
Поля суммирования | Определяет статистику, которая будет рассчитываться по указанным полям из объектов соединения. Статистика рассчитывается для соединений один-к-одному. Доступны различные типы статистики в зависимости от того, является ли указываемое поле строковым, числовым или полем типа дата.
| Строка |
Условие присоединения | Применяет к указанным полям условие. Будут присоединены только объекты, значение полей которых соответствуют этим условиям. Например, вы можете применить соединение к объектам, у которых атрибутивное значение HealthSpending в слое соединения на 20 процентов больше значения атрибута Income в целевом слое. Выражение условия соединения выглядит так $join["HealthSpending"] > $target["Income"] * .2. | Строка |
Первое наблюдение может вызвать вход/выход | Определяет, удовлетворяет ли первый полученный целевой объект условию пространственного отношения, если он находится внутри любого объекта соединения в случае входа или вне всех объектов соединения в случае выхода, несмотря на отсутствие предыдущего целевого объекта, с которым можно было бы сравнить местоположение текущего целевого объекта. Значение по умолчанию - false (не отмечено). | Boolean |
Изменение геометрии целевого объекта на геометрию присоединяемого объекта | Меняет геометрию целевого объекта на геометрию присоединяемого объекта. Например, если целевой объект является точкой, а присоединяемый объект является полигоном, целевой объект примет полигональную геометрию присоединяемого объекта. Значением по умолчанию является false. Если целевой объект не имеет геометрии, то целевой объект примет геометрию присоединяемого к нему объекта. Если целевой объект имеет геометрию, а присоединяемый объект не имеет геометрии, целевой объект потеряет свою геометрию и станет табличным. Примечание:Этот параметр недопустим, если Сохранить все объекты задано как true. У входных объектов не должно быть разных типов геометрии. | Boolean |
Целевое временное окно | Укажите значение, равное по крайней мере наибольшему ожидаемому интервалу между наблюдениями для любого заданного трека. Наблюдения старше этой продолжительности будут удалены из памяти для управления ресурсами. Этот параметр допустим только в случае, когда Пространственное отношение задано как вход или выход. | Строка |
Временное окно присоединения | Временное окно для соединения каналов (динамические геозоны). Если последнее наблюдение для соединяемого объекта произашло позже, чем указано во временном окне, оно будет удалено и не включено в анализ. Если в канале присоединения есть поле, помеченное как END_TIME, этот параметр не является обязательным. | Строка |
Советы и ограничения
При использовании инструмента Присоединить объекты следует учитывать несколько соображений и ограничений:
- Суммарная статистика будет вычислена, только если выбрана операция Присоединить один-к-одному.
- Имя поля COUNT будет использоваться для представления количества объединенных объектов для соединения один-к-одному. Если имя поля COUNT существует в целевой схеме, поле будет названо join_COUNT. При выполнении нескольких последовательных присоединений, имена полей будут COUNT, join_COUNT, join_COUNT1, join_COUNT2 и так далее, чтобы избежать конфликтов имен полей.