Zusammenfassung
Extrahiert in benutzerdefinierten Intervallen in einem Punkt-Track-Dataset eindeutige Kennungen, die sich durch Raum und Zeit bewegen.
Verwendung
Das Werkzeug identifiziert eindeutige Kennungen in den Eingabe-Features, die sich in einem bestimmten Zeit- und Entfernungsintervall von anderen Features bewegen. Für die Eingabe-Features müssen Zeiteigenschaften aktiviert sein.
Informationen zur Aktivierung der Zeiteigenschaften eines Datasets finden Sie unter Festlegen der Zeiteigenschaften für Daten.
Verwenden Sie bei der Auswahl des Feldes für die eindeutige Kennung ein Feld, das ganze Zahlen oder Text enthält. Dies ermöglicht eine effizientere Gruppierung der Features. Zudem wird eine optimale Ausgabe zurückgegeben.
Kleinere Intervalle für Zeit und räumliche Trennung können schneller verarbeitet werden. Beispiel: Ein Zeitunterschied von 10 Minuten und eine räumliche Trennung von 100 Metern wird deutlich schneller verarbeitet als eine Zeitunterschied von 1 Stunde und eine räumliche Trennung von 1 Kilometer.
Die Ausgabe-Features stellen die Positionen von Features ähnlicher Tracks dar. Zwei Felder werden zu den Ausgabe-Features hinzugefügt, die die zeitliche und räumliche Trennung zwischen dem Ausgangs-Track und möglichen ähnlichen Tracks angeben. Außerdem werden weitere Beschreibungsfelder ergänzt.
Die Ausgabe-Features enthalten die folgenden Felder:
- traveler_id: Die eindeutige Kennung für das Ausgangs-Track-Feature. Dies ist die Kennung, mit der sich das Feature mit ähnlichem Track bewegt hat. Sie kann als Quellen-Feature betrachtet werden.
- cotraveler_id: Die eindeutige Kennung für das Feature mit ähnlichem Track. Dies ist die Kennung, mit der sich das Ausgangs-Track-Feature bewegt hat. Sie kann als Ziel-Feature betrachtet werden.
- X: Die X-Koordinate des Ausgangs-Track-Features. Die Koordinate wird in den Projektionseinheiten der Eingabe-Features angegeben.
- Y: Die Y-Koordinate des Ausgangs-Track-Features. Die Koordinate wird in den Projektionseinheiten der Eingabe-Features angegeben.
- X_cotraveler: Die X-Koordinate des Features mit ähnlichem Track. Die Koordinate wird in den Projektionseinheiten der Eingabe-Features angegeben.
- Y_cotraveler: Die Y-Koordinate des Features mit ähnlichem Track. Die Koordinate wird in den Projektionseinheiten der Eingabe-Features angegeben.
- traveler_time: Datum und Uhrzeit für das Ausgangs-Track-Feature.
- cotraveler_time: Datum und Uhrzeit für das Feature mit ähnlichem Track.
- distance_difference: Die Entfernung zwischen dem Feature, das in den Eingabe-Features identifiziert wurde, und dem ermittelten ähnlichen Track. Die Entfernung wird in den linearen Einheiten der Eingabe-Features angegeben.
- time_difference: Die zeitliche Trennung zwischen dem Feature, das in den Eingabe-Features identifiziert wurde, und dem ermittelten ähnlichen Track. Der Zeitunterschied wird in Sekunden angegeben und kann eine positive oder negative Zahl sein. Mit positiven Zahlen werden Features angegeben, die dem Ausgangs-Track folgen. Mit negativen Zahlen werden Features angegeben, die sich vor dem Ausgangs-Track befinden.
- cotraveling_pair_id: Eine eindeutige Kennung, die für jedes eindeutige Paar von Features mit ähnlichem Track generiert wird. Zwei Features mit ähnlichem Track (A, B) nutzen gemeinsam dieselbe cotraveling_pair_id für (A, B) und (B, A).
Es gibt eine optionale Summentabelle, die anhand der Ausgabe-Features erstellt werden kann. Die Summentabelle enthält die folgenden Felder:
- unique_pair_id: Eine eindeutige Kennung, die für jedes eindeutige Paar von Features mit ähnlichem Track generiert wird. Zwei Features mit ähnlichem Track (A, B) nutzen gemeinsam dieselbe unique_pair_id für (A, B) und (B, A).
- traveler_id: Die eindeutige Kennung für das Ausgangs-Track-Feature. Dies ist die Kennung, mit der sich das Feature mit ähnlichem Track bewegt hat. Sie kann als Quellen-Feature betrachtet werden.
- cotraveler_id: Die eindeutige Kennung für das Feature mit ähnlichem Track. Dies ist die Kennung, mit der sich das Ausgangs-Track-Feature bewegt hat. Sie kann als Ziel-Feature betrachtet werden.
- time_diff_max: Die maximale zeitliche Trennung zwischen dem Ausgangs-Track und dem ähnlichen Track.
- time_diff_min: Die minimale zeitliche Trennung zwischen dem Ausgangs-Track und dem ähnlichen Track.
- time_diff_mean: Die mittlere zeitliche Trennung zwischen dem Ausgangs-Track und dem ähnlichen Track.
- time_diff_std: Die Standardabweichung der zeitlichen Trennung zwischen dem Ausgangs-Track und dem ähnlichen Track.
- dist_diff_max: Die maximale räumliche Trennung zwischen dem Ausgangs-Track und dem ähnlichen Track.
- dist_diff_min: Die minimale räumliche Trennung zwischen dem Ausgangs-Track und dem ähnlichen Track.
- dist_diff_mean: Die mittlere räumliche Trennung zwischen dem Ausgangs-Track und dem ähnlichen Track.
- dist_diff_std: Die Standardabweichung der räumlichen Trennung zwischen dem Ausgangs-Track und dem ähnlichen Track.
- unique_pair_id_count: Die Gesamtzahl der Features, die für die unique_pair_id als Features mit ähnlichem Track identifiziert wurden.
Syntax
arcpy.intelligence.FindCotravelers(input_features, out_featureclass, id_field, {search_distance}, {time_difference}, {input_type}, {secondary_features}, {secondary_id_field}, {create_summary_table}, {out_summary_table})| Parameter | Erklärung | Datentyp |
input_features | Die Features mit aktivierten Zeiteigenschaften, die die bekannte Kennung darstellen, die für die Suche von ähnlichen Tracks verwendet wird. Eindeutige Kennungen, Zeitstempel und Positionen werden auf den Ausgabe-Layer übertragen, um die Berechnung der zeitlichen und räumlichen Trennung zu unterstützen. | Feature Layer |
out_featureclass | Die Ausgabe-Feature-Class, die Punkt-Track-Segmente enthält, die als ähnlicher Track in den Eingabe-Quell-Layern identifiziert wurden. Diese Feature-Class enthält die Quelle, mit der das angegebene Punkt-Track-Segment verknüpft ist. Für jedes Punkt-Track-Feature wird die zeitliche und räumliche Trennung berechnet. | Feature Class |
id_field | Ein Feld der Eingabe-Features, das zum Abrufen der eindeutigen Kennung pro Punkt-Track verwendet wird. Das Feld wird in die Ausgabe-Feature-Class kopiert. | Field |
search_distance (optional) | Die maximale Entfernung, durch die Features getrennt sein können, bevor sie nicht mehr als Features ähnlicher Tracks betrachtet werden. Der Standardwert ist 100 Fuß (30 m). | Linear Unit |
time_difference (optional) | Der maximale Zeitunterschied, durch den Features getrennt sein können, bevor sie nicht mehr als Features ähnlicher Tracks betrachtet werden. Der Standardwert beträgt 10 Sekunden. | Time Unit |
input_type (optional) | Gibt an, ob ähnliche Tracks in einer oder zwischen zwei Feature-Classes ermittelt werden.
| String |
secondary_features (optional) | Eine sekundäre Feature-Class zum Ermitteln von ähnlichen Tracks. Mögliche ähnliche Tracks werden anhand der folgenden Kriterien ausgewertet:
| Feature Layer |
secondary_id_field (optional) | Ein Feld aus Sekundäre Features, das zum Abrufen der eindeutigen Kennung pro Punkt-Track verwendet wird. Das Feld wird in die Ausgabe-Feature-Class kopiert. | Field |
create_summary_table (optional) | Gibt an, ob eine Ausgabe-Summentabelle erstellt werden muss.
| Boolean |
out_summary_table (optional) | Die Ausgabetabelle, in der die Summeninformationen gespeichert werden. Diese Option ist nur aktiviert, wenn der Parameterwert Summentabelle erstellen auf "True" gesetzt ist. | Table |
Codebeispiel
Das folgende Python-Skript veranschaulicht, wie die Funktion FindCotravelers in einem eigenständigen Skript ohne die Ausgabe-Summentabelle und eine Eingabe-Feature-Class verwendet wird.
# Name: FindCotravelers.py
# Description: Identify cotravelers in a point track dataset.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Tracks.gdb"
# Set local variables
source_features = "Known_Tracks"
output_point_features = "Cotravelers"
id_field = "device_id"
# Execute tool
arcpy.FindCotravelers_intelligence(source_features,
output_point_features,
id_field)Das folgende Python-Skript veranschaulicht, wie die Funktion FindCotravelers in einem eigenständigen Skript mit der Ausgabe-Summentabelle und zwei Eingabe-Feature-Classes verwendet wird.
# Name: FindCotravelers.py
# Description: Identify cotravelers in a point track dataset.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Tracks.gdb"
# Set local variables
source_features = "Known_Tracks"
unknown_features = "Unknown_Tracks"
output_point_features = "Cotravelers"
id_field_name = "device_id"
unknown_id_field = "MMSI"
search_distance = "75 Feet"
time_difference = "5 Seconds"
summary_table = "CREATE_SUMMARY_TABLE"
summary_table_name = "Tracks_Summary_Table"
# Execute tool
arcpy.FindCotravelers_intelligence(source_features,
output_point_features,
id_field_name,
search_distance,
time_difference,
"TWO_FEATURECLASSES",
unknown_features,
unknown_id_field,
summary_table,
summary_table_name)Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Nein
- Advanced: Ja