Punkte in Track-Segmente (AllSource)

Zusammenfassung

Konvertiert Sequenzen mit aktivierten Zeiteigenschaften von Eingabepunktdaten, beispielsweise GPS-Punkte, in Ausgabepfade.

Verwendung

  • Wenn sich die Parameterwerte Eingabe-Features in einem projizierten Koordinatensystem befinden, verwendet der Parameterwert 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 das Koordinatensystem "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 Punkte 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.

  • Die folgenden Felder werden dem Wert des Parameters Ausgabe-Feature-Class 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 Startpunktes aus Eingabe-Features

    oid_endEnd ObjectID

    Objekt-ID des Endpunktes aus Eingabe-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)

    Feld "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 Workspace des nächstgelegenen Ordners 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 Parameter 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 eingeschlossen werden.

  • Aktiviert: Geschwindigkeits-Ausgabefelder werden in die Ausgabe eingeschlossen. Dies ist die Standardeinstellung.
  • Deaktiviert: Geschwindigkeits-Ausgabefelder werden nicht in die Ausgabe eingeschlossen.
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 führen zu einem Werkzeugfehler. Dies ist die Standardeinstellung.
  • Deaktiviert: Doppelte Zeitstempel werden akzeptiert. 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 Ausgabesequenzpunkte übertragen werden.

  • Aktiviert: Felder werden aus dem Wert des Parameters Eingabe-Features in den Wert des Parameters Ausgabesequenzpunkte übertragen.
  • Deaktiviert: Felder werden nicht aus dem Wert des Parameters Eingabe-Features in den Wert des Parameters Ausgabesequenzpunkte ü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 Parameter 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 Geschwindigkeits-Ausgabefelder (speed_mps, speed_mph, speed_kph und speed_knt) in den Wert des Parameters out_feature_class eingeschlossen werden.

  • INCLUDE_VELOCITYGeschwindigkeits-Ausgabefelder werden in die Ausgabe eingeschlossen. Dies ist die Standardeinstellung.
  • EXCLUDE_VELOCITYGeschwindigkeits-Ausgabefelder werden nicht in die Ausgabe eingeschlossen.
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 führen zu einem Werkzeugfehler. Dies ist die Standardeinstellung.
  • ALLOW_DUPLICATE_TIMESTAMPSDoppelte Zeitstempel werden akzeptiert. 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.

  • KEEP_INPUT_FIELDSFelder werden aus dem Wert des Parameters in_features 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 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.