Routenobjekt-Layer erstellen (Linear Referencing Tools)

Zusammenfassung

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

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 das Werkzeug Feature-Layer erstellen für die Routen und/oder das Werkzeug Tabellensicht erstellen für die Objekte, um die Anzahl der zu verarbeitenden Routen und Objekte zu reduzieren, bevor Sie dieses Werkzeug ausführen.
Nicht alle Tabellentypen haben ein Objekt-ID-Feld. Wenn dieses Werkzeug Tabellen ohne Objekt-ID-Feld verwendet, ist der resultierende Layer nicht auswählbar und kann in bestimmten Geoverarbeitungsvorgängen nicht effektiv verwendet werden. Sie können mit dem Werkzeug Abfragetabelle erstellen vor dem Ausführen des Werkzeugs ein virtuelles Objekt-ID-Feld hinzufügen.

Beschriftung	Erläuterung	Datentyp
Eingabe-Routen-Features	Die Routen-Features, anhand derer Objekte verortet werden.	Feature Layer
Routen-Kennungsfeld	Mit den in diesem Feld gespeicherten Werten werden die einzelnen Routen eindeutig gekennzeichnet. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein.	Field
Eingabe-Objekttabelle	Die Tabelle, deren Zeilen entlang bestimmter Routen verortet werden.	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
Layer-Name oder Tabellensicht	Der erstellte 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 Objekte 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 `LOC_ERROR`-Feld hinzugefügt wird. Aktiviert—Es wird ein Feld zum Speichern von Verortungsfehlern hinzugefügt. Deaktiviert—Es wird kein Feld zum Speichern von Verortungsfehlern hinzugefügt. Dies ist die Standardeinstellung.	Boolean
Ein Winkelfeld erstellen (Optional)	Gibt an, ob dem erstellten temporären Layer ein `LOC_ANGLE`-Feld hinzugefügt wird. Dieser Parameter ist nur gültig, wenn der Objekttyp "Punkt" lautet. Aktiviert—Es wird ein Feld zum Speichern von Verortungswinkeln hinzugefügt. Deaktiviert—Es wird kein Feld zum Speichern von Verortungswinkeln hinzugefügt. Dies ist die Standardeinstellung.	Boolean
Berechneter Winkeltyp (Optional)	Gibt den Typ des zu berechnenden Verortungswinkels an. Dieser Parameter ist nur gültig, wenn der Parameter Ein Winkelfeld erstellen aktiviert ist. Normal—Der normale (rechte) Winkel wird berechnet. Dies ist die Standardeinstellung. Tangente—Der Tangentenwinkel wird berechnet.	String
Das Komplement des Winkels in ein Winkelfeld schreiben (Optional)	Gibt an, ob das Komplement des Verortungswinkels geschrieben wird. Dieser Parameter ist nur gültig, wenn der Parameter Ein Winkelfeld erstellen aktiviert ist. Aktiviert—Das Komplement des Winkels wird in das Feld geschrieben. Deaktiviert—Das Komplement des Winkels wird nicht in das Feld geschrieben. Nur der berechnete Winkel wird in das Feld geschrieben. Dies ist die Standardeinstellung.	Boolean
Objekte mit einem positiven Versatz werden rechts der Route platziert (Optional)	Gibt an, auf welcher Seite die Routenobjekte mit einem positiven Versatz angezeigt werden. Dieser Parameter ist nur gültig, wenn ein Versatzfeld angegeben wurde. Aktiviert—Objekte mit einem positiven Versatz werden rechts der Route angezeigt. Die Seite der Route wird durch die Digitalisierrichtung bestimmt. Deaktiviert—Objekte 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.	Boolean
Punktobjekte werden als Multipoint-Features erstellt (Optional)	Gibt an, ob Punktobjekte als Punkt-Features oder Multipoint-Features behandelt werden. Aktiviert—Punktobjekte werden als Multipoint-Features behandelt. Deaktiviert—Punktobjekte werden als Punkt-Features behandelt. Dies ist die Standardeinstellung.	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})

Name	Erläuterung	Datentyp
in_routes	Die Routen-Features, anhand derer Objekte verortet werden.	Feature Layer
route_id_field	Mit den in diesem Feld gespeicherten Werten werden die einzelnen Routen eindeutig gekennzeichnet. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein.	Field
in_table	Die Tabelle, deren Zeilen entlang bestimmter Routen verortet werden.	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
out_layer	Der erstellte 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 Objekte 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 `LOC_ERROR`-Feld hinzugefügt wird. `ERROR_FIELD`—Es wird ein Feld zum Speichern von Verortungsfehlern hinzugefügt. `NO_ERROR_FIELD`—Es wird kein Feld zum Speichern von Verortungsfehlern hinzugefügt. Dies ist die Standardeinstellung.	Boolean
add_angle_field (Optional)	Gibt an, ob dem erstellten temporären Layer ein `LOC_ANGLE`-Feld hinzugefügt wird. Dieser Parameter ist nur gültig, wenn der Objekttyp "Punkt" lautet. `ANGLE_FIELD`—Es wird ein Feld zum Speichern von Verortungswinkeln hinzugefügt. `NO_ANGLE_FIELD`—Es wird kein Feld zum Speichern von Verortungswinkeln hinzugefügt. Dies ist die Standardeinstellung.	Boolean
angle_type (Optional)	Gibt den Typ des zu berechnenden Verortungswinkels an. Dieser Parameter ist nur gültig, wenn der Parameter `add_angle_field` auf `ANGLE_FIELD` festgelegt wurde. `NORMAL`—Der normale (rechte) Winkel wird berechnet. Dies ist die Standardeinstellung. `TANGENT`—Der Tangentenwinkel wird berechnet.	String
complement_angle (Optional)	Gibt an, ob das Komplement des Verortungswinkels geschrieben wird. Dieser Parameter ist nur gültig, wenn der Parameter `add_angle_field` auf `ANGLE_FIELD` festgelegt wurde. `COMPLEMENT`—Das Komplement des Winkels wird in das Feld geschrieben. `ANGLE`—Das Komplement des Winkels wird nicht in das Feld geschrieben. Nur der berechnete Winkel wird in das Feld geschrieben. Dies ist die Standardeinstellung.	Boolean
offset_direction (Optional)	Gibt an, auf welcher Seite die Routenobjekte mit einem positiven Versatz angezeigt werden. Dieser Parameter ist nur gültig, wenn ein Versatzfeld angegeben wurde. `RIGHT`—Objekte mit einem positiven Versatz werden rechts der Route angezeigt. Die Seite der Route wird durch die Digitalisierrichtung bestimmt. `LEFT`—Objekte 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.	Boolean
point_event_type (Optional)	Gibt an, ob Punktobjekte als Punkt-Features oder Multipoint-Features behandelt werden. `MULTIPOINT`—Punktobjekte werden als Multipoint-Features behandelt. `POINT`—Punktobjekte werden als Punkt-Features behandelt. Dies ist die Standardeinstellung.	Boolean

Codebeispiel

MakeRouteEventLayer: Beispiel 1 (Python-Fenster)

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.MakeRouteEventLayer("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"

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

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

# Run MakeRouteEventLayer
arcpy.lr.MakeRouteEventLayer(rt, rid, tbl, props, lyr)

Umgebungen

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

Lizenzierungsinformationen