Punkte in Track-Segmente (AllSource)

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:

    FeldnameFeld-AliasBeschreibung
    d_startStart Date

    Startdatum und -zeit

    d_start_sStart Date (string)

    Startdatum und -zeit als Zeichenfolge oder Text

    d_endEnd Date

    Enddatum und -zeit

    d_end_sEnd Date (string)

    Enddatum und -zeit als Zeichenfolge oder Text

    distance_mDistance (meters)

    Entfernung in Metern

    dt_secTime Delta (seconds)

    Zeitunterschied in Sekunden

    dt_minTime Delta (minutes)

    Zeitunterschied in Minuten

    speed_mpsSpeed (meters per second)

    Optional. Geschwindigkeit in Meter pro Sekunde

    speed_mphSpeed (miles per hour)

    Optional. Geschwindigkeit in Meilen pro Stunde

    speed_kphSpeed (kilometers per hour)

    Optional. Geschwindigkeit in Kilometer pro Stunde

    speed_kntSpeed (knots)

    Optional. Geschwindigkeit in Knoten

    oid_startStart ObjectID

    Objekt-ID des Startpunkts aus Eingabe-Punkt-Features

    oid_endEnd ObjectID

    Objekt-ID des Endpunkts aus Eingabe-Punkt-Features

    group_idGroup Identification

    Optional. Gruppenfeld-Werte aus dem Parameter Eingabe-Features

  • Die folgenden Felder werden dem Parameter Ausgabesequenzpunkte hinzugefügt:

    FeldnameFeld-AliasBeschreibung
    sequenceSequence Number

    Sequenznummer des Punktes im Track

    dateDate

    Feld "Datum/Uhrzeit" aus dem Parameter Eingabe-Features

    date_strDate (string)

    Datum/Uhrzeit als Zeichenfolge

    oid_origOriginal ObjectID

    Objekt-ID des ursprünglichen Features aus dem Parameter Eingabe-Features

    group_idGroup 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

BeschriftungErläuterungDatentyp
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})
NameErläuterungDatentyp
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_VELOCITYGeschwindigkeits-Ausgabefelder werden in der Ausgabe berücksichtigt. Dies ist die Standardeinstellung.
  • EXCLUDE_VELOCITYGeschwindigkeits-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_TIMESTAMPSDoppelte Zeitstempel lösen einen Fehler bei der Ausführung des Werkzeugs aus. Dies ist die Standardeinstellung.
  • ALLOW_DUPLICATE_TIMESTAMPSDoppelte 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_FIELDSFelder aus dem Wert des Parameters in_features werden in den Wert des Parameters out_point_feature_class übertragen.
  • DISCARD_INPUT_FIELDSFelder 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 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)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.