Доступен в аналитике реального времени и больших данных.
Инструмент Присоединить объекты переносит атрибуты от объектов в одном канале, слое или таблице к другим объектам в том же или другом канале или в наборе данных на основе пространственных, временных и атрибутивных отношений или любой их комбинации. Дополнительно вы можете рассчитать статистику для присоединенных объектов.
Схема рабочего процесса
Примеры
Ниже даны примеры использования инструмента Присоединить объекты:
- У аналитика есть данные о преступлениях в городе. Чтобы проанализировать и изучить влияние этих преступлений, необходимо понять связь между местами совершения преступления и различными объектами городской инфраструктуры, такими как школьные округа, полицейские районы и кварталы. При помощи инструмента Присоединить объекты к каждому месту совершения преступления можно присоединить дополнительную информацию, чтобы можно было проследить влияние различных объектов городской инфраструктуры.
- Когда судно из одного канала входит в движущуюся ячейку для суровых погодных условий другого канала, обогатите судно атрибутами из объекта сурового погодного явления.
Примечания по использованию
При работе с инструментом Присоединить объекты следует учитывать следующее:
- Вы можете соединять их на основании пространственного отношения, временного отношения, атрибутивного отношения или любой их комбинации.
Опция Описание Пространственное отношение
Пространственное отношение, определяющее, будут ли объекты присоединяться друг к другу. Доступные отношения будут зависеть от типа геометрии (точки, линии, полигоны) соединяемых слоёв. Доступные пространственные отношения:
- Пересекает
- Enter
- Равны
- Выход
- Ближайший на плоскости
- Ближайший геодезически
- Содержат
- Внутри
- Касается
- Пересекает
- Перекрытия
Примечание:
Целевой объект должен удовлетворять своим пространственным отношениям ко всем присоединяемым объектам, если был указан выход и существует более одного присоединяемого объекта. Для любого другого пространственного отношения и там, где имеется более одного присоединенного объекта, целевой объект может удовлетворять своему пространственному отношению к любому отдельному присоединяемому объекту соединен.
Временное отношение
Временное отношение, определяющее, будут ли объекты присоединяться друг к другу. Доступные отношения будут зависеть от типа времени (мгновенный или интервальный) соединяемых слоёв. Доступные временные отношения:
- Удовлетворяет
- Встречено
- Перекрытия
- Перекрыто
- Во время
- Содержат
- Равны
- Завершает
- Завершено
- Начинает
- Начато
- Пересекает
- Ближайший объект
Атрибутивное отношение
Атрибутивное отношение, определяющее, будут ли объекты присоединяться друг к другу. Атрибуты объектов соединяются, если значения поля в присоединяемом слое идентичны значениям поля в целевом слое.
- Если несколько пространственных объектов совпадают с одним и тем же целевым объектом, вы можете определить, соединять ли все совпадающие объекты (Присоединить один-ко-многим) или суммировать все объекты вместе (Присоединить один-к-одному) следующим образом:
- Присоединить один-к-одному – эта опция суммирует все атрибуты всех совпадающих присоединяемых объектов и присоединяет эти полученные значения к каждому объекту в целевом слое. Только целевые объекты, имеющие совпадение, будут включены в результат. Количество присоединенных объектов добавляется в дополнение к другой статистике, такой как сумма, минимум, максимум, диапазон, дисперсия, среднее и среднеквадратическое отклонение. Суммарную статистику можно вычислить, только если выбрана операция Присоединить один-к-одному.
- Присоединить один-ко-многим – эта опция присоединяет все совпадающие объекты в присоединяемом слое с объектами целевого слоя. Результирующий слой будет содержать несколько записей целевого объекта.
Если для параметра Операции соединения указано значение Один-ко-многим, в выходном классе пространственных объектов может быть несколько строк для каждого целевого объекта.
- При настройке инструмента Присоединить объекты для соединения один-к-одному, можно выбрать опцию Сохранить только присоединенные объекты или Сохранить все объекты, независимо от результатов соединения.
- Если вы выберете Сохранить только присоединенные объекты, в выходных данных присутствуют только те объекты, которые успешно соединены с объектами из набора данных соединения.
- Если вы выберете Сохранить все объекты, независимо от результатов соединения, все объекты из целевого набора данных существуют в выходных данных, независимо от того, были ли к ним присоединены какие-либо атрибуты.
- При сохранении всех объектов, если объект сохраняется, но не имеет соединения, значение COUNT равно 0, и все атрибутивные значения полей суммирования будут пустыми (null).
- Эта опция доступна только соединения один-к-одному.
- Если целевые и присоединяемые объекты находятся в разных системах координат, используется система координат целевых объектов.
- Если присоединяемый объект имеет пространственное отношение с несколькими целевыми объектами, он учитывается столько раз, сколько он был сопоставлен с целевым объектом. Например, если точка находится внутри трех полигонов, она считается три раза, по одному разу для каждого полигона.
- Если Пространственное отношение задано как Рядом геодезически или Рядом на плоскости, целевой слой должен быть спроецирован или выходная система координат должна быть задана как система координат проекции.
- Дополнительно вы можете построить выражение для присоединения объектов. Если вы указываете выражение, используются только соответствующие условию пространственные объекты. Например, используя выражение $target["Magnitude"] > $join["Explosion"], можно присоединить целевые пространственные объекты, значение которых в поле Magnitude больше, чем значения присоединяемых объектов в поле Explosion.
Подробнее о выражениях Arcade с командой Присоединить объекты.
- Когда Пространственное отношение задано как вход или выход в аналитике в реальном времени, верно следующее:
- Инструмент работает с отслеживанием состояния, это позволяет сравнивать последовательные наблюдения друг с другом, чтобы выявлять, когда состояние изменилось, например, отличается ли текущее состояние от состояния предыдущего наблюдения. Как и в случае с другими пространственными отношениями в аналитике в режиме реального времени, инструменту не нужно сравнивать какие-либо наблюдения с предыдущими, поэтому он может работать без учета состояния, что требует меньших затрат ресурсов.
- При работе с отслеживанием состояния инструмент Присоединить объекты поддерживает хранилище состояний текущего наблюдения для каждого track ID. Когда получено новое наблюдение, оно сравнивается с текущим наблюдением того же track ID, если оно присутствует. Если у нового наблюдения более новая временная метка, чем у текущего наблюдения в хранилище состояний, то текущее наблюдение заменяется. Но если временная метка такая же, как у текущего наблюдения для того же track ID, то инструмент не сможет найти различия между двумя наблюдениями. Это значит, что инструмент не заменяет текущее наблюдение в хранилище состояний на новое, а новое наблюдение добавляется к хранилищу состояний, и будущие наблюдения для этого идентификатора трека (track ID) будут сравниваться с текущим наблюдением, которое останется в хранилище состояний до тех пор, пока не появятся новые наблюдения с более поздней меткой времени. Инструмент записывает предупреждение о том, что это произошло.
- Если отмечено Первое наблюдение может вызвать вход или Первое наблюдение может вызвать выход, это говорит о том, что первый полученный целевой объект удовлетворяет условию фильтра, если он находится внутри любого присоединяемого объекта (в случае входа) или снаружи объекта (в случае выхода), несмотря на отсутствие предыдущей целевой функции, с которой можно было бы сравнить местоположение текущей целевой функции. Значение по умолчанию - false (не отмечено).
- Параметр Целевое временное окно должен быть установлен как минимум на самый длительный ожидаемый интервал между наблюдениями для любого заданного трека. Наблюдения старше этой продолжительности удаляются из памяти для управления ресурсами.
- Рекомендуется установить это значение с запасом, так как слишком короткое значение может привести к удалению записей из хранилища объектов до поступления новых наблюдений. Это означает, что историческая информация удаляется из хранилища объектов, а следующий объект рассматривается как первоначальное наблюдение. Иными словами, наблюдения никогда не будут входить в инструмент Присоединить объекты или выходить из него, поскольку аналитик не будет знать о предыдущем наблюдении.
- В динамическом геозонировании необходимо установить параметр Временное окно присоединения. Если в присоединенном канале нет поля с тегами END_TIME, а последнее известное наблюдение для объекта соединения старше, чем это окно, оно будет удалено из памяти инструмента и не будет включено в анализ. Если в канале присоединения есть поле с тегами END_TIME, объект будет удален из хранилища геозоны в соответствии со значением в поле, отмеченном как END_TIME или по окончании временного окна присоединения, в зависимости от того, что наступит раньше.
- Статистика вычисляется только для тех пространственных объектов, которые соответствуют указанным пространственному, временному или атрибутивному отношениям, используемым в операции Присоединить один-к-одному. Вы можете вычислить статистику по числам и строкам.
Параметры
При работе с инструментом Присоединить объекты следует учитывать следующее:
Параметр | Описание | Тип данных |
---|---|---|
Целевой слой | Целевой слой содержит объекты для обработки. | Объекты |
Присоединяемый слой | Слой, объекты которого присоединяются к объектам целевого слоя. | Объекты |
Операция соединения | Определяет применение соединения один-к-одному или один-ко-многим.
| Строка |
Сохранить все объекты | Определяет, будут ли сохранены только успешно присоединенные объекты или все объекты, независимо от того, были ли к ним успешно присоединены другие объекты. Эта опция доступна только соединения один-к-одному. Для соединений один-ко-многим, эта опция не доступна, возвращаются только успешно соединенные объекты. Если сохраняются все объекты, то для объектов без объединения значение количества равно нулю и все значения полей суммирования будут пустыми (null). | Строка |
Пространственное отношение | Определяет критерии, использующиеся для пространственного соединения объектов. Если этот параметр отмечен, доступны различные пространственные критерии.
| Строка |
Расстояние отношения Рядом | Указанное расстояние от целевого объекта, в пределах которого присоединяемые объекты будут учитываться для пространственного соединения. Расстояние отношения Рядом допустимо только в том случае, если пространственное отношение задано как Ближайший геодезически или Ближайший на плоскости. | Линейные единицы измерения |
Временное отношение | Определяет критерии времени для сопоставления объектов. Этот параметр появляется, если отмечено Временный. В зависимости от временных объектов Мгновенный или Интервальный, доступны различные временные критерии.
| Строка |
Расстояние временного отношения Рядом | Количество времени между событиями. Соединения происходит между событиями, которые происходят в пределах этого временного окна. Этот параметр доступен, если Временное отношение установлено на Рядом. | Единицы времени |
Атрибутивное отношение | Соединение объектов происходит по значениям атрибутивного поля. Указывает, какое атрибутивное поле целевого слоя должно быть сопоставлено с атрибутивным полем слоя соединения. Этот параметр доступен, если отмечено Атрибут.
| Строка |
Поля суммирования | Определяет статистику, которая будет рассчитываться по указанным полям из объектов соединения. Статистика рассчитывается для соединений один-к-одному. Доступны различные типы статистики в зависимости от того, является ли указываемое поле строковым, числовым или полем типа дата.
| Строка |
Условие присоединения | Применяет к указанным полям условие. Будут присоединены только объекты, значение полей которых соответствуют этим условиям. Например, вы можете применить соединение к объектам, у которых атрибутивное значение 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 и так далее, чтобы избежать конфликтов имен полей.