Routenobjekte transformieren (Linear Referencing Tools)

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.

Achtung:

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 (Punkt oder 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.

Beschriftung	Erläuterung	Datentyp
Eingabe-Objekttabelle	Die Eingabe-Objekttabelle.	Table View
Eigenschaften der Objekttabelle	Die Routenpositionsfelder und der Objekttyp in der Eingabe-Objekttabelle. Routenkennungsfeld: Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Objekte befinden. Bei diesem Feld kann es sich um ein numerisches Feld, ein Textfeld oder ein GUID-Feld handeln. Objekttyp: Der Objekttyp in der Eingabe-Objekttabelle (Punkt oder Linie). Punkt: Punktobjekte stellen eine exakte Position entlang einer Route dar. Es muss lediglich das Von-Messwert-Feld angegeben werden. Linie: Linienobjekte 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 Objekttyp Punkt oder Linie festgelegt wurde. Wenn als Wert für Objekttyp die Option Punkt 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 Objekttyp Linie 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. 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. Routenkennungsfeld: Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Objekte befinden. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein. Objekttyp: Der in der Ausgabe-Objekttabelle enthaltene Objekttyp (Punkt oder Linie). Punkt: Punktobjekte stellen eine exakte Position entlang einer Route dar. Es muss lediglich ein einzelnes Messwertfeld angegeben werden. Linie: Linienobjekte definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. Von-Messwert-Feld: Ein Feld mit Messwerten. Dieses Feld ist erforderlich, wenn als Objekttyp Punkt oder Linie festgelegt wurde. Wenn als Wert für Objekttyp die Option Punkt festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld. Bis-Messwert-Feld: Ein Feld mit Messwerten. Dieses Feld ist erforderlich, wenn als Objekttyp Linie festgelegt wurde.	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

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 identifier field—Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Objekte befinden. Bei diesem Feld kann es sich um ein numerisches Feld, ein Textfeld oder ein GUID-Feld handeln. Event type—Der Objekttyp in der Eingabe-Objekttabelle (`POINT` oder `LINE`). `POINT`—Punktobjekte stellen eine exakte Position entlang einer Route dar. Es muss lediglich das Von-Messwert-Feld angegeben werden. `LINE`—Linienobjekte definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. From-measure field—Ein Feld, das Messwerte enthält. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Objekttyp `POINT` oder `LINE` festgelegt wurde. To-measure field—Ein Feld, das Messwerte enthält. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Objekttyp `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. 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 identifier field—Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Objekte befinden. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein. Event type—Der in der Ausgabe-Objekttabelle enthaltene Objekttyp (`POINT` oder `LINE`). `POINT`—Punktobjekte stellen eine exakte Position entlang einer Route dar. Es muss lediglich ein einzelnes Messwertfeld angegeben werden. `LINE`—Linienobjekte definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. From-measure field—Ein Feld mit Messwerten. Dieses Feld ist erforderlich, wenn als Objekttyp `POINT` oder `LINE` festgelegt wurde. To-measure field—Ein Feld mit Messwerten. Dieses Feld ist erforderlich, wenn als Objekttyp `LINE` festgelegt wurde.	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

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja