Routenereignisse transformieren (Linear Referencing)

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.

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. 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)

Umgebungen

Aktueller Workspace, Ausgabe-CONFIG-Schlüsselwort, Scratch-Workspace

Lizenzinformationen

• Basic: Ja
• Standard: Ja
• Advanced: Ja