Routen erstellen (Lineare Referenzierung)
Zusammenfassung
Erstellt Routen aus vorhandenen Linien. Eingabe-Linien-Features mit derselben Kennung werden zu einer einzigen Route zusammengeführt.
Verwendung
-
Die Einzelwerte im Routenidentifizierungsfeld werden in die Ausgabe-Route-Feature-Class geschrieben.
-
Mit den Werkzeugen Feature-Layer erstellen oder Abfragetabelle erstellen können Sie die Anzahl der zum Erstellen der Routen verwendeten Linien effektiv reduzieren.
-
Wenn die Ausgabe-Route-Feature-Class in eine Geodatabase geschrieben wird, sollten geeignete Werte für die M-Toleranz, M-Auflösung und M-Domäne festgelegt werden.
-
Rechnen Sie die jeweiligen Maßeinheiten der Route mit einem Messwertfaktor um. Beispiel: Verwenden Sie zur Umrechnung von Meter in Kilometer den Faktor 0,0001.
-
Verwenden Sie in Anwendungen, bei denen der Anfangsmesswert der einzelnen Routen nicht 0 sein darf, einen Messwertversatz.
-
Der Parameter Räumliche Lücken ignorieren wird nicht verwendet, wenn als Messwertquelle die Option TWO_FIELDS angegeben wird. Die Messwerte werden in diesem Fall von den Werten für Von-Messwert-Feld und Bis-Messwert-Feld bestimmt.
-
Wenn als Messwertquelle die Option LENGTH oder ONE_FIELD angegeben ist, wird die Koordinatenpriorität dadurch ermittelt, dass das minimale umgebende Rechteck um die Eingabe-Features platziert wird, die zum Erstellen einer Route zusammengeführt werden sollen.
-
Wenn Sie die Messwertquelle TWO_FIELDS verwenden, ist es nicht notwendig, eine Koordinatenpriorität anzugeben, da die Richtung der Messwerte durch die Werte im Von-Messwert-Feld und Bis-Messwert-Feld vorgegeben wird.
-
Ein Attributindex für das Routenidentifizierungsfeld beschleunigt die dynamische Segmentierung. Wenn Sie die Ausgabe-Route-Feature-Class für die dynamische Segmentierung verwenden, empfiehlt es sich, einen Attributindex zu erstellen.
-
Wenn Features vom Werkzeug "Routen erstellen" verworfen werden, wird im temporären Dateipfad eine Textdatei erstellt, in der Informationen zu diesen Features gespeichert werden. Beispiel: C:\Dokumente und Einstellungen\patrickb\Lokale Einstellungen\Temp\Create_Output0.txt (wobei Create_Output der Name der Ausgabe-Route-Feature-Class ist).
-
Die Umgebungseinstellung outputMFlag wird ignoriert. Die Ausgabe-Route-Feature-Class verfügt über M-Werte (Messwerte).
Syntax
| Parameter | Erläuterung | Datentyp |
in_line_features |
Die Features zur Erstellung der Routen | Feature Layer |
route_id_field |
Mit den in diesem Feld gespeicherten Werten werden die einzelnen Routen eindeutig gekennzeichnet. | Field |
out_feature_class |
Die zu erstellende Feature-Class Hierbei kann es sich um eine Shapefile- oder Geodatabase-Feature-Class handeln. | Feature Class |
measure_source |
Gibt an, wie Routenmesswerte ermittelt werden.
| String |
from_measure_field (optional) |
Ein Feld, das Messwerte enthält. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Messwertquelle ONE_FIELD oder TWO_FIELDS festgelegt wurde. | Field |
to_measure_field (optional) |
Ein Feld, das Messwerte enthält. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Messwertquelle TWO_FIELDS festgelegt wurde. | Field |
coordinate_priority (optional) |
Die Position, ab der Messwerte für die einzelnen Ausgaberouten akkumuliert werden. Dieser Parameter wird ignoriert, wenn als Messwertquelle TWO_FIELDS festgelegt wurde.
| String |
measure_factor (optional) |
Die Messwertlänge der einzelnen Eingabelinien wird mit diesem Wert multipliziert, bevor sie zu einem Routenmesswert zusammengeführt werden. Die Standardeinstellung ist 1. | Double |
measure_offset (optional) |
Dieser Wert wird mit den Routenmesswerten addiert, nachdem die Eingabelinien zu einer Route zusammengeführt wurden. Die Standardeinstellung ist 0. | Double |
ignore_gaps (optional) |
Gibt an, ob Lücken bei der Messwertberechnung von nicht verbundenen Routen ignoriert werden. Dieser Parameter ist relevant, wenn als Messwertquelle LENGTH oder ONE_FIELD festgelegt wurde.
| Boolean |
build_index (optional) |
Gibt an, ob für das Routenidentifizierungsfeld, das in die Ausgabe-Route-Feature-Class geschrieben wird, ein Attributindex erstellt werden soll.
| Boolean |
Codebeispiel
Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion "CreateRoutes" im Python-Fenster verwenden.
import arcpy from arcpy import env env.workspace = "C:/Data" arcpy.CreateRoutes_lr(base_roads.shp, "route1", "newRoutes", "LENGTH", "#", "#", "LOWER_LEFT", 0.00018939394)
Das folgende Python-Skript veranschaulicht, wie die Funktion "CreateRoutes" in einem eigenständigen Python-Skript mit Shapefile-Daten verwendet wird.
# Name CreateRoutes_Example2.py # Description: Create routes from lines. The lines are in a shapefile workspace. # The LENGTH option will be used to set the measures, and a measure factor # will be used to convert measure units from feet to miles. # Author: ESRI # Import system modules import arcpy from arcpy import env # Set workspace env.workspace = "C:/Data" # Set local variables in_lines = "base_roads.shp" rid = "route1" out_routes = "create_output1" # Execute CreateRoutes arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "LENGTH", "#", "#", "LOWER_LEFT", 0.00018939394)
Das folgende Python-Skript veranschaulicht, wie die Funktion "CreateRoutes" in einem eigenständigen Python-Skript mit File-Geodatabase-Daten verwendet wird.
# Name CreateRoutes_Example3.py
# Description: Create routes from lines. The lines are in a file geodatabase.
# The ONE_FIELD option will be used to set the measures.
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data/pitt.gdb"
# Set local variables
in_lines = "roads/base_roads" # base_roads exists in the roads feature dataset
rid = "route1"
m_fld = "len_mile"
out_routes = "roads/create_output2" # write the result to the roads feature dataset
# Execute CreateRoutes
arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "ONE_FIELD", m_fld, "#", "LOWER_LEFT")
Das folgende Python-Skript veranschaulicht, wie die Funktion "CreateRoutes" in einem eigenständigen Python-Skript mit Personal-Geodatabase-Daten verwendet wird.
# Name: CreateRoutes_Example4.py # Description: Create routes from lines. The lines are in a personal geodatabase. # The ONE_FIELD option will be used to set the measures. # Author: ESRI # Import system modules import arcpy from arcpy import env # Set workspace env.workspace = "C:/Data/pitt.mdb" # Set local variables in_lines = "roads/base_roads" # base_roads exists in the roads feature dataset rid = "route1" m_fld = "len_mile" out_routes = "roads/create_output2" # write the result to the roads feature dataset # Execute CreateRoutes arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "ONE_FIELD", m_fld, "#", "LOWER_LEFT")
Das folgende Python-Skript veranschaulicht, wie die Funktion "CreateRoutes" in einem eigenständigen Python-Skript mit SDE-Daten verwendet wird.
# Name CreateRoutes_Example5.py
# Description: Create routes from lines. The lines are in an enterprise geodatabase.
# The TWO_FIELD option will be used to set the measures.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "Database Connections/Connection to Jerry.sde"
# Set local variables
in_lines = gp.QualifyTableName("base_roads", wkspc) # base_roads is a standalone feature class
rid = "route1"
fr_fld = "begmp1"
to_fld = "endmp1"
out_routes = "create_output3" # write the result to a standalone feature class
# Execute CreateRoutes
arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "TWO_FIELDS", fr_fld, to_fld)