Skip To Content

Трассировка близости событий

Трассировать события по близости Инструмент Трассировка близости событий трассирует события, которые находятся рядом друг с другом в пространстве (местоположение) и времени. Входным слоем должен быть слой точек с включённым временем, представляющих определённый момент времени.

Схема рабочего процесса

Схема рабочего процесса Трассировка близости событий

Анализ с помощью GeoAnalytics Tools

Анализ, выполняемый с помощью GeoAnalytics Tools работает с использованием распределенной обработки по нескольким компьютерам ArcGIS GeoAnalytics Server и ядрам. GeoAnalytics Tools и стандартные инструменты анализа ArcGIS Enterprise имеют различные параметры и возможности. Более подробно об этих различиях см. в разделе Различия между инструментами анализа объектов.

Терминология

ТерминОписаниеПример

Элемент

Движущийся объект с периодически регистрируемым положением.

Животное, человек или транспортное средство. Объект может быть неподвижным или движущимся.

Объекты интереса

Определенные объекты, используемые для начала отслеживания.

Человек, зараженный COVID-19.

Событие близости

Когда два объекта находятся рядом друг с другом в течение определенного периода времени.

Два человека на расстоянии до 3 метров друг от друга и в пределах 1-минутного окна друг от друга.

Глубина

Степень разделения между объектом интереса и объектом, находящимся далее по трассировке (ниже по течению).

Событие близости между объектом интереса и кем-то еще - это глубина 1.

Событие трассировки

Первый контакт для определенного объекта ниже по течению от объектов интереса.

Примеры

Организация контролирует выданные рабочим мобильные устройства. Компания хочет определить, какие сотрудники находились рядом с человеком, о котором известно, что он болеет COVID-19. Используя точечный слой, представляющий местоположения и время устройства, они определяют, какие из устройств находились в пределах шести метров и пяти минут от носителя инфекции и других, возможно, заразных сотрудников.

Одна НПО ведет мониторинг популяций лосося с помощью GPS и заинтересована в отслеживании передачи лососевых вшей между искусственно выращенными рыбами и дикими популяциями. С помощью GPS-меток отслеживается некоторая часть выращенных на фермах особей, чтобы определить, находятся ли они в непосредственной близости от помеченных диких популяций, и как эти дикие популяции могут еще больше распространять заболевание. Эти измерения также учитывают поле глубин, которое НПО использует только для поиска рыбы на аналогичной глубине.

Примечания по использованию

При трассировке событий близости ответственность за понимание организационных, местных и национальных правил, касающихся чувствительности данных и конфиденциальности, ложится на вас.

Входные точки, которые не имеют значений времени, геометрии или поля идентификатора объекта, в результаты не включаются.

При использовании трассировки близости для обнаружения инфицирования (заболевания) следует учитывать следующее:

  • Наличие события трассировки не гарантирует, что оно (заболевание) было передано; это только потенциальная возможность.
  • Отсутствие события трассировки не означает, что нечто не было передано. В таких случаях, как болезнь, возможна передача через другие носители.
  • По возможности используйте параметр Выберите один или несколько атрибутов объекта для сопоставления для уточнения событий близости, когда требуется. Например, атрибуты можно использовать для уточнения комнаты, этажа или высоты.

Указание большего радиуса поиска по времени и большего радиуса поиска в пространстве приведет к большему количеству событий и займет больше времени для обработки результатов. Меньшие значения радиуса дадут меньшее количество событий и меньшее время обработки.

Объекты должны соответствовать как критериям расстояния пространственного поиска, так и критериям параметра расстояния временного поиска, которые должны рассматриваться рядом друг с другом.

Диаграмма Радиус поиска в пространстве
Рисунок A: эти два объекта находятся в пределах радиуса поиска в пространстве друг от друга.
Диаграмма Радиус поиска по времени
Рисунок B: эти два объекта находятся в пределах расстояния временного поиска друг от друга.

Значения, используемые для параметров Радиус поиска в пространстве и Радиус поиска по времени, определяются в зависимости от конкретной области применения этих параметров. Задавая значения этих расстояний, учитывайте такие факторы, как точность устройства.

Объект интереса - это то, где начинается отслеживание близости. Если вы укажете время начала, трассировка для этого объекта начнется в это время. Если вы не укажете время, трассировка для этого объекта начнется 1 января 1970 года.

По умолчанию треки объектов создаются с использованием геодезического метода для расчета расстояний. Рекомендуется использовать геодезическое расстояние в следующих случаях:

  • Треки пересекают международную линию перемены даты – При использовании геодезического метода входные слои, пересекающие международную линию перемены даты, будут иметь треки, надлежащим образом пересекающие эту линию. Ваш входной слой или пространственная привязка обработки должны быть настроены на пространственную привязку, поддерживающую переход через международную линию перемены даты, например, глобальную проекционную привязку типа World Cylindrical Equal Area.
  • Набор данных находится не в локальной проекции — Если входные данные находятся в локальной проекции, используйте метод плоскостного расстояния. Например, с помощью плоскостного метода можно исследовать треки объектов в пределах одного штата. Для входного слоя или обработки должна быть установлена пространственная привязка, локальная для вашего набора данных.

Используйте Дополнительные опции, чтобы указать максимальную глубину трассировки и атрибуты объектов для сопоставления:

  • Для отдельного события близости можно задать дополнительные условия. Например, вы можете отслеживать отдельных людей как только в определенном здании в кампусе, так и только на определенном этаже здания. Задать уточняющие атрибуты можно с помощью параметра Выберите один или несколько атрибутов объекта для сопоставления. Например, чтобы ограничить объекты одним этажом, укажите поле Floor.
  • По умолчанию обнаруживаются все трассировки между объектом интереса и объектом, находящимся далее по трассировке. Используйте параметр Максимальная глубина трассировки, чтобы ограничить глубину.

Слой Выходные события близости будет содержать первое событие близости для объектов трассировки, а также следующие поля:

  • from_id— ID сущности-объекта вверх по течению.
  • to_id— ID сущности-объекта вниз по течению.
  • depthСтепень разделения между объектом интереса и полем to_id.
  • duration_minutes— Длительность события трассировки в минутах. Это поле вычисляется как разница между временем начала и окончания. Например, 1,5 минуты — это 90 секунд. Значение 0 означает, что существует одно событие близости (одно и то же время начала и окончания).
  • instant_datetime— Дата и время события близости. Это поле вычисляется как первое зарегистрированное время, которое отвечает критериям события близости.

Вы можете визуализировать выходной слой событий близости с помощью бегунка времени или на диаграмме связей в ArcGIS Pro, чтобы визуализировать результаты трассировки.

Вы можете использовать дополнительный параметр Включить слой треков, чтобы создать слой, содержащий первое событие трассировки и все последующие объекты для данной трассировки. Кроме того, объекты для интересующего объекта всегда включаются в выходной слой треков. Эти результаты полезны для визуализации перемещений объектов, и могут быть использованы в инструменте Заново создать треки. В выходном слое треков находятся следующие поля:

  • entity_id— ID сущности-объекта.
  • depthСтепень разделения между объектом интереса и треком трассировки. На протяжении отдельного трека глубина будет одинаковой.
  • instant_datetime— Дата каждого объекта. Это будет та же дата, что и запись из входных объектов.

Если опция Использовать текущий экстент карты включена, будут анализироваться только те объекты, которые отображаются в текущем экстенте. Если опция отключена, анализ будет выполнен для всех входных объектов входного слоя, даже если они находятся вне текущего экстента карты.

Ограничения

Входными событиями близости должен быть точечный слой с включенным временем, имеющий тип Текущий. Любые объекты, не имеющие временных атрибутов, не будут включены в выходные результаты.

Как работает инструмент Трассировать события близости

На схемах ниже показано, как инструмент Трассировать события близости обрабатывает данные. На этих схемах время находится на оси x. В каждой диаграмме есть четыре объекта: A, B, C и D. Выделенный текст описывает события трассъектамиировки, которые происходят между двумя об (объектами "от" и "до"), а также глубину события близости. В этом примере объект С - это объект интереса, который отслеживается ниже по течению.

На схеме 1 объект С является выбранным объектом интереса. Глубина равна 0.

Схема 1 для инструмента Трассировать события близости.

Схема 1 для инструмента Трассировать события близости.

На схеме 2 событие близости происходит между объектами C и B. Глубина трассировки равна 1. Если несколько объектов являются последующими событиями близости, то это устойчивое событие близости.

Схема 2 для инструмента Трассировать события близости.

Схема 2 для инструмента Трассировать события близости.

На схеме 3 событие близости происходит между объектами B и A. Глубина трассировки равна 2.

Схема 3 для инструмента Трассировать события близости.

Схема 3 для инструмента Трассировать события близости.

На схеме 4 событие близости происходит между объектами C и D. Глубина трассировки равна 1.

Схема 4 для инструмента Трассировать события близости.

Схема 4 для инструмента Трассировать события близости.

На изображении ниже объект В является объектом интереса и проходит в непосредственной близости от объекта А три раза, что обозначено голубыми кругами. Подразумевая, что время находится на оси x, первое событие близости равно 1, затем следует разрыв без контакта, а затем события близости 2 и 3. Инструмент возвращает событие 1 в слое событий близости. События близости 2 и 3 не возвращаются. Если выбран параметр Включить слой треков, то все объекты после события близости 1 возвращаются в выходной слой треков.

Пример первого события трассировки.

Пример ArcGIS API for Python

Инструмент Трассировать события близости доступен в ArcGIS API for Python.

В этом примере находят события близости для всех объектов интереса во входном слое, который попадает в близость с объектом entity_3.

# Import the required ArcGIS API for Python modules
import arcgis
from arcgis.gis import GIS

# Connect to your ArcGIS Enterprise portal and confirm that GeoAnalytics is supported
portal = GIS("https://myportal.domain.com/portal", "gis_publisher", "my_password", verify_cert=False)
if not portal.geoanalytics.is_supported():
    print("Quitting, GeoAnalytics is not supported")
    exit(1)   

# Search for and list the big data file shares in your portal
search_result = portal.content.search("", "Big Data File Share")

# Look through the search results for the big data file share of interest
bd_layer = next(x for x in search_result if x.title == "bigDataFileShares_EntityLocationPoints")

# Run the Trace Proximity Events tool 
result = arcgis.geoanalytics.use_proximity.trace_proximity_events(input_points = bd_layer, 
    entity_id_field = "UniqueID",
    entities_of_interest_ids = [{"entityId": "entity_3", "epochTimeStamp": None}],
    spatial_search_distance = 6,
    spatial_search_distance_unit = "feet",
    distance_method = "Geodesic",
    temporal_search_distance = 10,
    temporal_search_distance_unit = "minutes",
    max_trace_depth = None,
    attribute_match_criteria = None,
    include_tracks_layer = None,
    output_name = "TPE_output")

# Visualize the results if you are running Python in a Jupyter Notebook
processed_map = portal.map()
processed_map.add_layer(result)
processed_map

Похожие инструменты

Используйте инструмент Трассировать события по близости, чтобы трассировать события, которые находятся рядом друг с другом в пространстве (местоположение) и времени. Другие инструменты могут применяться для решения похожих, но немного отличающихся задач.

Инструменты анализа Map Viewer

Если вы заинтересованы в вычислении всех событий близости и не заинтересованы в трассировке вниз по течению от интересующего объекта, используйте инструмент Присоединить объекты.

Если вы хотите восстановить точки на пройденных путях или визуализировать выходные треки, используйте Заново создать треки GeoAnalytics Tools.

Инструменты анализа ArcGIS Desktop

Инструмент Трассировать события близости GeoAnalytics Tools также доступен в ArcGIS Pro.

Для запуска инструмента из ArcGIS Pro ваш активный портал проекта должен быть запущен с версией ArcGIS Enterprise 10.9 или более поздней. В версии 10.9 вход на портал необходимо выполнить под учетной записью, имеющей права доступа для выполнения пространственного анализа на данном портале.