Narzędzie Śledź zdarzenia w pobliżu śledzi zdarzenia, które występują blisko siebie w przestrzeni (lokalizacji) i czasie. Warstwa wejściowa musi zawierać punkty zawierające dane czasowe reprezentujące moment w czasie.
Diagram procedury wykonywania zadań
Analiza z użyciem narzędzi GeoAnalytics Tools
Analiza z użyciem narzędzi GeoAnalytics Tools jest uruchamiana przy zastosowaniu przetwarzania rozproszonego na wielu komputerach i rdzeniach ArcGIS GeoAnalytics Server. Narzędzia GeoAnalytics Tools oraz narzędzia do standardowej analizy obiektowej w oprogramowaniu ArcGIS Enterprise mają różne parametry i możliwości. Więcej informacji o tych różnicach można znaleźć w sekcji Różnice między narzędziami analizy obiektowej.
Terminologia
| Okres ważności | Definicja | Przykład |
|---|---|---|
Obiekt | Przemieszczający się obiekt, którego lokalizacja jest okresowo rejestrowana. | Może to być zwierzę, osoba lub pojazd. Obiekt może być stacjonarny lub ruchomy. |
Obiekty zainteresowania | Konkretne obiekty używane do rozpoczęcia śledzenia. | Osoba zarażona koronawirusem (COVID-19). |
Zdarzenie w pobliżu | Sytuacja, w której obiekty znajdują się blisko siebie przez określony czas. | Dwie osoby znajdujące się w odległości 3 metrów od siebie, w oknie czasowym wynoszącym 1 minutę. |
Głębia | Stopień separacji między obiektem zainteresowania i obiektem znajdującym w dalszej części ścieżki (w dół ścieżki). | Zdarzenie w pobliżu, które zachodzi między obiektem zainteresowania i inną osobą, oznacza głębokość 1. |
Zdarzenie śledzenia | Pierwszy kontakt między określonym obiektem (w dół ścieżki) i obiektami zainteresowania. |
Przykłady
Członkowie instytucji monitorują wydane przez firmę urządzenia, które są noszone przez pracowników. Kierownictwo firmy chce wiedzieć, którzy pracownicy przebywali w pobliżu osoby chorej na COVID-19. Używając warstwy punktowej reprezentującej lokalizację urządzeń i czas, kierownictwo firmy może zidentyfikować urządzenia, które w tym samym czasie (z dokładnością do 5 minut) znajdowały się w promieniu 6 metrów od zarażonej osoby i innych potencjalnie zarażonych pracowników.
Organizacja pozarządowa monitorująca populację łososi przy użyciu urządzeń GPS chce śledzić rozprzestrzenianie się wszy łososiowych między osobnikami, które uciekły z hodowli, a dziką populacją. Niektóre z oznaczonych urządzeniami GPS łososi hodowlanych są śledzone, dzięki czemu można sprawdzić, czy zbliżają się do oznaczonych dzikich populacji. Można także określić, czy dzikie osobniki mogą zarażać kolejne populacje. Pomiary dotyczą również pola głębi, które służy organizacji pozarządowej do znajdowania ryb na podobnej głębokości.
Uwagi dotyczące korzystania
Śledząc zdarzenia w pobliżu, użytkownik jest zobowiązany do zapoznania się z wytycznymi instytucji, lokalnymi i krajowymi dotyczącymi wrażliwości i prywatności danych.
W wynikach nie są uwzględniane punkty wejściowe, które nie mają pola z wartością czasu, wartością geometrii lub identyfikatorem obiektu.
Stosując śledzenie w pobliżu w celu znajdowania przenoszenia się (na przykład choroby), należy pamiętać o następujących kwestiach:
- Obecność zdarzenia śledzenia nie gwarantuje, że doszło do przeniesienia — jest to tylko potencjalnie możliwe.
- Brak obecności zdarzenia śledzenia nie oznacza, że nie doszło do przeniesienia. W przypadkach takich jak choroba może dochodzić do przenoszenia przez inne wektory.
- Gdy jest to możliwe, użyj parametru Wybierz jeden lub większą liczbę atrybutów obiektów do dopasowania do ograniczenia zdarzeń w pobliżu, jeśli jest to potrzebne. Na przykład użyj atrybutów do wprowadzenia ograniczenia dotyczącego pomieszczenia, piętra lub wysokości.
Określenie większej odległości wyszukiwania czasowego i odległości wyszukiwania przestrzennego skutkuje większą liczbą zdarzeń i dłuższym przetwarzaniem wyników. Określenie mniejszej odległości skutkuje mniejszą liczbą zdarzeń i krótszym czasem przetwarzania.
Obiekty muszą spełniać zarówno kryteria odległości wyszukiwania przestrzennego, jak i czasowego, aby zostały uznane za obiekty położone blisko siebie.
 |  |
Uwzględnij wiedzę właściwą dla danej dziedziny, aby określić wartości używane dla parametrów odległości wyszukiwania przestrzennego i odległości wyszukiwania czasowego. Podczas konfigurowania odległości weź pod uwagę czynniki, takie jak dokładność urządzenia.
Obiekt zainteresowania wyznacza miejsce rozpoczęcia śledzenia bliskości. Jeśli określisz czas początkowy, śledzenie dla wybranego obiektu rozpocznie się w tym wyznaczonym czasie. Jeśli nie podasz czasu, śledzenie dla tego obiektu rozpocznie się 1 stycznia 1970 roku.
Domyślnie ścieżki obiektów są tworzone przy użyciu metody geodezyjnej obliczania odległości. Użycie odległości geodezyjnych jest zalecane w następujących przypadkach:
- Ścieżki przekraczające międzynarodową linię zmiany daty — podczas korzystania z metody geodezyjnej, warstwy wejściowe, które przekraczają międzynarodową linię zmiany daty, zawierają ścieżki poprawnie przekraczające międzynarodową linię zmiany daty. Warstwę wejściową lub odniesienie przestrzenne przetwarzania należy skonfigurować na odniesienie przestrzenne obsługujące przejście przez międzynarodową linię zmiany daty — na przykład odwzorowanie globalne, takie jak World Cylindrical Equal Area (Odwzorowanie walcowe wiernopowierzchniowe świata).
- Zestaw danych nie jest zdefiniowany w odwzorowaniu lokalnym — jeśli dane wejściowe są wyrażone w odwzorowaniu lokalnym, należy użyć metody odległości planarnych. Przy użyciu metody planarnej można zbadać zdarzenia śledzenia w pojedynczym stanie. Warstwa wejściowa lub odniesienie przestrzenne przetwarzania musi zostać skonfigurowane na odniesienie przestrzenne lokalne względem zestawu danych.
Parametr Opcje zaawansowane umożliwia określenie maksymalnej głębokości śledzenia i atrybutów obiektów do dopasowania:
- Dla zdarzenia w pobliżu można skonfigurować dodatkowe wymagania. Można na przykład śledzić tylko osoby w określonym budynku na terenie kampusu lub tylko w obrębie jednego piętra budynku. Użyj parametru Wybierz jeden lub większą liczbę atrybutów obiektów do dopasowania, aby określić atrybuty ograniczające. Aby na przykład ograniczyć wyszukiwanie do obiektów znajdujących się na tym samym piętrze, użyj pola Floor.
- Domyślnie znajdowane są wszystkie ścieżki między obiektem zainteresowania i obiektem znajdującym w dalszej części ścieżki. Użyj parametru Maksymalna głębokość śledzenia, aby ograniczyć głębokość.
Warstwa wynikowych zdarzeń w pobliżu zawiera pierwsze zdarzenie w pobliżu dla obiektów na ścieżce, a także następujące pola:
- from_id— Identyfikator obiektu znajdującego się wyżej na ścieżce.
- to_id— Identyfikator obiektu znajdującego się niżej na ścieżce.
- depth— Stopień separacji między obiektem zainteresowania i polem to_id.
- duration_minutes— Czas trwania zdarzenia śledzenia w minutach. To pole jest obliczane jako różnica między czasami rozpoczęcia i zakończenia. Na przykład 1,5 minuty odpowiada 90 sekundom. Wartość 0 oznacza, że wystąpiło pojedyncze zdarzenie w pobliżu (ten sam czas rozpoczęcia i zakończenia).
- instant_datetime— Data i czas zdarzenia w pobliżu. To pole jest obliczane jako pierwszy zarejestrowany czas spełniający kryteria zdarzenia w pobliżu.
W celu przeprowadzenia wizualizacji wyników śledzenia można wyświetlić warstwę wynikowych zdarzeń w pobliżu za pomocą suwaka czasu lub na diagramie połączeń w aplikacji ArcGIS Pro.
Za pomocą opcjonalnego parametru Uwzględnij warstwę ścieżek można utworzyć warstwę zawierającą pierwsze zdarzenie i wszystkie kolejne obiekty dla określonego obiektu. Ponadto w wynikowej warstwie ścieżek zawsze są uwzględniane obiekty dla obiektu zainteresowania. Wyniki te są pomocne w wizualizacji tego, gdzie poruszały się obiekty i mogą być używane w narzędziu Rekonstruuj ścieżki. Wynikowa warstwa ścieżek zawiera następujące pola:
- entity_id— Identyfikator obiektu.
- depth— Stopień separacji między obiektem zainteresowania i ścieżką śledzenia. Głębokość pozostaje taka sama na pojedynczej ścieżce.
- instant_datetime— Data każdego obiektu. Jest to ta sama data, która znajduje się w rekordzie obiektów wejściowych.
Jeśli zaznaczono opcję Użyj bieżącego zasięgu mapy, analizowane będą tylko obiekty widoczne w bieżącym zasięgu mapy. Jeśli opcja ta nie została zaznaczona, przeanalizowane zostaną wszystkie obiekty wejściowe w warstwie wejściowej, nawet jeśli znajdują się one poza bieżącym zasięgiem mapy.
Ograniczenia
Wejściowymi zdarzeniami w pobliżu musi być warstwa punktowa z obiektami zawierającymi dane czasowe typu Moment. Obiekty bez danych czasowych nie są uwzględniane w wynikach.
Sposób działania narzędzia Śledź zdarzenia w pobliżu
Na poniższych diagramach przedstawiono sposób, w jaki narzędzie Śledź zdarzenia w pobliżu przetwarza dane. Na tych diagramach czas przedstawiono na osi X. Każdy diagram zawiera cztery jednostki: A, B, C i D. Wyróżniony tekst zawiera opis zdarzeń śledzenia występujących między dwoma obiektami (obiekty z i do), a także głębokość zdarzenia w pobliżu. W tym przykładzie obiekt C jest obiektem zainteresowania, który jest śledzony w dół ścieżki.
Na diagramie 1 obiekt C jest wybranym obiektem zainteresowania. Głębokość wynosi 0.
Na diagramie 2 występuje zdarzenie w pobliżu między obiektami C i B. Głębokość śledzenia wynosi 1. Gdy wiele obiektów jest kolejnymi zdarzeniami w pobliżu, jest to trwałe zdarzenie w pobliżu.
Na diagramie 3 występuje zdarzenie w pobliżu między obiektami B i A. Głębokość śledzenia wynosi 2.
Na diagramie 4 występuje zdarzenie w pobliżu między obiektami C i D. Głębokość śledzenia wynosi 1.
Obiekt B na poniższym obrazie jest obiektem zainteresowania i zalazł się w pobliżu obiektu A trzy razy, co oznaczono niebieskimi kółkami. Przy założeniu, że czas jest określony na osi X, ma miejsce pierwsze zdarzenie w pobliżu (1), po którym następuje przerwa w kontakcie, a następnie zdarzenia w pobliżu 2 i 3. Narzędzie zwraca zdarzenie 1 w warstwie zdarzeń w pobliżu. Zdarzenia w pobliżu 2 i 3 nie są zwracane. Jeśli wybrano parametr Uwzględnij warstwę ścieżek, w wynikowej warstwie ścieżek zwracane są wszystkie obiekty po zdarzeniu w pobliżu 1.
Przykład użycia interfejsu ArcGIS API for Python
Narzędzie Śledź zdarzenia w pobliżu jest dostępne za pośrednictwem interfejsu ArcGIS API for Python.
W tym przykładzie znajdowane są zdarzenia w pobliżu dla wszystkich elementów w warstwie wejściowej, które znalazły się w pobliżu elementu o nazwie 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
Podobne narzędzia
Narzędzie Śledź zdarzenia w pobliżu umożliwia śledzenie zdarzeń, które występują blisko siebie w przestrzeni (lokalizacji) i czasie. Do rozwiązywania podobnych, ale nieco innych problemów, mogą być przydatne inne narzędzia.
Narzędzia analizy Map Viewer
Jeśli interesuje Cię obliczenie wszystkich zdarzeń w pobliżu, a nie interesuje Cię śledzenie w dół ścieżki od obiektu zainteresowania, użyj narzędzia Złącz obiekty.
Jeśli chcesz zrekonstruować punkty do przebytych ścieżek lub zwizualizować ścieżki wynikowe, użyj narzędzia GeoAnalytics Tools Rekonstruuj ścieżki.
Narzędzia analizy aplikacji ArcGIS Desktop
Narzędzie GeoAnalytics Tools Śledź zdarzenia w pobliżu jest także dostępne w aplikacji ArcGIS Pro.
Aby możliwe było uruchomienie tego narzędzia z poziomu aplikacji ArcGIS Pro, w aktywnym portalu Twojego projektu musi działać oprogramowanie ArcGIS Enterprise w wersji 10.9 lub nowszej. W wersji 10.9 należy zalogować się do portalu przy użyciu konta z uprawnieniami do wykonywania analiz przestrzennych w portalu.