Zusammenfassung
Dieses Werkzeug dient zum Transformieren der Messwerte von Ereignissen zwischen zwei Routenreferenzen und Schreiben der Werte 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. Nutzen Sie hierfür das Werkzeug Routenereignis-Layer erstellen oder den Befehl "Routenereignisse anzeigen" in ArcMap.
Syntax
TransformRouteEvents_lr (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 | 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.
| 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 (Python-Fenster)
import arcpy
from arcpy import env
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 Python-Skript)
Das folgende Python-Skript 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
from arcpy import env
# Set workspace
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 Python-Skript)
Das folgende Python-Skript veranschaulicht, wie die Funktion "TransformRouteEvents" in einem eigenständigen Python-Skript mit Personal-Geodatabase-Daten verwendet wird:
# Name: TransformRouteEvents_Example3.py
# Description: Transform point events (input table is in a personal geodatabase)
# Import system modules
import arcpy
from arcpy import env
# Set workspace
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)
TransformRouteEvents – Beispiel 4 (Eigenständiges Python-Skript)
Das folgende Python-Skript veranschaulicht, wie die Funktion "TransformRouteEvents" in einem eigenständigen Python-Skript mit ArcSDE-Daten verwendet wird:
# Name: TransformRouteEvents_Example4.py
# Description: Transform point events (input table is in an enterprise geodatabase)
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "Database Connections/Connection to Jerry.sde"
# Set local variables
in_tbl = gp.QualifyTableName("accident", wkspc)
in_props = "route1 POINT measure"
in_rt = gp.QualifyTableName("hwy", wkspc)
in_rid = "route1"
target_rt = gp.QualifyTableName("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)
Umgebungen
Lizenzinformationen
- ArcGIS Desktop Basic: Ja
- ArcGIS Desktop Standard: Ja
- ArcGIS Desktop Advanced: Ja