Routenobjekte transformieren (Linear Referencing)

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

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Objekttabelle	Die Eingabe-Objekttabelle.	Table View
Eigenschaften der Objekttabelle	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 Typ der Ereignisse in der Ausgabeereignistabelle (POINT oder LINE). POINT: Punktereignisse stellen eine exakte Position entlang einer Route dar. 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: Ein Feld mit Messwerten. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Ereignistyp POINT oder LINE festgelegt wurde. Beachten Sie Folgendes: Wenn als Ereignistyp die Option POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld. Bis-Messwert-Feld: Ein Feld mit Messwerten. 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-Objekte transformiert werden.	Feature Layer
Kennungsfeld der Ziel-Route	Die in diesem Feld gespeicherten Werte kennzeichnen die einzelnen Zielrouten eindeutig.	Field
Ausgabe-Objekttabelle	Die zu erstellende Tabelle.	Table
Eigenschaften der Ausgabe-Objekttabelle	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: Der Typ der Ereignisse in der Ausgabeereignistabelle (POINT oder LINE). POINT: Punktereignisse stellen eine exakte Position entlang einer Route dar. Es muss lediglich ein einzelnes Messwertfeld angegeben werden. LINE: Linienereignisse definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. Von-Messwert-Feld: Ein Feld mit Messwerten. Erforderlich, wenn der Ereignistyp POINT oder LINE ist. Beachten Sie Folgendes: Wenn als Ereignistyp die Option POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld. Bis-Messwert-Feld: Ein Feld mit Messwerten. Erforderlich, wenn der Ereignistyp LINE ist.	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. Aktiviert: Der Parameterwert Ausgabe-Objekttabelle enthält die Routenpositionsfelder sowie alle Attribute aus den Eingabeobjekten. Dies ist die Standardeinstellung. Deaktiviert: Der Parameterwert Ausgabe-Objekttabelle enthält nur die Routenpositionsfelder sowie das Feld ObjectID aus den Eingabeobjekten.	Boolean

Python

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	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 Typ der Ereignisse in der Ausgabeereignistabelle (POINT oder LINE). POINT: Punktereignisse stellen eine exakte Position entlang einer Route dar. 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: Ein Feld mit Messwerten. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Ereignistyp POINT oder LINE festgelegt wurde. Beachten Sie Folgendes: Wenn als Ereignistyp die Option POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld. Bis-Messwert-Feld: Ein Feld mit Messwerten. 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-Objekte 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: Der Typ der Ereignisse in der Ausgabeereignistabelle (POINT oder LINE). POINT: Punktereignisse stellen eine exakte Position entlang einer Route dar. Es muss lediglich ein einzelnes Messwertfeld angegeben werden. LINE: Linienereignisse definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. Von-Messwert-Feld: Ein Feld mit Messwerten. Erforderlich, wenn der Ereignistyp POINT oder LINE ist. Beachten Sie Folgendes: Wenn als Ereignistyp die Option POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld. Bis-Messwert-Feld: Ein Feld mit Messwerten. Erforderlich, wenn der Ereignistyp LINE ist.	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. FIELDS—Der Parameterwert out_table enthält die Routenpositionsfelder sowie alle Attribute aus den Eingabeobjekten. Dies ist die Standardeinstellung. NO_FIELDS—Der Parameterwert out_table enthält nur die Routenpositionsfelder sowie das Feld ObjectID aus den Eingabeobjekten.	Boolean

Codebeispiel

TransformRouteEvents – Beispiel 1 (Python-Fenster)

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

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"  

# Run TransformRouteEvents
arcpy.lr.TransformRouteEvents(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"  

# Run TransformRouteEvents
arcpy.lr.TransformRouteEvents(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