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. Hierbei kann es sich um ein Shapefile oder eine Geodatabase-Feature-Class handeln. | Feature Class |
Messwertquelle | Gibt an, wie Routenmesswerte akkumuliert werden.
| 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.
| 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.
| 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.
| Boolean |
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 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 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.
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, bei 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).
Parameter
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. Hierbei kann es sich um ein Shapefile oder eine Geodatabase-Feature-Class handeln. | Feature Class |
measure_source | Gibt an, wie Routenmesswerte akkumuliert 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 findet Anwendung, wenn als Messwertquelle LENGTH oder ONE_FIELD festgelegt wurde.
| 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.
| Boolean |
Codebeispiel
Mit dem folgenden Python-Fenster-Skript wird veranschaulicht, wie die Funktion CreateRoutes im Python-Fenster verwendet wird.
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.CreateRoutes(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.
# 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", "#", "#",
"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
# 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, "#",
"LOWER_LEFT")
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 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
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja