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 einer großen Cluster-Toleranz, um Diskrepanzen zwischen den Quell- und Zielrouten zu vermeiden, kann zu unerwarteten Ergebnissen führen.
Der Ausgabe-Ereignistyp (Punkt oder 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 Ereignistyp in der Eingabeereignistabelle (POINT oder LINE). POINT – Punktereignisse bezeichnen eine exakte Position entlang einer Route. 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 – Enthält Messwerte. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Ereignistyp POINT oder LINE festgelegt wurde. Beachten Sie Folgendes: Wenn als Ereignistyp POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in "Messwertfeld". Bis-Messwert-Feld – Enthält Messwerte. 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 – Die Art der Ereignisse in der Ausgabeereignistabelle (POINT oder LINE). POINT – Punktereignisse bezeichnen eine exakte Position entlang einer Route. Es muss nur ein einziges Messwertfeld angegeben werden. LINE – Linienereignisse definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. Von-Messwert-Feld – Enthält Messwerte. Dieses Feld ist erforderlich, wenn als Ereignistyp POINT oder LINE angegeben wird. Beachten Sie Folgendes: Wenn als Ereignistyp POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in "Messwertfeld". Bis-Messwert-Feld – Enthält Messwerte. Dieses Feld ist erforderlich, wenn als Ereignistyp LINE angegeben wird.	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 die Ausgabe-Ereignistabelle die Routenpositionsfelder sowie alle Attribute aus den Eingabe-Ereignissen enthält. Aktiviert: Die Ausgabeereignistabelle enthält die Routenpositionsfelder sowie alle Attribute aus den Eingabeereignissen. Dies ist die Standardeinstellung. Deaktiviert: Die Ausgabe-Ereignistabelle enthält nur die Routenpositionsfelder sowie das ObjectID-Feld aus den Eingabe-Ereignissen.	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 Ereignistyp in der Eingabeereignistabelle (POINT oder LINE). POINT – Punktereignisse bezeichnen eine exakte Position entlang einer Route. 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 – Enthält Messwerte. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Ereignistyp POINT oder LINE festgelegt wurde. Beachten Sie Folgendes: Wenn als Ereignistyp POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in "Messwertfeld". Bis-Messwert-Feld – Enthält Messwerte. 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 – Die Art der Ereignisse in der Ausgabeereignistabelle (POINT oder LINE). POINT – Punktereignisse bezeichnen eine exakte Position entlang einer Route. Es muss nur ein einziges Messwertfeld angegeben werden. LINE – Linienereignisse definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. Von-Messwert-Feld – Enthält Messwerte. Dieses Feld ist erforderlich, wenn als Ereignistyp POINT oder LINE angegeben wird. Beachten Sie Folgendes: Wenn als Ereignistyp POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in "Messwertfeld". Bis-Messwert-Feld – Enthält Messwerte. Dieses Feld ist erforderlich, wenn als Ereignistyp LINE angegeben wird.	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 die Ausgabe-Ereignistabelle die Routenpositionsfelder sowie alle Attribute aus den Eingabe-Ereignissen enthält. FIELDS—Die Ausgabeereignistabelle enthält die Routenpositionsfelder sowie alle Attribute aus den Eingabeereignissen. Dies ist die Standardeinstellung. NO_FIELDS—Die Ausgabe-Ereignistabelle enthält nur die Routenpositionsfelder sowie das ObjectID-Feld aus den Eingabe-Ereignissen.	Boolean

Codebeispiel

TransformRouteEvents – Beispiel 1 (Python-Fenster)
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