Punkte in Track-Segmente (AllSource Tools)

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-Features
`oid_end`	`End ObjectID`	Objekt-ID des Endpunkts aus Eingabe-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.

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. Aktiviert—Geschwindigkeits-Ausgabefelder werden in der Ausgabe berücksichtigt. Dies ist die Standardeinstellung. Deaktiviert—Geschwindigkeits-Ausgabefelder werden in der Ausgabe nicht berücksichtigt.	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. Aktiviert—Doppelte Zeitstempel lösen einen Fehler bei der Ausführung des Werkzeugs aus. Dies ist die Standardeinstellung. Deaktiviert—Doppelte Zeitstempel sind zulässig. Die Reihenfolge der doppelten Zeitstempel basiert auf dem Wert `ObjectID`.	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. Aktiviert—Felder aus dem Wert des Parameters Eingabe-Features werden in den Wert des Parameters Ausgabe-Sequenz-Punkte übertragen. Deaktiviert—Felder aus dem Wert des Parameters Eingabe-Features werden nicht in den Wert des Parameters Ausgabe-Sequenz-Punkte übertragen. Dies ist die Standardeinstellung.	Boolean

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. `INCLUDE_VELOCITY`—Geschwindigkeits-Ausgabefelder werden in der Ausgabe berücksichtigt. Dies ist die Standardeinstellung. `EXCLUDE_VELOCITY`—Geschwindigkeits-Ausgabefelder werden in der Ausgabe nicht berücksichtigt.	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. `ERROR_DUPLICATE_TIMESTAMPS`—Doppelte Zeitstempel lösen einen Fehler bei der Ausführung des Werkzeugs aus. Dies ist die Standardeinstellung. `ALLOW_DUPLICATE_TIMESTAMPS`—Doppelte Zeitstempel sind zulässig. Die Reihenfolge der doppelten Zeitstempel basiert auf dem Wert `ObjectID`.	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. `KEEP_INPUT_FIELDS`—Felder aus dem Wert des Parameters `in_features` werden in den Wert des Parameters `out_point_feature_class` übertragen. `DISCARD_INPUT_FIELDS`—Felder aus dem Wert des Parameters `in_features` werden nicht in den Wert des Parameters `out_point_feature_class` übertragen. Dies ist die Standardeinstellung.	Boolean

Codebeispiel

PointsToTrackSegments: Beispiel 1 (Python-Fenster)

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")

PointsToTrackSegments: Beispiel 2 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht die Verwendung der Funktion PointsToTrackSegments in einem eigenständigen Skript:

# 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)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzierungsinformationen