Routen kalibrieren (Linear Referencing)—ArcGIS Pro

Zusammenfassung

Dient zum Neuberechnen der Messwerte von Routen mithilfe von Punkten.

Verwendung

Es können sowohl ganze Routen als auch Teilrouten kalibriert werden. Sie können auswählen, ob Sie zwischen den Eingabepunkten interpolieren, vor den Eingabepunkten extrapolieren, nach den Eingabepunkten extrapolieren oder eine beliebige Kombination aus diesen drei Methoden verwenden möchten.
Mit Feature-Layer erstellen oder Abfragetabelle erstellen können Sie die Anzahl der zu kalibrierenden Routen effektiv reduzieren.
Wenn die Ausgabe-Route-Feature-Class in eine Geodatabase geschrieben wird, sollten geeignete Umgebungswerte für die M-Toleranz, M-Auflösung und M-Domäne festgelegt werden.
Die Ausgabe-Route-Feature-Class enthält alle Felder aus den Eingabe-Route-Features.
Die Umgebungseinstellung outputMFlag wird ignoriert. Die Ausgabe-Route-Feature-Class verfügt über M-Werte (Messwerte).
Es kann kein Suchradius "Unendlichkeit" angegeben werden.
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 Prozess Routen kalibrieren 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\Calibrate_Output0.txt (wobei "Calibrate_Output" der Name der Ausgabe-Route-Feature-Class ist).

Parameter

Beschriftung	Erläuterung	Datentyp
Eingabe-Routen-Features	Die zu kalibrierenden Routen-Features	Feature Layer
Routen-Kennungsfeld	Mit den in diesem Feld gespeicherten Werten werden die einzelnen Routen eindeutig gekennzeichnet. Bei diesem Feld kann es sich um ein Zahlen- oder Zeichenfeld handeln.	Field
Eingabe-Punkt-Features	Die Punkt-Features, die zur Kalibrierung der Routen verwendet werden.	Feature Layer
Punkt-Kennungsfeld	Dieses Feld gibt an, auf welcher Route sich ein Kalibrierungspunkt jeweils befindet. Die Werte in diesem Feld entsprechen den Werten im Routen-Kennungsfeld. Bei diesem Feld kann es sich um ein Zahlen- oder Zeichenfeld handeln.	Field
Messwertfeld	Das Feld enthält den Messwert für die einzelnen Kalibrierungspunkte. Dieses Feld muss numerisch sein.	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
Methode der Messwertberechnung (optional)	Gibt an, wie Routenmesswerte neu berechnet werden. Entfernung—Die Messwerte werden anhand der kürzesten Verbindungsentfernung zwischen den Kalibrierungspunkten neu berechnet. Dies ist die Standardeinstellung. Messwerte—Die Messwerte werden anhand der gemessenen Entfernung zwischen den Kalibrierungspunkten neu berechnet.	String
Suchradius (optional)	Legt fest, wie weit ein Kalibrierungspunkt von einer Route entfernt sein darf. Hierfür wird die Entfernung und die entsprechende Maßeinheit angegeben. Wenn die Maßeinheiten nicht bekannt sind, werden die Einheiten des Koordinatensystems der Route-Feature-Class übernommen.	Linear Unit
Zwischen Kalibrierungspunkten interpolieren (optional)	Gibt an, ob Messwerte zwischen den Kalibrierungspunkten interpoliert werden. Aktiviert: Zwischen den Kalibrierungspunkten interpolieren. Dies ist die Standardeinstellung. Deaktiviert: Zwischen den Kalibrierungspunkten wird nicht interpoliert.	Boolean
Vor Kalibrierungspunkten extrapolieren (optional)	Gibt an, ob Messwerte vor den Kalibrierungspunkten extrapoliert werden. Aktiviert: Vor den Kalibrierungspunkten wird extrapoliert. Dies ist die Standardeinstellung. Deaktiviert: Vor den Kalibrierungspunkten wird nicht extrapoliert.	Boolean
Nach Kalibrierungspunkten extrapolieren (optional)	Gibt an, ob Messwerte nach den Kalibrierungspunkten extrapoliert werden. Aktiviert: Nach den Kalibrierungspunkten extrapolieren. Dies ist die Standardeinstellung. Deaktiviert: Nach den Kalibrierungspunkten wird nicht extrapoliert.	Boolean
Räumliche Lücken ignorieren (optional)	Hiermit geben Sie an, ob räumliche Lücken bei der Neuberechnung der Messwerte von nicht verbundenen Routen ignoriert werden. 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
Alle Features in die Ausgabe-Feature-Class einbeziehen (optional)	Gibt an, ob Routen-Features ohne Kalibrierungspunkte aus der Ausgabe-Feature-Class ausgeschlossen werden. Aktiviert: Alle Routen-Features verbleiben in der Ausgabe-Feature-Class. Dies ist die Standardeinstellung. Deaktiviert: Nicht alle Routen-Features verbleiben in der Ausgabe-Feature-Class. Features ohne Kalibrierungspunkte werden ausgeschlossen.	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.CalibrateRoutes(in_route_features, route_id_field, in_point_features, point_id_field, measure_field, out_feature_class, {calibrate_method}, {search_radius}, {interpolate_between}, {extrapolate_before}, {extrapolate_after}, {ignore_gaps}, {keep_all_routes}, {build_index})

Name	Erläuterung	Datentyp
in_route_features	Die zu kalibrierenden Routen-Features	Feature Layer
route_id_field	Mit den in diesem Feld gespeicherten Werten werden die einzelnen Routen eindeutig gekennzeichnet. Bei diesem Feld kann es sich um ein Zahlen- oder Zeichenfeld handeln.	Field
in_point_features	Die Punkt-Features, die zur Kalibrierung der Routen verwendet werden.	Feature Layer
point_id_field	Dieses Feld gibt an, auf welcher Route sich ein Kalibrierungspunkt jeweils befindet. Die Werte in diesem Feld entsprechen den Werten im Routen-Kennungsfeld. Bei diesem Feld kann es sich um ein Zahlen- oder Zeichenfeld handeln.	Field
measure_field	Das Feld enthält den Messwert für die einzelnen Kalibrierungspunkte. Dieses Feld muss numerisch sein.	Field
out_feature_class	Die zu erstellende Feature-Class. Hierbei kann es sich um ein Shapefile oder eine Geodatabase-Feature-Class handeln.	Feature Class
calibrate_method (optional)	Gibt an, wie Routenmesswerte neu berechnet werden. DISTANCE—Die Messwerte werden anhand der kürzesten Verbindungsentfernung zwischen den Kalibrierungspunkten neu berechnet. Dies ist die Standardeinstellung. MEASURES—Die Messwerte werden anhand der gemessenen Entfernung zwischen den Kalibrierungspunkten neu berechnet.	String
search_radius (optional)	Legt fest, wie weit ein Kalibrierungspunkt von einer Route entfernt sein darf. Hierfür wird die Entfernung und die entsprechende Maßeinheit angegeben. Wenn die Maßeinheiten nicht bekannt sind, werden die Einheiten des Koordinatensystems der Route-Feature-Class übernommen.	Linear Unit
interpolate_between (optional)	Gibt an, ob Messwerte zwischen den Kalibrierungspunkten interpoliert werden. BETWEEN—Zwischen den Kalibrierungspunkten wird interpoliert. Dies ist die Standardeinstellung. NO_BETWEEN—Zwischen den Kalibrierungspunkten wird nicht interpoliert.	Boolean
extrapolate_before (optional)	Gibt an, ob Messwerte vor den Kalibrierungspunkten extrapoliert werden. BEFORE—Vor den Kalibrierungspunkten wird extrapoliert. Dies ist die Standardeinstellung. NO_BEFORE—Vor den Kalibrierungspunkten wird nicht extrapoliert.	Boolean
extrapolate_after (optional)	Gibt an, ob Messwerte nach den Kalibrierungspunkten extrapoliert werden. AFTER—Nach den Kalibrierungspunkten wird extrapoliert. Dies ist die Standardeinstellung. NO_AFTER—Nach den Kalibrierungspunkten wird nicht extrapoliert.	Boolean
ignore_gaps (optional)	Hiermit geben Sie an, ob räumliche Lücken bei der Neuberechnung der Messwerte von nicht verbundenen Routen ignoriert werden. 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 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
keep_all_routes (optional)	Gibt an, ob Routen-Features ohne Kalibrierungspunkte aus der Ausgabe-Feature-Class ausgeschlossen werden. KEEP—Alle Routen-Features werden in der Ausgabe-Feature-Class beibehalten. Dies ist die Standardeinstellung. NO_KEEP—Nicht alle Routen-Features werden in der Ausgabe-Feature-Class beibehalten. Features ohne Kalibrierungspunkte werden ausgeschlossen.	Boolean
build_index (optional)	Gibt an, ob für das Routen-Kennungsfeld, das in die out_feature_class geschrieben wird, ein Attributindex erstellt wird. INDEX—Es wird ein Attributindex erstellt. Dies ist die Standardeinstellung. NO_INDEX—Es wird kein Attributindex erstellt.	Boolean

Codebeispiel

CalibrateRoutes – Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CalibrateRoutes_lr("hwy.shp", "RID", "cal_pts.shp", "RID", "MEASURE", 
                         "C:/output/hwy_new.shp","DISTANCE", "5.0 feet", 
                         "BETWEEN", "BEFORE", "AFTER", "#", "NO_KEEP")

CalibrateRoutes – Beispiel 2 (eigenständiges Skript)

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

# Name CalibrateRoutes_Example2.py
# Description: Calibrate personal geodatabase routes with file geodatabase 
# points.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"
# Set local variables
rts = "roads/hwy"  # hwy is in the roads feature dataset
rid = "ROUTE1" 
pts = "roads/cal_pts"  # cal_pts is in the roads feature dataset
mfield = "MEASURE"
radius = "2.5 Meters"
out_fc = "roads/hwy_new"  # new feature class in the roads feature dataset
# Execute CalibrateRoutes
arcpy.CalibrateRoutes_lr(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, 
                         "BETWEEN", "NO_BEFORE", "NO_AFTER")

CalibrateRoutes – Beispiel 3 (eigenständiges Skript)

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

# Name CalibrateRoutes_Example3.py
# Description: Calibrate enterprise geodatabase routes using enterprise 
# geodatabase points.
# Import system modules
import arcpy
# Set workspace
wkspc = "C:/MyProject/myConn.sde"
arcpy.env.workspace = wkspc 
# Set local variables
rts = arcpy.ValidateTableName("hwy", wkspc)  # standalone feature class
rid = "ROUTE1"
pts = arcpy.ValidateTableName("cal_pts", wkspc)  # standalone feature class
mfield = "MEASURE"
radius = "5.0 Feet"
out_fc = "hwy_new" # new standalone feature class 
# Execute CalibrateRoutes
arcpy.CalibrateRoutes_lr(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, 
                         "#", "#", "#", "#", "NO_KEEP")

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

Sonderfälle

Lizenzinformationen

Basic: Ja
Standard: Ja
Advanced: Ja