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

BeschriftungErläuterungDatentyp
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})
NameErläuterungDatentyp
in_table

Die Eingabe-Objekttabelle.

Table View
in_event_properties

Die Routenpositionsfelder und der Objekttyp in der Eingabe-Objekttabelle.

  • Routen-Kennungsfeld: 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 (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.
  • Von-Messwert-Feld: Enthält Messwerte. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Objekttyp POINT oder LINE festgelegt wurde.
  • Bis-Messwert-Feld: Enthält Messwerte. 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.

  • Routen-Kennungsfeld: 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: Die Art der Objekte in der Ausgabe-Objekttabelle (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.
  • Von-Messwert-Feld: Enthält Messwerte. Dieses Feld ist erforderlich, wenn als Objekttyp POINT oder LINE festgelegt wurde.
  • Bis-Messwert-Feld: Enthält Messwerte. 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.

  • FIELDSDer Parameterwert out_table enthält die Routenpositionsfelder sowie alle Attribute aus den Eingabeobjekten. Dies ist die Standardeinstellung.
  • NO_FIELDSDer 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)

Lizenzinformationen

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

Verwandte Themen