Beschriftung | Erläuterung | Datentyp |
Eingabe-Features | Die Features von Eingabepunkt, -linie oder -polygon. | Feature Layer |
Eingabe-Routen-Features | Die Routen, mit denen der Parameterwert Eingabe-Features überschnitten wird. | 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 |
Suchradius | Wenn als Parameterwert Eingabe-Features Punkte angegeben sind, ist der Suchradius ein Zahlenwert. Er definiert, in welchem Radius um die Punkte eine Suche durchgeführt wird, um eine Zielroute zu ermitteln. Wenn als Parameterwert Eingabe-Features Linien angegeben sind, ist die Suchtoleranz eine Cluster-Toleranz. Dies ist ein Zahlenwert, der für die maximal zulässige Entfernung zwischen den Eingabelinien und den Zielrouten steht. Wenn als Parameterwert Eingabe-Features Polygone angegeben sind, wird dieser Parameter ignoriert und kein Suchradius verwendet. | Linear Unit |
Ausgabe-Objekttabelle | Die Tabelle, die erstellt wird. | Table |
Eigenschaften der Ausgabe-Objekttabelle | Die Routenpositionsfelder und der in die Ausgabe-Objekttabelle zu schreibende Objekttyp.
| Route Measure Event Properties |
Nur die nächste Routenposition behalten (optional) | Gibt an, ob die nächstgelegene Routenposition oder alle Routenpositionen innerhalb des Suchradius in den Parameterwert Ausgabe-Objekttabelle geschrieben werden. Beim Lokalisieren von Punkten entlang von Routen besteht die Möglichkeit, dass mehrere Routen innerhalb des zu einem beliebigen Punkt festgelegten Suchradius liegen. Dieser Parameter wird ignoriert, wenn Linien oder Polygone entlang von Routen lokalisiert werden.
| Boolean |
Entfernungsfeld in Ausgabetabelle einbeziehen (optional) | Gibt an, ob dem Parameterwert Ausgabe-Objekttabelle ein DISTANCE-Feld hinzugefügt wird. Die Werte in diesem Feld übernehmen die Einheiten des angegebenen Suchradius. Dieser Parameter wird ignoriert, wenn Linien oder Polygone entlang von Routen lokalisiert werden.
| Boolean |
Linienobjekte mit der Länge 0 beibehalten (optional) | Gibt an, ob Linienobjekte mit der Länge 0 in die Ausgabe geschrieben werden. Bei der Lokalisierung von Polygonen entlang von Routen können Objekte erstellt werden, in denen der Von-Messwert dem Nach-Messwert entspricht. Dieser Parameter wird ignoriert, wenn Punkte oder Linien entlang von Routen lokalisiert werden.
| Boolean |
Alle Felder der Eingabe einbeziehen (optional) | Gibt an, ob der Parameterwert Ausgabe-Objekttabelle die Routenpositionsfelder sowie alle Attribute aus dem Parameterwert Eingabe-Features enthält.
| Boolean |
Versatz in M-Richtung verwenden (optional) | Gibt an, ob der berechnete Versatzabstand auf der M-Richtung oder der Digitalisierrichtung basieren soll. Entfernungen sind im Parameterwert Ausgabe-Objekttabelle enthalten, wenn der Parameter Entfernungsfeld in Ausgabetabelle einbeziehen aktiviert wird.
| Boolean |
Zusammenfassung
Berechnet die Schnittpunkte von Eingabe-Features (Point, Line oder Polygon) und Routen-Features und schreibt die Routen- und Messwertinformationen in eine neue Objekttabelle.
Verwendung
Die Ausgabetabelle kann eine .dbf-Datei oder eine Geodatabase-Tabelle sein.
Wenn der Parameterwert für Eingabe-Features auf "Punkte" festgelegt ist, muss der Wert für Objekttyp auf Punkt festgelegt werden. Wenn der Parameterwert für Eingabe-Features auf "Linien" oder "Polygone" festgelegt ist, muss der Wert für Objekttyp auf Linie festgelegt werden.
Die besten Ergebnisse werden erzielt, wenn sich die Eingabe-Features und die Zielrouten eng überlagern.
Vorsicht:
Die Verwendung eines großen Suchradius oder einer großen Cluster-Toleranz, um Diskrepanzen zwischen den Eingabe-Features und Zielrouten zu vermeiden, kann zu unerwarteten Ergebnissen führen.
Um die Anzahl von Eingabe-Features zu reduzieren, die von diesem Werkzeug verarbeitet werden, können Sie Layer mit einer Auswahl eingeben.
-
Die Ausgabe-Tabelle kann mit dem Werkzeug Routenobjekt-Layer erstellen in einer Karte angezeigt werden.
Parameter
arcpy.lr.LocateFeaturesAlongRoutes(in_features, in_routes, route_id_field, radius_or_tolerance, out_table, out_event_properties, {route_locations}, {distance_field}, {zero_length_events}, {in_fields}, {m_direction_offsetting})
Name | Erläuterung | Datentyp |
in_features | Die Features von Eingabepunkt, -linie oder -polygon. | Feature Layer |
in_routes | Die Routen, mit denen der Parameterwert in_features überschnitten wird. | 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 |
radius_or_tolerance | Wenn als Parameterwert in_features Punkte angegeben sind, ist der Suchradius ein Zahlenwert. Er definiert, in welchem Radius um die Punkte eine Suche durchgeführt wird, um eine Zielroute zu ermitteln. Wenn als Parameterwert in_features Linien angegeben sind, ist die Suchtoleranz eine Cluster-Toleranz. Dies ist ein Zahlenwert, der für die maximal zulässige Entfernung zwischen den Eingabelinien und den Zielrouten steht. Wenn als Parameterwert in_features Polygone angegeben sind, wird dieser Parameter ignoriert und kein Suchradius verwendet. | Linear Unit |
out_table | Die Tabelle, die erstellt wird. | Table |
out_event_properties | Die Routenpositionsfelder und der in die Ausgabe-Objekttabelle zu schreibende Objekttyp.
| Route Measure Event Properties |
route_locations (optional) | Gibt an, ob die nächstgelegene Routenposition oder alle Routenpositionen innerhalb des Suchradius in den Parameterwert out_table geschrieben werden. Beim Lokalisieren von Punkten entlang von Routen besteht die Möglichkeit, dass mehrere Routen innerhalb des zu einem beliebigen Punkt festgelegten Suchradius liegen. Dieser Parameter wird ignoriert, wenn Linien oder Polygone entlang von Routen lokalisiert werden.
| Boolean |
distance_field (optional) | Gibt an, ob ein Feld namens DISTANCE zum Parameterwert out_table hinzugefügt wird. Die Werte in diesem Feld übernehmen die Einheiten des angegebenen Suchradius. Dieser Parameter wird ignoriert, wenn Linien oder Polygone entlang von Routen lokalisiert werden.
| Boolean |
zero_length_events (optional) | Gibt an, ob Linienobjekte mit der Länge 0 in die Ausgabe geschrieben werden. Bei der Lokalisierung von Polygonen entlang von Routen können Objekte erstellt werden, in denen der Von-Messwert dem Nach-Messwert entspricht. Dieser Parameter wird ignoriert, wenn Punkte oder Linien entlang von Routen lokalisiert werden.
| Boolean |
in_fields (optional) | Gibt an, ob der Parameterwert out_table die Routenpositionsfelder sowie alle Attribute aus dem Parameterwert in_features enthält.
| Boolean |
m_direction_offsetting (optional) | Gibt an, ob der berechnete Versatzabstand auf der M-Richtung oder der Digitalisierrichtung basieren soll. Entfernungen sind im Parameterwert out_table enthalten, wenn der Parameter distance_field auf DISTANCE festgelegt wird.
| Boolean |
Codebeispiel
Mit dem folgenden Python-Skript wird veranschaulicht, wie die Funktion LocateFeaturesAlongRoutes im Python-Fenster verwendet wird.
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.LocateFeaturesAlongRoutes("rail_segments.shp", "rail_routes.shp",
"rkey", "0.5 Feet", "locate_lines",
"rkey LINE fmp tmp")
Das folgende Python-Skript veranschaulicht, wie die Funktion LocateFeaturesAlongRoutes in einem eigenständigen Python-Skript verwendet wird.
# Name: LocateFeaturesAlongRoutes_Example2.py
# Description: Locate shapefile lines along shapefile routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data"
# Set local variables
feats = "rail_segments.shp"
rts = "rail_routes.shp"
rid = "rkey"
tol = "0.5 Feet"
tbl = "locate_lines"
props = "rkey LINE fmp tmp"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, tol, tbl, props)
Das folgende Python-Skript veranschaulicht, wie die Funktion LocateFeaturesAlongRoutes in einem eigenständigen Python-Skript mit File-Geodatabase-Daten verwendet wird.
# Name: LocateFeaturesAlongRoutes_Example3.py
# Description: Locate personal geodatabase points along file geodatabase routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"
# Set local variables
feats = "rail/crossings" # crossings is in the rail feature dataset
rts = "rail/routes" # routes is in the rail feature dataset
rid = "rkey"
rad = "10 Feet"
tbl = "locate_points"
props = "rkey POINT mp"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, rad, tbl, props)
Das folgende Python-Skript veranschaulicht, wie die Funktion LocateFeaturesAlongRoutes in einem eigenständigen Python-Skript mit Enterprise-Geodatabase-Daten verwendet wird.
# Name: LocateFeaturesAlongRoutes_Example4.py
# Description: Locate enterprise geodatabase polygons along enterprise geodatabase routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
feats = arcpy.ValidateTableName("counties", wkspc) # stand-alone feature class
rts = arcpy.ValidateTableName("rail_routes", wkspc) # stand-alone feature class
rid = "rkey"
tbl = "locate_polys"
props = "rkey LINE fmp tmp"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, "#", tbl, props, "#", "#",
"NO_ZERO", "M_DIRECTON")
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja