Spurintervalle zu Feature (Tracking Analyst)
Zusammenfassung
Berechnet Werte, die basierend auf der Differenz zwischen aufeinander folgenden Features in einer Spur ermittelt werden. Der Eingabe-Feature-Class oder dem Layer werden neue Felder hinzugefügt, um die berechneten Werte (Entfernung, Dauer, Geschwindigkeit und Richtung) zu speichern.
Bild
Verwendung
-
Damit dieses Werkzeug funktioniert, muss die Eingabe-Feature-Class oder der Layer die Datums- und Zeitinformationen in nur einem Zeitfeld vom Datentyp Text, Short, Long, Float, Double oder Datum enthalten. Wenn der Datentyp des Zeitfeldes "Datum" ist, erkennt das Werkzeug das Format automatisch. Wenn der Datentyp des Zeitfeldes ein anderer ist als "Datum", ist ein Zeitfeldformat (und möglicherweise andere Informationen für den Zeitfeld-Datentyp "Text") erforderlich, um die Datenwerte ordnungsgemäß zu analysieren.
Wenn das ausgewählte Zeitfeld den Typ Text, Short, Long, Float oder Double aufweist, kann das Zeitfeldformat aus einer Liste von unterstützten Zeitfeldformaten ausgewählt werden. Sie können auch ein benutzerdefiniertes Zeitfeldformat definieren, um benutzerdefinierte Datums- und/oder Zeitwerte in einem Textfeld zu interpretieren. Weitere Informationen über benutzerdefinierte Formate für Textfelder finden Sie im Abschnitt Konvertieren von Zeichenfolgenwerten in das Datumsformat.
-
Die Auswahl der Namen von Ausgabefeldern ist optional. Wenn Sie keine Ausgabefeldnamen eingeben, generiert das Werkzeug automatisch Ausgabefeldnamen, die eine Abkürzung für die Einheiten enthalten.
Syntax
Parameter | Erläuterung | Datentyp |
in_features |
Die Eingabe-Feature-Class oder der Eingabe-Feature-Layer. | Feature Layer |
time_field |
Das Feld in der Eingabe-Feature-Class oder im Layer, das die Datums- und Zeitinformationen enthält. Dieses Werkzeug erfordert Datums- und Zeitinformationen im gleichen Feld; zudem muss der Datentyp des Feldes "Short", "Long", "Float", "Double", "Text" oder "Datum" sein. | Field |
track_id_field (optional) |
Dieses Feld enthält Datenwerte, die zum Gruppieren der Eingabe-Features in Spuren verwendet werden. Der Datentyp des Feldes kann "Short", "Long", "Float", "Double", "Text" oder "OID" sein. | Field |
calculation_method (optional) |
Gibt an, welches Intervall verwendet wird, um Werte für jedes Feature zu berechnen.
| String |
time_field_format (optional) | Wenn der Datentyp des Zeitfeldes ein anderer ist als "Datum", wird mit diesem Parameter das Format festgelegt, das zum Interpretieren der Datenwerte im Zeitfeld verwendet wird. Einige Beispiele für Formate sind:
Wenn der Datentyp des Zeitfeldes "Text" ist, kann entweder ein standardmäßiges Text-Zeitformat von Esri verwendet oder ein benutzerdefiniertes Format angegeben werden. Benutzerdefinierte Formate können jedoch nicht verwendet werden, wenn Sie als Speichermethode KEEP_ON_DISK angegeben haben. Wenn der Datentyp des Zeitfeldes numerisch ist (Short, Long, Float oder Double), können nur standardmäßige numerische Zeitformate von Esri verwendet werden. Wenn der Datentyp des Zeitfeldes "Datum" ist, wird dieser Parameter nicht benötigt. | String |
locale_id (optional) | Wenn der Datentyp des Zeitfeldes "Text" ist, wird mit diesem Parameter festgelegt, welches Gebietsschema zum Interpretieren der Datenwerte im Zeitfeld verwendet wird. Für alle anderen Zeitfeld-Datentypen außer "Text" wird dieser Parameter nicht benötigt. Wenn kein Gebietsschema eingegeben wird, wird das aktuelle Gebietsschema des Betriebssystems verwendet. Öffnen Sie das Werkzeugdialogfeld, und erweitern Sie die Dropdown-Liste, um eine Liste der verfügbaren Gebietsschemas anzuzeigen, die vom System unterstützt werden. Wenn das Gebietsschema als Parameter eingegeben wird, wird empfohlen, nur die von Microsoft zugewiesene Gebietsschema-ID (LCID) zu verwenden, die als Long Integer (z. B. 1033) eingegeben werden kann. Sie können auch die vollständige Zeichenfolgendarstellung des Gebietsschemas als Parameter eingeben, z. B. "01033-English_(United_States)", aber Sie müssen dabei die Leerzeichen durch Unterstriche ersetzen. | Long |
am_designator (optional) |
Wenn der Zeitfelddatentyp "Text" ist und die Zeit im 12-Stunden-Format angegeben wird, einschließlich eines Zeitmarkers ("t" oder "tt"), bestimmt dieser Parameter das Zeichen ("t") oder die Zeichen ("tt"), die für "AM" in den Zeitfeld-Datenwerten stehen. Wenn nichts eingegeben wird, dann wird der Standard-AM-Bezeichner für das ausgewählte Gebietsschema verwendet. Für alle anderen Zeitfeld-Datentypen außer "Text" wird dieser Parameter nicht benötigt. | String |
pm_designator (optional) |
Wenn der Zeitfelddatentyp "Text" ist und die Zeit im 12-Stunden-Format angegeben wird, einschließlich eines Zeitmarkers ("t" oder "tt"), bestimmt dieser Parameter das Zeichen ("t") oder die Zeichen ("tt"), die für "PM" in den Zeitfeld-Datenwerten stehen. Wenn nichts eingegeben wird, dann wird der Standard-PM-Bezeichner für das ausgewählte Gebietsschema verwendet. Für alle anderen Zeitfeld-Datentypen außer "Text" wird dieser Parameter nicht benötigt. | String |
distance_field_units (optional) |
Gibt die Entfernungseinheiten an, die im Feld für die Ausgabeentfernung verwendet werden.
| String |
distance_field_name (optional) |
Gibt den Namen des Entfernungsfeldes an, das der Eingabe-Feature-Class oder dem Layer hinzugefügt wird. Wenn kein Feldname angegeben wird, wird automatisch ein Name ausgewählt. | String |
duration_field_units (optional) | Gibt die Zeiteinheiten an, die im Feld für die Ausgabedauer verwendet werden.
| String |
duration_field_name (optional) |
Gibt den Namen des Dauerfeldes an, das der Eingabe-Feature-Class oder dem Layer hinzugefügt wird. Wenn kein Feldname angegeben wird, wird automatisch ein Name ausgewählt. | String |
speed_field_units (optional) | Gibt die Geschwindigkeitseinheiten an, die im Feld für die Ausgabegeschwindigkeit verwendet werden.
| String |
speed_field_name (optional) | Gibt den Namen des Geschwindigkeitsfeldes an, das der Eingabe-Feature-Class oder dem Layer hinzugefügt wird. Wenn kein Feldname angegeben wird, wird automatisch ein Name ausgewählt. | String |
course_field_units (optional) |
Gibt die Richtungseinheiten an, die im Feld für die Ausgaberichtung verwendet werden.
| String |
course_field_name (optional) |
Gibt den Namen des Richtungsfeldes an, das der Eingabe-Feature-Class oder dem Layer hinzugefügt wird. Wenn kein Feldname angegeben wird, wird automatisch ein Name ausgewählt. | String |
Codebeispiel
In diesem Beispiel wird gezeigt, wie Sie das Werkzeug auf eine Feature-Class mit einem Datumsfeld anwenden, wenn die Standardeinheiten und die Standardausgabefeldnamen verwendet werden.
import arcpy
arcpy.CheckOutExtension("tracking")
in_features = "C:\Data\Vehicles.gdb\Planes"
time_field = "DATE_TIME"
track_id_field = "ACID"
arcpy.TrackIntervalsToFeature_ta(in_features, time_field, track_id_field)
In diesem Beispiel wird gezeigt, wie Sie das Werkzeug auf eine Feature-Class mit einem Datumsfeld vom Datentyp "Text" anwenden und benutzerdefinierte Einheiten sowie Feldnamen angeben.
import arcpy
arcpy.CheckOutExtension("tracking")
in_features = "C:\Data\Vehicles.gdb\Planes"
time_field = "DATE_TEXT"
track_id_field = "ACID"
calculation_method = "CURRENT_AND_NEXT_FEATURE"
time_field_format = "MM/dd/yyyy HH:mm:ss"
distance_field_units = "MILES"
distance_field_name = "DISTANCE"
duration_field_units = "SECONDS"
duration_field_name = "DURATION"
speed_field_units = "KILOMETERS_PER_HOUR"
speed_field_name = "SPEED"
course_field_units = "DEGREES"
course_field_name = "HEADING"
arcpy.TrackIntervalsToFeature_ta(in_features, time_field, track_id_field, calculation_method, time_field_format, "", "", "", distance_field_units, distance_field_name, duration_field_units, duration_field_name, speed_field_units, speed_field_name, course_field_units, course_field_name)