Routen kalibrieren (Lineare Referenzierung)
Summary
Dient zum Neuberechnen der Messwerte von Routen mithilfe von Punkten.
Usage
-
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 Werte 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. Beispielsweise C:\Documents and Settings\patrickb\Local Settings\Temp\Calibrate_Output0.txt (wobei Calibrate_Output der Name der Ausgabe-Route-Feature-Class) ist.
Syntax
| Parameter | Explanation | Data Type |
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.
| 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.
| Boolean |
extrapolate_before (Optional) |
Gibt an, ob Messwerte vor den Kalibrierungspunkten extrapoliert werden.
| Boolean |
extrapolate_after (Optional) |
Gibt an, ob Messwerte nach den Kalibrierungspunkten extrapoliert werden.
| Boolean |
ignore_gaps (Optional) |
Hiermit geben Sie an, ob räumliche Lücken bei der Neuberechnung der Messwerte von nicht verbundenen Routen ignoriert werden.
| Boolean |
keep_all_routes (Optional) |
Gibt an, ob Routen-Features ohne Kalibrierungspunkte aus der Ausgabe-Feature-Class ausgeschlossen werden.
| 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 |
Code Sample
Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion "CalibrateRoutes" im unmittelbaren Modus verwenden.
import arcpy
from arcpy import env
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")
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
from arcpy import env
# Set workspace
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")
Das folgende Python-Skript veranschaulicht, wie die Funktion "CalibrateRoutes" in einem eigenständigen Python-Skript mit Personal-Geodatabase-Daten verwendet wird.
# Name CalibrateRoutes_Example3.py
# Description: Calibrate personal geodatabase routes with personal geodatabase points.
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data/Pitt.mdb"
# 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 a feature dataset
# Execute CalibrateRoutes
arcpy.CalibrateRoutes_lr (rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, \
"BETWEEN", "NO_BEFORE", "NO_AFTER")
Das folgende Python-Skript veranschaulicht, wie die Funktion "CalibrateRoutes" in einem eigenständigen Python-Skript mit SDE-Daten verwendet wird.
# Name Example 4:
# Description: Calibrate enterprise geodatabase routes using enterprise geodatabase points.
# Import system modules
import arcpy
from arcpy import env
# Set workspace
wkspc = "Database Connections/Connection to Jerry.sde"
env.workspace = wkspc
# Set local variables
rts = gp.QualifyTableName("hwy", wkspc) # standalone feature class
rid = "ROUTE1"
pts = gp.QualifyTableName("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")