Routen erstellen (Linear Referencing Tools)

Zusammenfassung

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

Verwendung

Die Einzelwerte im Parameterwert Routen-Kennungsfeld werden in den Parameter 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 reduzieren.
Wenn der Parameterwert Ausgabe-Route-Feature-Class in eine Geodatabase geschrieben wird, legen Sie die entsprechenden Umgebungen M-Toleranz, M-Auflösung und M-Domäne fest.
Wenn als Messwertquelle die Länge der Merkmale eingestellt wird, um Messwerte mit geometrischen Längen zu akkumulieren, sind 2D- und 3D-Längen verfügbar. Für 2D-Längenwerte wird die Feature-Länge verwendet. Für 3D-Längenwerte erstellen Sie eine Berechnungsattributregel für ein neues Feld mit Einfüge- oder Aktualisierungstriggern, die die ArcGIS Arcade-Funktion Length3D zurückgibt.

Weitere Informationen zum Erstellen und Verwalten von Attributregeln
Rechnen Sie die jeweiligen Maßeinheiten der Route mit dem Parameter Messwertfaktor um. Beispiel: Verwenden Sie zur Umrechnung von Meter in Kilometer den Faktor 0,0001.
Verwenden Sie in Anwendungen, in denen der Anfangsmesswert der einzelnen Routen nicht 0 sein darf, den Parameterwert Messwertversatz.
Der Parameter Räumliche Lücken ignorieren wird nicht verwendet, wenn für den Parameter Messwertquelle der Wert Werte aus zwei Feldern angegeben ist. Die Messwerte basieren in diesem Fall auf den Parameterwerten für Von-Messwertfeld und Bis-Messwertfeld.
Wenn für den Parameter Messwertquelle der Wert Länge der Features oder Werte aus einem einzelnen Feld angegeben ist, wird der Parameterwert Koordinatenpriorität bestimmt, indem das kleinste umgebende Rechteck um die Eingabe-Features herum platziert wird, die zum Erstellen einer Route zusammengeführt werden.
Wenn für den Parameter Messwertquelle der Wert Werte aus zwei Feldern angegeben ist, ist es nicht notwendig, eine Koordinatenpriorität anzugeben, da die Richtung der Messwerte durch die Werte der Parameter 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 dynamische Segmentierung verwenden, sollten Sie einen Attributindex erstellen.
Wenn Features von diesem Werkzeug verworfen werden, wird im temporären Dateipfad eine Textdatei erstellt, in der Informationen zu diesen Features gespeichert werden, z. B. 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 Ausgabe-Route-Feature-Class verfügt über M-Werte (Messwerte).

Beschriftung	Erläuterung	Datentyp
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. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein.	Field
Ausgabe-Route-Feature-Class	Die Feature-Class, die erstellt wird. Die Feature-Class kann ein Shapefile oder eine Geodatabase-Feature-Class sein.	Feature Class
Messwertquelle	Gibt an, wie Routenmesswerte akkumuliert werden. Länge der Features—Die Messwerte werden anhand der geometrischen Länge der Eingabe-Features akkumuliert. Dies ist die Standardeinstellung. Werte aus einem einzelnen Feld—Die Messwerte werden anhand des Wertes aus einem einzelnen Feld akkumuliert. Werte aus zwei Feldern—Die Messwerte werden auf Basis der in den Von-Messwert- und Bis-Messwertfeldern gespeicherten Werte akkumuliert.	String
Von-Messwertfeld (Optional)	Ein Feld, das Messwerte enthält. Dieser Parameter ist erforderlich, wenn für den Parameter Messwertquelle der Wert Werte aus einem einzelnen Feld oder Werte aus zwei Feldern angegeben ist.	Field
Bis-Messwertfeld (Optional)	Ein numerisches Feld, das Messwerte enthält. Dieser Parameter ist erforderlich, wenn für den Parameter Messwertquelle der Wert Werte aus zwei Feldern angegeben ist.	Field
Koordinatenpriorität (Optional)	Gibt die Position an, ab der Messwerte für die einzelnen Ausgaberouten akkumuliert werden. Dieser Parameter wird ignoriert, wenn für den Parameter Messwertquelle der Wert Werte aus zwei Feldern angegeben ist. Obere linke Ecke—Die 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 Ecke—Die Messwerte werden ab dem Punkt akkumuliert, der der linken unteren Ecke des minimalen umgebenden Rechtecks am nächsten liegt. Obere rechte Ecke—Die Messwerte werden ab dem Punkt akkumuliert, der der rechten oberen Ecke des minimalen umgebenden Rechtecks am nächsten liegt. Untere rechte Ecke—Die 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 für den Parameter Messwertquelle der Wert 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—Es wird ein Attributindex erstellt. 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})

Name	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. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein.	Field
out_feature_class	Die Feature-Class, die erstellt wird. Die Feature-Class kann ein Shapefile oder eine Geodatabase-Feature-Class sein.	Feature Class
measure_source	Gibt an, wie Routenmesswerte akkumuliert werden. `LENGTH`—Die Messwerte werden anhand der geometrischen Länge der Eingabe-Features akkumuliert. Dies ist die Standardeinstellung. `ONE_FIELD`—Die Messwerte werden anhand des Wertes aus einem einzelnen Feld akkumuliert. `TWO_FIELDS`—Die Messwerte werden auf Basis der in den Von-Messwert- und Bis-Messwertfeldern gespeicherten Werte akkumuliert.	String
from_measure_field (Optional)	Ein Feld, das Messwerte enthält. Dieser Parameter ist erforderlich, wenn für den Parameter `measure_source` der Wert `ONE_FIELD` oder `TWO_FIELDS` angegeben ist.	Field
to_measure_field (Optional)	Ein numerisches Feld, das Messwerte enthält. Dieser Parameter ist erforderlich, wenn für den Parameter `measure_source` der Wert `TWO_FIELDS` angegeben ist.	Field
coordinate_priority (Optional)	Gibt die Position an, ab der Messwerte für die einzelnen Ausgaberouten akkumuliert werden. Dieser Parameter wird ignoriert, wenn für den Parameter `measure_source` der Wert `TWO_FIELDS` angegeben ist. `UPPER_LEFT`—Die Messwerte werden ab dem Punkt akkumuliert, der der linken oberen Ecke des minimalen umgebenden Rechtecks am nächsten liegt. Dies ist die Standardeinstellung. `LOWER_LEFT`—Die Messwerte werden ab dem Punkt akkumuliert, der der linken unteren Ecke des minimalen umgebenden Rechtecks am nächsten liegt. `UPPER_RIGHT`—Die Messwerte werden ab dem Punkt akkumuliert, der der rechten oberen Ecke des minimalen umgebenden Rechtecks am nächsten liegt. `LOWER_RIGHT`—Die 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 findet Anwendung, wenn der `measure_source`-Parameterwert `LENGTH` oder `ONE_FIELD` lautet. `IGNORE`—Räumliche Lücken werden ignoriert. Die Messwerte werden für nicht verbundene Routen durchgängig berechnet. Dies ist die Standardeinstellung. `NO_IGNORE`—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
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. `INDEX`—Es wird ein Attributindex erstellt. Dies ist die Standardeinstellung. `NO_INDEX`—Es wird kein Attributindex erstellt.	Boolean

Codebeispiel

CreateRoutes: Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion CreateRoutes verwenden.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.CreateRoutes(base_roads.shp, "route1", "newRoutes", "LENGTH", None, None,
                      "LOWER_LEFT", 0.00018939394)

CreateRoutes: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion CreateRoutes mit Shapefile-Daten verwendet wird.

# 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"

# Run CreateRoutes
arcpy.lr.CreateRoutes(in_lines, rid, out_routes, "LENGTH", None, None,
                      "LOWER_LEFT", 0.00018939394)

CreateRoutes: Beispiel 3 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion CreateRoutes mit File-Geodatabase-Daten verwendet wird.

# 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

# Run CreateRoutes
arcpy.lr.CreateRoutes(in_lines, rid, out_routes, "ONE_FIELD", m_fld, None,
                      "LOWER_LEFT")

CreateRoutes: Beispiel 4 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion CreateRoutes mit Enterprise-Geodatabase-Daten verwendet wird.

# Description:  Create routes from lines. The lines are in an enterprise
# geodatabase. The TWO_FIELDS 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 stand-alone 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 stand-alone feature class

# Run CreateRoutes
arcpy.lr.CreateRoutes(in_lines, rid, out_routes, "TWO_FIELDS", fr_fld, to_fld)

Umgebungen

Aktueller Workspace, M-Auflösung, M-Toleranz, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-M-Domäne, Ausgabe-XY-Domäne, Ausgabe-Z-Domäne, Ausgabe-Koordinatensystem, Ausdehnung, Ausgabe hat Z-Werte, Scratch-Workspace

Lizenzierungsinformationen