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.
-
Der Ausgabe-Ereignistyp (POINT oder LINE) 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 in ArcMap angezeigt werden. Verwenden Sie hierfür das Werkzeug Routenereignis-Layer erstellen oder den Befehl "Routenereignisse anzeigen" in ArcMap.
Syntax
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})
Parameter | Erklärung | 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.
| 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.
| 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.
| 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)
TransformRouteEvents – Beispiel 4 (eigenständiges Skript)
Das folgende Beispiel veranschaulicht, wie die Funktion TransformRouteEvents in einem eigenständigen Python-Skript mit Personal-Geodatabase-Daten verwendet wird:
# Name: TransformRouteEvents_Example4.py
# Description: Transform point events (input table is in a personal geodatabase)
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/pitt.mdb"
# 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)
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja