Routenereignisse transformieren (Linear Referencing)—ArcGIS Pro

Zusammenfassung

Transformiert die Messwerte von Ereignissen aus einer Routenreferenz in einer andere und schreibt sie in eine neue Ereignistabelle.

Verwendung

Sie können Ereignisse transformieren und dadurch die Ereignisse einer Routenreferenz auch für andere Routenreferenzen verwenden, die über andere Routenkennungen und/oder Routenmesswerte verfügen.
Alle Gesamt- oder Teilereignisse, die eine Zielroute überschneiden, werden in die neue Ereignistabelle geschrieben.
Die besten Ergebnisse werden erzielt, wenn sich die Quell- und die Zielrouten eng überlagern.
Vorsicht:
Die Verwendung eines großen Cluster-Toleranz-Parameterwerts, um Diskrepanzen zwischen den Quell- und Zielrouten zu vermeiden, kann zu unerwarteten Ergebnissen führen.
Der Wert für Ereignistyp (Punktoder Linie) muss mit dem Eingabe-Ereignistyp übereinstimmen.
Um die Anzahl der zu verarbeitenden Ereignisse effektiv zu reduzieren, nutzen Sie das Werkzeug Tabellensicht erstellen, bevor Sie dieses Werkzeug verwenden.
Die Ausgabe-Tabelle kann mit dem Werkzeug Routenereignis-Layer erstellen in einer Karte angezeigt werden.

Parameter

Beschriftung	Erläuterung	Datentyp
Eingabe-Ereignistabelle	Die Eingabe-Ereignistabelle.	Table View
Eigenschaften der Ereignistabelle	Der Parameter, der sich aus den Routenpositionsfeldern und dem in der Eingabeereignistabelle festgelegten Ereignistyp zusammensetzt. Routenkennungsfeld: Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Ereignisse befinden. Bei diesem Feld kann es sich um ein Zahlen- oder Zeichenfeld handeln. Ereignistyp: Der Typ der Ereignisse in der Ausgabeereignistabelle (POINT oder LINE). POINT: Punktereignisse stellen eine exakte Position entlang einer Route dar. Es muss lediglich das Von-Messwert-Feld angegeben werden. LINE: Linienereignisse definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. Von-Messwert-Feld: Ein Feld mit Messwerten. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Ereignistyp POINT oder LINE festgelegt wurde. Beachten Sie Folgendes: Wenn als Ereignistyp die Option POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld. Bis-Messwert-Feld: Ein Feld mit Messwerten. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Ereignistyp LINE festgelegt wurde.	Route Measure Event Properties
Features der Quell-Route	Die Eingabe-Routen-Features.	Feature Layer
Kennungsfeld der Quell-Route	Die in diesem Feld gespeicherten Werte kennzeichnen die einzelnen Eingaberouten eindeutig.	Field
Features der Ziel-Route	Das Routen-Feature, in das die Eingabe-Ereignisse transformiert werden.	Feature Layer
Kennungsfeld der Ziel-Route	Die in diesem Feld gespeicherten Werte kennzeichnen die einzelnen Zielrouten eindeutig.	Field
Ausgabe-Ereignistabelle	Die zu erstellende Tabelle.	Table
Eigenschaften der Ausgabe-Ereignistabelle	Parameter, der sich aus den Routenpositionsfeldern und dem in die Ausgabeereignistabelle zu schreibenden Ereignistyp zusammensetzt. Routenkennungsfeld: Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Ereignisse befinden. Ereignistyp: Der Typ der Ereignisse in der Ausgabeereignistabelle (POINT oder LINE). POINT: Punktereignisse stellen eine exakte Position entlang einer Route dar. Es muss lediglich ein einzelnes Messwertfeld angegeben werden. LINE: Linienereignisse definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. Von-Messwert-Feld: Ein Feld mit Messwerten. Erforderlich, wenn der Ereignistyp POINT oder LINE ist. Beachten Sie Folgendes: Wenn als Ereignistyp die Option POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld. Bis-Messwert-Feld: Ein Feld mit Messwerten. Erforderlich, wenn der Ereignistyp LINE ist.	Route Measure Event Properties
Cluster-Toleranz	Die maximal zulässige Entfernung zwischen den Eingabe-Ereignissen und den Zielrouten.	Linear Unit
Alle Felder der Eingabe einbeziehen (optional)	Gibt an, ob der Parameterwert Ausgabe-Ereignistabelle die Routenpositionsfelder sowie alle Attribute aus den Eingabeereignissen enthält. Aktiviert: Der Parameterwert Ausgabe-Ereignistabelle enthält die Routenpositionsfelder sowie alle Attribute aus den Eingabeereignissen. Dies ist die Standardeinstellung. Deaktiviert: Der Parameterwert Ausgabe-Ereignistabelle enthält nur die Routenpositionsfelder sowie das Feld ObjectID aus den Eingabeereignissen.	Boolean

arcpy.lr.TransformRouteEvents(in_table, in_event_properties, in_routes, route_id_field, target_routes, target_route_id_field, out_table, out_event_properties, cluster_tolerance, {in_fields})

Name	Erläuterung	Datentyp
in_table	Die Eingabe-Ereignistabelle.	Table View
in_event_properties	Der Parameter, der sich aus den Routenpositionsfeldern und dem in der Eingabeereignistabelle festgelegten Ereignistyp zusammensetzt. Routenkennungsfeld: Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Ereignisse befinden. Bei diesem Feld kann es sich um ein Zahlen- oder Zeichenfeld handeln. Ereignistyp: Der Typ der Ereignisse in der Ausgabeereignistabelle (POINT oder LINE). POINT: Punktereignisse stellen eine exakte Position entlang einer Route dar. Es muss lediglich das Von-Messwert-Feld angegeben werden. LINE: Linienereignisse definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. Von-Messwert-Feld: Ein Feld mit Messwerten. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Ereignistyp POINT oder LINE festgelegt wurde. Beachten Sie Folgendes: Wenn als Ereignistyp die Option POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld. Bis-Messwert-Feld: Ein Feld mit Messwerten. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Ereignistyp LINE festgelegt wurde.	Route Measure Event Properties
in_routes	Die Eingabe-Routen-Features.	Feature Layer
route_id_field	Die in diesem Feld gespeicherten Werte kennzeichnen die einzelnen Eingaberouten eindeutig.	Field
target_routes	Das Routen-Feature, in das die Eingabe-Ereignisse transformiert werden.	Feature Layer
target_route_id_field	Die in diesem Feld gespeicherten Werte kennzeichnen die einzelnen Zielrouten eindeutig.	Field
out_table	Die zu erstellende Tabelle.	Table
out_event_properties	Parameter, der sich aus den Routenpositionsfeldern und dem in die Ausgabeereignistabelle zu schreibenden Ereignistyp zusammensetzt. Routenkennungsfeld: Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Ereignisse befinden. Ereignistyp: Der Typ der Ereignisse in der Ausgabeereignistabelle (POINT oder LINE). POINT: Punktereignisse stellen eine exakte Position entlang einer Route dar. Es muss lediglich ein einzelnes Messwertfeld angegeben werden. LINE: Linienereignisse definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. Von-Messwert-Feld: Ein Feld mit Messwerten. Erforderlich, wenn der Ereignistyp POINT oder LINE ist. Beachten Sie Folgendes: Wenn als Ereignistyp die Option POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld. Bis-Messwert-Feld: Ein Feld mit Messwerten. Erforderlich, wenn der Ereignistyp LINE ist.	Route Measure Event Properties
cluster_tolerance	Die maximal zulässige Entfernung zwischen den Eingabe-Ereignissen und den Zielrouten.	Linear Unit
in_fields (optional)	Gibt an, ob der Parameterwert out_table die Routenpositionsfelder sowie alle Attribute aus den Eingabeereignissen enthält. FIELDS—Der Parameterwert out_table enthält die Routenpositionsfelder sowie alle Attribute aus den Eingabeereignissen. Dies ist die Standardeinstellung. NO_FIELDS—Der Parameterwert out_table enthält nur die Routenpositionsfelder sowie das Feld ObjectID aus den Eingabeereignissen.	Boolean

Codebeispiel

TransformRouteEvents – Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion TransformRouteEvents verwenden:

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.TransformRouteEvents_lr("pavement.dbf", "route1 LINE begin_mp end_mp", 
                              "hwy.shp", "route1", "hwy_new.shp", "route1", 
                              "trans_out1.dbf", "route1 LINE fmp tmp", "0.1 meters")

TransformRouteEvents – Beispiel 2 (eigenständiges Skript)

Das folgende Beispiel veranschaulicht, wie die Funktion TransformRouteEvents in einem eigenständigen Python-Skript mit File-Geodatabase-Daten verwendet wird:

# Name: TransformRouteEvents_Example2.py
# Description: Transform point events (input table is in a file geodatabase)

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"

# Set local variables
in_tbl = "accident"
in_props = "route1 POINT measure"
in_rt = "roads/hwy"               # hwy exists in the roads feature dataset 
in_rid = "route1" 
target_rt = "roads/hwy_new"       # hwy_new exists in the roads feature dataset 
target_rid = "route1" 
out_tbl = "trans_out2"
out_props = "route1 POINT mp"
tol = "0.1 meters"  

# Execute TransformRouteEvents
arcpy.TransformRouteEvents_lr(in_tbl, in_props, in_rt, in_rid, target_rt, 
                              target_rid, out_tbl, out_props, tol)

TransformRouteEvents – Beispiel 3 (eigenständiges Skript)

Das folgende Beispiel veranschaulicht, wie die Funktion TransformRouteEvents in einem eigenständigen Python-Skript mit Enterprise-Geodatabase-Daten verwendet wird:

# Name: TransformRouteEvents_Example3.py
# Description: Transform point events (input table is in an enterprise geodatabase)

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"

# Set local variables
in_tbl = arcpy.ValidateTableName("accident", wkspc) 
in_props = "route1 POINT measure"
in_rt = arcpy.ValidateTableName("hwy", wkspc) 
in_rid = "route1" 
target_rt = arcpy.ValidateTableName("hwy_new", wkspc) 
target_rid = "route1" 
out_tbl = "trans_out3"
out_props = "route1 POINT mp"
tol = "0.1 meters"  

# Execute TransformRouteEvents
arcpy.TransformRouteEvents_lr(in_tbl, in_props, in_rt, in_rid, target_rt, 
                              target_rid, out_tbl, out_props, tol)

Zusammenfassung

Verwendung

Vorsicht:

Parameter

Codebeispiel

Umgebungen

Sonderfälle

Lizenzinformationen

Verwandte Themen

In diesem Thema