Beschriftung | Erläuterung | Datentyp |
Eingabe-Routen-Features | Die Routen-Features, die kalibriert werden. | 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 |
Eingabe-Punkt-Features | Die Punkt-Features, die zum Kalibrieren 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 numerisches Feld, ein Textfeld oder ein GUID-Feld 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 Feature-Class, die erstellt wird. 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.
| 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.
| Boolean |
Vor Kalibrierungspunkten extrapolieren (optional) | Gibt an, ob Messwerte vor den Kalibrierungspunkten extrapoliert werden.
| Boolean |
Nach Kalibrierungspunkten extrapolieren (optional) | Gibt an, ob Messwerte nach den Kalibrierungspunkten extrapoliert werden.
| 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.
| Boolean |
Alle Features in die Ausgabe-Feature-Class einbeziehen (optional) | Gibt an, ob Routen-Features ohne Kalibrierungspunkte in die Ausgabe-Feature-Class einbezogen werden.
| Boolean |
Index erstellen (optional) | Hiermit geben Sie an, ob für das Routen-Kennungsfeld, das in den Parameterwert Ausgabe-Route-Feature-Class geschrieben wird, ein Attributindex erstellt werden soll.
| Boolean |
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 zwischen den Eingabepunkten interpolieren, vor den Eingabepunkten extrapolieren, nach den Eingabepunkten extrapolieren oder eine beliebige Kombination aus diesen Methoden verwenden.
Mit Feature-Layer erstellen oder Abfragetabelle erstellen können Sie die Anzahl der zu kalibrierenden Routen 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.
Der Parameterwert Ausgabe-Route-Feature-Class enthält alle Felder aus dem Parameterwert Eingabe-Route-Features.
Die Umgebungseinstellung Ausgabe hat M-Werte wird ignoriert. Der Parameterwert Ausgabe-Route-Feature-Class verfügt über M-Werte (Messwerte).
Es kann kein Suchradius "Unendlichkeit" angegeben werden.
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\Calibrate_Output0.txt (wobei "Calibrate_Output" der Name des Parameterwertes Ausgabe-Route-Feature-Class ist).
Parameter
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 Routen-Features, die kalibriert werden. | 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 |
in_point_features | Die Punkt-Features, die zum Kalibrieren 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 numerisches Feld, ein Textfeld oder ein GUID-Feld 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 Feature-Class, die erstellt wird. 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 in die Ausgabe-Feature-Class einbezogen werden.
| Boolean |
build_index (optional) | Gibt an, ob für das Routen-Kennungsfeld, das in den Parameterwert out_feature_class geschrieben wird, ein Attributindex erstellt wird.
| Boolean |
Codebeispiel
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.lr.CalibrateRoutes("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
# 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
# Run CalibrateRoutes
arcpy.lr.CalibrateRoutes(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 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
# Run CalibrateRoutes
arcpy.lr.CalibrateRoutes(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius,
"#", "#", "#", "#", "NO_KEEP")
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja