Routen erstellen (Linear Referencing)

Zusammenfassung

Erstellt Routen aus vorhandenen Linien. Eingabe-Linien-Features mit derselben Kennung werden zu einer einzigen Route zusammengeführt.

Verwendung

  • Die Einzelwerte im Routen-Kennungsfeld 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, sollte eine geeignete M-Toleranz-, M-Auflösung- und M-Domäne-Umgebung 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 Werte aus zwei Feldern angegeben wird. Die Messwerte werden in diesem Fall von den Werten für Von-Messwertfeld und Bis-Messwertfeld bestimmt.

  • Wenn als Messwertquelle die Option Länge der Features oder Werte aus einem einzelnen Feld 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 als Messwertquelle die Option Werte aus zwei Feldern angegeben ist, ist es nicht notwendig, eine Koordinatenpriorität anzugeben, da die Richtung der Messwerte durch die Werte im Von-Messwertfeld und Bis-Messwertfeld vorgegeben wird.

  • Mit einem Attributindex für das Routenidentifizierungsfeld wird der dynamische Segmentierungsprozess beschleunigt. Wenn Sie den Parameterwert Ausgabe-Route-Feature-Class für die dynamische Segmentierung verwenden, wird empfohlen, 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. Beispielsweise C:\Users\patrickb\AppData\Local\Temp\Create_Output0.txt (wobei "Create_Output" der Name der Ausgabe-Route-Feature-Class ist).

  • Die Umgebungseinstellung Ausgabe hat M-Werte wird ignoriert. Der Parameterwert für Ausgabe-Route-Feature-Class verfügt über M-Werte (Messwerte).

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Linien-Features

Die Features zur Erstellung der Routen.

Feature Layer
Routen-Kennungsfeld

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

Field
Ausgabe-Route-Feature-Class

Die zu erstellende Feature-Class. Hierbei kann es sich um ein Shapefile oder eine Geodatabase-Feature-Class handeln.

Feature Class
Messwertquelle

Gibt an, wie Routenmesswerte ermittelt werden.

  • Länge der FeaturesDie Messwerte werden anhand der geometrischen Länge der Eingabe-Features akkumuliert. Dies ist die Standardeinstellung.
  • Werte aus einem einzelnen FeldDie Messwerte werden anhand des Wertes aus einem einzelnen Feld akkumuliert.
  • Werte aus zwei FeldernDie Messwerte werden auf Basis der in den Von-Messwert- und Bis-Messwertfeldern gespeicherten Werte festgelegt.
String
Von-Messwertfeld
(optional)

Ein Feld, das Messwerte enthält. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn die Messwertquelle Werte aus einem einzelnen Feld oder Werte aus zwei Feldern lautet.

Field
Bis-Messwertfeld
(optional)

Ein Feld, das Messwerte enthält. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Messwertquelle Werte aus zwei Feldern festgelegt wurde.

Field
Koordinatenpriorität
(optional)

Die Position, ab der Messwerte für die einzelnen Ausgaberouten akkumuliert werden. Dieser Parameter wird ignoriert, wenn als Messwertquelle Werte aus zwei Feldern festgelegt wurde.

  • Obere linke EckeDie Messwerte werden ab dem Punkt akkumuliert, der der linken oberen Ecke des minimalen umgebenden Rechtecks am nächsten liegt. Dies ist die Standardeinstellung.
  • Untere linke EckeDie Messwerte werden ab dem Punkt akkumuliert, der der linken unteren Ecke des minimalen umgebenden Rechtecks am nächsten liegt.
  • Obere rechte EckeDie Messwerte werden ab dem Punkt akkumuliert, der der rechten oberen Ecke des minimalen umgebenden Rechtecks am nächsten liegt.
  • Untere rechte EckeDie Messwerte werden ab dem Punkt akkumuliert, der der rechten unteren Ecke des minimalen umgebenden Rechtecks am nächsten liegt.
String
Messwertfaktor
(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
Messwertversatz
(optional)

Dieser Wert wird mit den Routenmesswerten addiert, nachdem die Eingabelinien zu einer Route zusammengeführt wurden. Die Standardeinstellung ist 0.

Double
Räumliche Lücken ignorieren
(optional)

Gibt an, ob Lücken bei der Messwertberechnung von nicht verbundenen Routen ignoriert werden. Dieser Parameter ist relevant, wenn als Messwertquelle Länge der Features oder Werte aus einem einzelnen Feld festgelegt wurde.

  • Aktiviert: Räumliche Lücken werden ignoriert. Die Messwerte werden für nicht verbundene Routen durchgängig berechnet. Dies ist die Standardeinstellung.
  • Deaktiviert: Räumliche Lücken werden nicht ignoriert. Die Messwerte von nicht verbundenen Routen weisen Lücken auf. Die Lückenentfernung wird anhand der geradlinigen Entfernung zwischen den Endpunkten der nicht verbundenen Teile berechnet.
Boolean
Index erstellen
(optional)

Hiermit geben Sie an, ob für das Routen-Kennungsfeld, das in die Ausgabe-Route-Feature-Class geschrieben wird, ein Attributindex erstellt werden soll.

  • Aktiviert: Attributindex erstellen. Dies ist die Standardeinstellung.
  • Deaktiviert: Es wird kein Attributindex erstellt.
Boolean

arcpy.lr.CreateRoutes(in_line_features, route_id_field, out_feature_class, measure_source, {from_measure_field}, {to_measure_field}, {coordinate_priority}, {measure_factor}, {measure_offset}, {ignore_gaps}, {build_index})
NameErläuterungDatentyp
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 ein Shapefile oder eine Geodatabase-Feature-Class handeln.

Feature Class
measure_source

Gibt an, wie Routenmesswerte ermittelt werden.

  • LENGTHDie Messwerte werden anhand der geometrischen Länge der Eingabe-Features akkumuliert. Dies ist die Standardeinstellung.
  • ONE_FIELDDie Messwerte werden anhand des Wertes aus einem einzelnen Feld akkumuliert.
  • TWO_FIELDSDie Messwerte werden auf Basis der in den Von-Messwert- und Bis-Messwertfeldern gespeicherten Werte festgelegt.
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.

  • UPPER_LEFTDie Messwerte werden ab dem Punkt akkumuliert, der der linken oberen Ecke des minimalen umgebenden Rechtecks am nächsten liegt. Dies ist die Standardeinstellung.
  • LOWER_LEFTDie Messwerte werden ab dem Punkt akkumuliert, der der linken unteren Ecke des minimalen umgebenden Rechtecks am nächsten liegt.
  • UPPER_RIGHTDie Messwerte werden ab dem Punkt akkumuliert, der der rechten oberen Ecke des minimalen umgebenden Rechtecks am nächsten liegt.
  • LOWER_RIGHTDie Messwerte werden ab dem Punkt akkumuliert, der der rechten unteren Ecke des minimalen umgebenden Rechtecks am nächsten liegt.
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.

  • IGNORERäumliche Lücken werden ignoriert. Die Messwerte werden für nicht verbundene Routen durchgängig berechnet. Dies ist die Standardeinstellung.
  • NO_IGNORERäumliche Lücken nicht ignorieren. Die Messwerte von nicht verbundenen Routen weisen Lücken auf. Die Lückenentfernung wird anhand der geradlinigen Entfernung zwischen den Endpunkten der nicht verbundenen Teile berechnet.
Boolean
build_index
(optional)

Hiermit geben Sie an, ob für das Routen-Kennungsfeld, das in die Ausgabe-Route-Feature-Class geschrieben wird, ein Attributindex erstellt werden soll.

  • INDEXEs wird ein Attributindex erstellt. Dies ist die Standardeinstellung.
  • NO_INDEXEs wird kein Attributindex erstellt.
Boolean

Codebeispiel

CreateRoutes – Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion CreateRoutes im Python-Fenster verwendet wird.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.CreateRoutes_lr(base_roads.shp, "route1", "newRoutes", "LENGTH", "#", "#", 
                      "LOWER_LEFT", 0.00018939394)
CreateRoutes – Beispiel 2 (eigenständiges Skript)

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.
# Import system modules
import arcpy
# Set workspace
arcpy.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)
CreateRoutes – Beispiel 3 (eigenständiges Skript)

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
# Set workspace
arcpy.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 result to the roads feature dataset
# Execute CreateRoutes
arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "ONE_FIELD", m_fld, "#", 
                      "LOWER_LEFT")
CreateRoutes – Beispiel 4 (eigenständiges Skript)

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

# Name CreateRoutes_Example4.py
# Description:  Create routes from lines. The lines are in an enterprise 
# geodatabase. The TWO_FIELD option will be used to set the measures.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
# base_roads is a standalone feature class
in_lines = arcpy.ValidateTableName("base_roads", wkspc)
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)

Lizenzinformationen

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

Verwandte Themen