Routenereignis-Layer erstellen (Linear Referencing)

Zusammenfassung

Erstellt einen temporären Feature-Layer anhand von Routen und Routenereignissen.

Wenn der temporäre Layer verwendet wird (auf einer Karte angezeigt oder von einem anderen Geoverarbeitungswerkzeug verwendet), wird eine dynamische Segmentierung durchgeführt.

Verwendung

  • Als Eingabetabelle können alle von ArcGIS unterstützten Tabellentypen verwendet werden.

  • Verwenden Sie vor diesem Werkzeug das Werkzeug Feature-Layer erstellen für die Routen und/oder das Werkzeug Tabellensicht erstellen für die Ereignisse, um die Anzahl an Routen und Ereignissen, die verarbeitet werden, zu reduzieren.

  • Nicht alle Tabellentypen haben ein ObjectID-Feld. Wenn dieses Werkzeug solche Tabellen verwendet, ist der resultierende Layer nicht auswählbar und kann in bestimmten Geoverarbeitungsvorgängen nicht effektiv ausgewählt werden. Sie können das Werkzeug Abfragetabelle erstellen vor diesem Werkzeug verwenden, um ein virtuelles ObjectID-Feld hinzuzufügen.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Routen-Features

Die Routen-Features, anhand derer Ereignisse verortet werden.

Feature Layer
Routen-Kennungsfeld

Mit den in diesem Feld gespeicherten Werten werden die einzelnen Routen eindeutig gekennzeichnet.

Field
Eingabe-Ereignistabelle

Die Tabelle, deren Zeilen entlang bestimmter Routen verortet werden.

Table View
Eigenschaften der Ereignistabelle

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
Layer-Name oder Tabellensicht

Der zu erstellende Layer. Dieser Layer wird im Arbeitsspeicher abgelegt, sodass kein Pfand erforderlich ist.

Feature Layer
Versatzfeld
(optional)

Das Feld, das die Werte enthält, die verwendet werden, um Ereignisse von der ihnen zugrunde liegenden Route zu versetzen. Dieses Feld muss numerisch sein.

Field
Feld zur Aufnahme von Fehlern erstellen
(optional)

Gibt an, ob dem erstellten temporären Layer ein Feld namens LOC_ERROR hinzugefügt wird.

  • Deaktiviert: Es wird kein Feld zum Speichern von Verortungsfehlern hinzugefügt. Dies ist die Standardeinstellung.
  • Aktiviert: Es wird ein Feld zum Speichern von Verortungsfehlern hinzugefügt.
Boolean
Ein Winkelfeld erstellen
(optional)

Gibt an, ob dem erstellten temporären Layer ein Feld namens LOC_ANGLE hinzugefügt wird. Dieser Parameter ist nur gültig, wenn der Ereignistyp PUNKT lautet.

  • Deaktiviert: Es wird kein Feld zum Speichern von Verortungswinkeln hinzugefügt. Dies ist die Standardeinstellung.
  • Aktiviert: Es wird ein Feld zum Speichern von Verortungswinkeln hinzugefügt.
Boolean
Berechneter Winkeltyp
(optional)

Gibt den Typ des zu berechnenden Verortungswinkels an. Dieser Parameter ist nur gültig, wenn Ein Winkelfeld erstellen aktiviert ist.

  • NormalDer normale (rechte) Winkel wird berechnet. Dies ist die Standardeinstellung.
  • TangenteDer Tangentenwinkel wird berechnet.
String
Das Komplement des Winkels in ein Winkelfeld schreiben
(optional)

Gibt an, ob das Komplement des Verortungswinkels berechnet wird. Dieser Parameter ist nur gültig, wenn Ein Winkelfeld erstellen aktiviert ist.

  • Deaktiviert: Es wird kein Komplement des Winkels in das Feld geschrieben. Es wird nur der berechnete Winkel in das Feld geschrieben. Dies ist die Standardeinstellung.
  • Aktiviert: Es wird das Komplement des Winkels in das Feld geschrieben.
Boolean
Ereignisse mit einem positiven Versatz werden rechts der Route platziert
(optional)

Gibt an, auf welcher Seite die Routenereignisse mit einem positiven Versatz angezeigt werden. Dieser Parameter ist nur gültig, wenn ein Versatzfeld angegeben wurde.

  • Deaktiviert: Ereignisse mit einem positiven Versatz werden links der Route angezeigt. Die Seite der Route wird durch die Maße und nicht notwendigerweise durch die Digitalisierrichtung festgelegt. Dies ist die Standardeinstellung.
  • Aktiviert: Ereignisse mit einem positiven Versatz werden rechts der Route angezeigt. Die Seite der Route wird durch die Digitalisierrichtung bestimmt.
Boolean
Punktereignisse werden als Multipoint-Features erstellt
(optional)

Gibt an, ob Punkt-Ereignisse als Punkt-Features oder Multipoint-Features behandelt werden.

  • Deaktiviert: Punkt-Ereignisse werden als Punkt-Features behandelt. Dies ist die Standardeinstellung.
  • Aktiviert: Punktereignisse werden als Multipoint-Features behandelt.
Boolean

arcpy.lr.MakeRouteEventLayer(in_routes, route_id_field, in_table, in_event_properties, out_layer, {offset_field}, {add_error_field}, {add_angle_field}, {angle_type}, {complement_angle}, {offset_direction}, {point_event_type})
NameErläuterungDatentyp
in_routes

Die Routen-Features, anhand derer Ereignisse verortet werden.

Feature Layer
route_id_field

Mit den in diesem Feld gespeicherten Werten werden die einzelnen Routen eindeutig gekennzeichnet.

Field
in_table

Die Tabelle, deren Zeilen entlang bestimmter Routen verortet werden.

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
out_layer

Der zu erstellende Layer. Dieser Layer wird im Arbeitsspeicher abgelegt, sodass kein Pfand erforderlich ist.

Feature Layer
offset_field
(optional)

Das Feld, das die Werte enthält, die verwendet werden, um Ereignisse von der ihnen zugrunde liegenden Route zu versetzen. Dieses Feld muss numerisch sein.

Field
add_error_field
(optional)

Gibt an, ob dem erstellten temporären Layer ein Feld namens LOC_ERROR hinzugefügt wird.

  • NO_ERROR_FIELDEs wird kein Feld zum Speichern von Verortungsfehlern hinzugefügt. Dies ist die Standardeinstellung.
  • ERROR_FIELDEs wird ein Feld zum Speichern von Verortungsfehlern hinzugefügt.
Boolean
add_angle_field
(optional)

Gibt an, ob dem erstellten temporären Layer ein Feld namens LOC_ANGLE hinzugefügt wird. Dieser Parameter ist nur gültig, wenn der Ereignistyp PUNKT lautet.

  • NO_ANGLE_FIELDEs wird kein Feld zum Speichern von Verortungswinkeln hinzugefügt. Dies ist die Standardeinstellung.
  • ANGLE_FIELDEs wird ein Feld zum Speichern von Verortungswinkeln hinzugefügt.
Boolean
angle_type
(optional)

Gibt den Typ des zu berechnenden Verortungswinkels an. Dieser Parameter ist nur mit add_angle_field = "ANGLE_FIELD" gültig.

  • NORMALDer normale (rechte) Winkel wird berechnet. Dies ist die Standardeinstellung.
  • TANGENTDer Tangentenwinkel wird berechnet.
String
complement_angle
(optional)

Gibt an, ob das Komplement des Verortungswinkels berechnet wird. Dieser Parameter ist nur mit add_angle_field = "ANGLE_FIELD" gültig.

  • ANGLEEs wird kein Komplement des Winkels in das Feld geschrieben. Es wird nur der berechnete Winkel in das Feld geschrieben. Dies ist die Standardeinstellung.
  • COMPLEMENTEs wird das Komplement des Winkels in das Feld geschrieben.
Boolean
offset_direction
(optional)

Gibt an, auf welcher Seite die Routenereignisse mit einem positiven Versatz angezeigt werden. Dieser Parameter ist nur gültig, wenn ein Versatzfeld angegeben wurde.

  • LEFTEreignisse mit einem positiven Versatz werden links der Route angezeigt. Die Seite der Route wird durch die Maße und nicht notwendigerweise durch die Digitalisierrichtung festgelegt. Dies ist die Standardeinstellung.
  • RIGHTEreignisse mit einem positiven Versatz werden rechts der Route angezeigt. Die Seite der Route wird durch die Digitalisierrichtung bestimmt.
Boolean
point_event_type
(optional)

Gibt an, ob Punkt-Ereignisse als Punkt-Features oder Multipoint-Features behandelt werden.

  • POINTPunkt-Ereignisse werden als Punkt-Features behandelt. Dies ist die Standardeinstellung.
  • MULTIPOINTPunkt-Ereignisse werden als Multipoint-Features behandelt.
Boolean

Codebeispiel

MakeRouteEventLayer – Beispiel 1 (Python-Fenster)
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.MakeRouteEventLayer_lr("route_hwy.shp", "rkey", "accident.dbf", 
                             "rkey POINT mile", "accident_events", "#", 
                             "ERROR_FIELD", "ANGLE_FIELD")
MakeRouteEventLayer – Beispiel 2 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion MakeRouteEventLayer in einem eigenständigen Python-Skript verwendet wird.

# Name: MakeRouteEventLayer_Example2.py
# Description:  Make a POINT event layer. Routes and events are in a shapefile workspace.
# An error field and an angle field are added to the new layer. The new layer can be used
# by other geoprocessing functions.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data"
# Set local variables
rt = "route_hwy.shp"
rid = "rkey" 
tbl = "accident.dbf"
props = "rkey POINT mile"
lyr = "accident_events" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD", 
                             "ANGLE_FIELD")
MakeRouteEventLayer – Beispiel 3 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion MakeRouteEventLayer in einem eigenständigen Python-Skript verwendet wird.

# Name: MakeRouteEventLayer_Example3.py
# Description:  Make a LINE event layer. Routes and events are in a file geodatabase.
# An error field is added to the new layer. The new layer can be used by other 
# geoprocessing functions.
# Import system modules 
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"
# Set local variables
rt = "roads/hwy"  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "pavecond"
props = "rkey LINE fmp tmp"
lyr = "pave_events" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD")
MakeRouteEventLayer – Beispiel 4 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion MakeRouteEventLayer in einem eigenständigen Python-Skript mit Enterprise-Geodatabase-Daten verwendet wird.

# Name: MakeRouteEventLayer_Example4.py
# Description: Make a POINT event layer. Routes and events are in an enterprise geodatabase.
# The new layer can be used by other geoprocessing functions.
# Import system modules 
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
ds = arcpy.ValidateTableName("roads", wkspc)  # the 'roads' feature dataset
fc = arcpy.ValidateTableName("hwy", wkspc)  # the 'hwy' feature class 
rt = ds + "/" + fc  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "accident"
props = "rkey POINT mile"
lyr = "accident_events2" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr)

Lizenzinformationen

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

Verwandte Themen