Beschriftung | Erläuterung | Datentyp |
Eingabe-Objekttabelle | Die Eingabe-Objekttabelle. | Table View |
Eigenschaften der Objekttabelle | Die Routenpositionsfelder und der Objekttyp in der Eingabe-Objekttabelle.
| 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. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein. | Field |
Features der Ziel-Route | Das Routen-Feature, in das die Eingabe-Objekte transformiert werden. | Feature Layer |
Kennungsfeld der Ziel-Route | Die in diesem Feld gespeicherten Werte kennzeichnen die einzelnen Zielrouten eindeutig. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein. | Field |
Ausgabe-Objekttabelle | Die Tabelle, die erstellt wird. | Table |
Eigenschaften der Ausgabe-Objekttabelle | Die Routenpositionsfelder und der in die Ausgabe-Objekttabelle zu schreibende Objekttyp.
| Route Measure Event Properties |
Cluster-Toleranz | Die maximal zulässige Entfernung zwischen den Eingabe-Objekten und den Zielrouten. | Linear Unit |
Alle Felder der Eingabe einbeziehen (optional) | Gibt an, ob der Parameterwert Ausgabe-Objekttabelle die Routenpositionsfelder sowie alle Attribute aus den Eingabeobjekten enthält.
| Boolean |
Zusammenfassung
Transformiert die Messwerte von Objekten aus einer Routenreferenz in einer andere und schreibt sie in eine neue Objekttabelle.
Verwendung
Sie können Objekte transformieren und dadurch die Objekte einer Routenreferenz auch für andere Routenreferenzen verwenden, die über andere Routenkennungen und/oder Routenmesswerte verfügen.
Alle Gesamt- oder Teilobjekte, die eine Zielroute überschneiden, werden in die neue Objekttabelle 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 Objekttyp (Punktoder Linie) muss mit dem Eingabe-Objekttyp übereinstimmen.
Um die Anzahl der zu verarbeitenden Objekte effektiv zu reduzieren, nutzen Sie das Werkzeug Tabellensicht erstellen, bevor Sie dieses Werkzeug verwenden.
-
Die Ausgabe-Tabelle kann mit dem Werkzeug Routenobjekt-Layer erstellen in einer Karte angezeigt werden.
Parameter
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-Objekttabelle. | Table View |
in_event_properties | Die Routenpositionsfelder und der Objekttyp in der Eingabe-Objekttabelle.
| 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. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein. | Field |
target_routes | Das Routen-Feature, in das die Eingabe-Objekte transformiert werden. | Feature Layer |
target_route_id_field | Die in diesem Feld gespeicherten Werte kennzeichnen die einzelnen Zielrouten eindeutig. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein. | Field |
out_table | Die Tabelle, die erstellt wird. | Table |
out_event_properties | Die Routenpositionsfelder und der in die Ausgabe-Objekttabelle zu schreibende Objekttyp.
| Route Measure Event Properties |
cluster_tolerance | Die maximal zulässige Entfernung zwischen den Eingabe-Objekten und den Zielrouten. | Linear Unit |
in_fields (optional) | Gibt an, ob der Parameterwert out_table die Routenpositionsfelder sowie alle Attribute aus den Eingabeobjekten enthält.
| Boolean |
Codebeispiel
Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion TransformRouteEvents verwenden:
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.TransformRouteEvents("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")
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"
# Run TransformRouteEvents
arcpy.lr.TransformRouteEvents(in_tbl, in_props, in_rt, in_rid, target_rt,
target_rid, out_tbl, out_props, tol)
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"
# Run TransformRouteEvents
arcpy.lr.TransformRouteEvents(in_tbl, in_props, in_rt, in_rid, target_rt,
target_rid, out_tbl, out_props, tol)
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja