Beschriftung | Erläuterung | Datentyp |
Eingabe-Features | Die Punkt-Features als Punktpositionen entlang der zu erstellenden Tracks. | Feature Layer |
Datumsfeld | Das Datumsfeld, das zum Sortieren der Eingabe-Features-Punkte verwendet wird. | Field |
Ausgabe-Feature-Class | Die ausgegebenen Track-Linien-Features. | Feature Class |
Gruppenfeld (optional) | Ein Feld aus dem Wert des Parameters Eingabe-Features, das zum Gruppieren der Eingabepunkte verwendet wird. Für jede einzelne Gruppe wird ein eigener Track erstellt. | Field |
Geschwindigkeitsfelder einbeziehen (optional) | Gibt an, ob Geschwindigkeitsfelder (speed_mps, speed_mph, speed_kph und speed_knt) in den Wert des Parameters Ausgabe-Feature-Class einbezogen werden sollen.
| Boolean |
Ausgabesequenzpunkte (optional) | Die Ausgabe-Punkt-Features. Die Ausgabe enthält ein SEQUENCE-Feld zur Angabe der Reihenfolge, die für den mit dem Parameter Ausgabe-Feature-Class erstellten Pfad verwendet wird. | Feature Class |
Fehler bei doppelten Zeitstempeln (optional) | Gibt an, ob doppelte Zeitstempel im Wert des Parameters Datumsfeld bzw. in allen Gruppen im Wert des Parameters Gruppenfeld zulässig sein oder einen Fehler bei der Ausführung des Werkzeugs auslösen sollen.
| Boolean |
Eingabefelder beibehalten (optional) | Gibt an, ob Felder aus dem Wert des Parameters Eingabe-Features in den Wert des Parameters Ausgabe-Sequenz-Punkte übertragen werden sollen.
| Boolean |
Zusammenfassung
Konvertiert Sequenzen von Eingabepunktdaten mit aktivierten Zeiteigenschaften, z. B. GPS-Punkte, in eine Reihe von Ausgabepfaden.
Verwendung
Wenn sich die Werte des Parameters Eingabe-Features in einem projizierten Koordinatensystem befinden, verwendet der Wert des Parameters Ausgabe-Feature-Class dasselbe Koordinatensystem. Wenn sich die Werte des Parameters Eingabe-Features in einem geographischen Koordinatensystem befinden, verwendet der Wert des Parameters Ausgabe-Feature-Class den Raumbezug "World Azimuthal Equidistant".
Wenn in den Parameterwerten für Eingabe-Features Punkte mit denselben Koordinaten vorhanden sind, wird der zweiten Y-Koordinate beim Erstellen jeder Ausgabelinie ein Versatz von 1 Zentimeter hinzugefügt. Das liegt daran, dass das Geometriemodell in einer einzelnen Polylinie keine doppelten Stützpunkte zulässt.
Wenn die Punkte des Eingabe-Features in das Koordinatensystem "Web Mercator" projiziert werden, können die Werte in den Feldern Shape Length und distance_m voneinander abweichen, weil die Werte im Feld distance_m mit der geodätischen Länge berechnet werden und als genauer gelten.
Dem Wert des Parameters Ausgabe-Feature-Class werden die folgenden Felder hinzugefügt:
Feldname Feld-Alias Beschreibung d_start Start Date Startdatum und -zeit
d_start_s Start Date (string) Startdatum und -zeit als Zeichenfolge oder Text
d_end End Date Enddatum und -zeit
d_end_s End Date (string) Enddatum und -zeit als Zeichenfolge oder Text
distance_m Distance (meters) Entfernung in Metern
dt_sec Time Delta (seconds) Zeitunterschied in Sekunden
dt_min Time Delta (minutes) Zeitunterschied in Minuten
speed_mps Speed (meters per second) Optional. Geschwindigkeit in Meter pro Sekunde
speed_mph Speed (miles per hour) Optional. Geschwindigkeit in Meilen pro Stunde
speed_kph Speed (kilometers per hour) Optional. Geschwindigkeit in Kilometer pro Stunde
speed_knt Speed (knots) Optional. Geschwindigkeit in Knoten
oid_start Start ObjectID Objekt-ID des Startpunkts aus Eingabe-Punkt-Features
oid_end End ObjectID Objekt-ID des Endpunkts aus Eingabe-Punkt-Features
group_id Group Identification Optional. Gruppenfeld-Werte aus dem Parameter Eingabe-Features
Die folgenden Felder werden dem Parameter Ausgabesequenzpunkte hinzugefügt:
Feldname Feld-Alias Beschreibung sequence Sequence Number Sequenznummer des Punktes im Track
date Date Feld "Datum/Uhrzeit" aus dem Parameter Eingabe-Features
date_str Date (string) Datum/Uhrzeit als Zeichenfolge
oid_orig Original ObjectID Objekt-ID des ursprünglichen Features aus dem Parameter Eingabe-Features
group_id Group Identification Optional. Gruppenfeld-Werte aus dem Parameter Eingabe-Features
Für die Parameter Ausgabe-Feature-Class und Ausgabesequenzpunkte wird eine .lyrx-Ausgabedatei (Symbolisierungs- und Layer-Einstellungen) erstellt. Diese Dateien werden im nächsten Ordner-Workspace erstellt, der die Ausgabe-Features enthält.
Wenn der Parameter Geschwindigkeit einbeziehen aktiviert und der Parameter Fehler bei doppelten Zeitstempeln nicht aktiviert ist, werden alle doppelten Zeitstempel der Geschwindigkeitsmessungen des Ausgabe-Tracks auf "inf" gesetzt (für "unendlich"), und zwar unabhängig von der Entfernung zwischen den Punkten.
NULL-Werte im Wert des Parameters Gruppenfeld werden nicht bearbeitet. Da NULL-Werte bei der Verarbeitung der Eingabepunkte nicht sortiert und gruppiert werden können, werden diese Zeilen übersprungen. Um dieses Problem zu umgehen, werden NULL-Werte im Vorfeld durch das Werkzeug Data Engineering oder Feld berechnen in gültige Werte konvertiert.
Parameter
arcpy.intelligence.PointsToTrackSegments(in_features, date_field, out_feature_class, {group_field}, {include_velocity}, {out_point_feature_class}, {error_on_duplicate_timestamps}, {keep_input_fields})
Name | Erläuterung | Datentyp |
in_features | Die Punkt-Features als Punktpositionen entlang der zu erstellenden Tracks. | Feature Layer |
date_field | Das Datumsfeld, das zum Sortieren der in_features-Punkte verwendet wird. | Field |
out_feature_class | Die ausgegebenen Track-Linien-Features. | Feature Class |
group_field (optional) | Ein Feld aus dem Wert des Parameters in_features, das zum Gruppieren der Eingabepunkte verwendet wird. Für jede einzelne Gruppe wird ein eigener Track erstellt. | Field |
include_velocity (optional) | Gibt an, ob Geschwindigkeitsfelder (speed_mps, speed_mph, speed_kph und speed_knt) in den Wert des Parameters out_feature_class einbezogen werden sollen.
| Boolean |
out_point_feature_class (optional) | Die Ausgabe-Punkt-Features. Die Ausgabe enthält ein SEQUENCE-Feld zur Angabe der Reihenfolge, die für den mit dem Parameter out_feature_class erstellten Pfad verwendet wird. | Feature Class |
error_on_duplicate_timestamps (optional) | Gibt an, ob doppelte Zeitstempel im Wert des Parameters date_field bzw. in allen Gruppen im Wert des Parameters group_field zulässig sein oder einen Fehler bei der Ausführung des Werkzeugs auslösen sollen.
| Boolean |
keep_input_fields (optional) | Gibt an, ob Felder aus dem Wert des Parameters in_features in den Wert des Parameters out_point_feature_class übertragen werden sollen.
| Boolean |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion PointsToTrackSegments im unmittelbaren Modus verwendet wird:
import arcpy
arcpy.intelligence.PointsToTrackSegments("C:/data/mtracks.gdb/source_pts",
"DateTime",
"C:/data/mtracks.gdb/tracklines",
"Name",
"INCLUDE_VELOCITY",
"C:/data/mtracks.gdb/seqpoints")
Das folgende eigenständige Python-Skript veranschaulicht, wie die Funktion PointsToTrackSegments in einem eigenständigen Skript verwendet wird:
# Name: PointsToTrackSegments_Example2.py
# Description: Convert points to track segments.
# Import system modules
import arcpy
# Set local variables
in_features = "C:/data/mtracks.gdb/source_pts"
date_time = "DateTime"
out_feature_class = "C:/data/mtracks.gdb/tracklines"
group_field = "Name"
out_points = "C:/data/mtracks.gdb/seqpoints"
# Run PointsToTrackSegments
arcpy.intelligence.PointsToTrackSegments(in_features, date_time,
out_feature_class, group_field,
"INCLUDE_VELOCITY", out_points)