Kalibrierungspunkte generieren (Location Referencing)

Mit der Location Referencing-Lizenz verfügbar.

Zusammenfassung

Generiert Kalibrierungspunkte für beliebige bereitgestellte Routenformen, einschließlich komplexer Polygonflächen wie in sich abgeschlossener, sich selbst schneidender und verzweigter Routen.

Verwendung

• Zum Ausführen dieses Werkzeugs ist ein LRS-Dataset erforderlich.

  Weitere Informationen zum Erstellen eines LRS-Datasets in ArcGIS Pipeline Referencing und zum Erstellen eines LRS-Datasets in ArcGIS Roads and Highways

• Der Wert des Parameters Eingabe-Polylinien-Features ist die Grundlage für die Kalibrierungspunkte, die generiert werden.

• Der Wert des Parameters Feature-Class für Kalibrierungspunkte muss im LRS registriert werden.

• Der Wert des Parameters LRS-Netzwerk muss im LRS registriert werden.

• Abgeleitete LRS-Netzwerke werden als Wert des Parameters LRS-Netzwerk nicht unterstützt.

• Z-Werte werden bei der Berechnung der geometrischen Länge der Mittelachsen berücksichtigt.

• Regeln für die Lückenkalibrierung werden eingehalten, wenn Kalibrierungspunkte mit den Optionen Geometrielänge und Attributfelder des Parameters Kalibrierungsmethode generiert werden.

  Erfahren Sie mehr über das Kalibrieren von Routen mit physischen Lücken in ArcGIS Roads and Highways oder das Kalibrieren von Routen mit physischen Lücken in ArcGIS Pipeline Referencing.

• Wenn der Parameter Kalibrierungsmethode auf M auf Route festgelegt ist, werden die M-Werte am Startstützpunkt und am Endstützpunkt der Eingaberouten verwendet, um Start- und Endkalibrierungspunkte zu erstellen.

• Wenn der Parameter Kalibrierungsmethode auf Attributfelder festgelegt ist, geschieht Folgendes:

  • Die Option Attributfelder wird verwendet, um Felder mit dem Feldtyp Double für die Kalibrierung auszuwerten.
  • Der Wert des Parameters Von-Messwertfeld wird verwendet, um den Von-Messwert der Route anzugeben, und der Wert des Parameters Bis-Messwertfeld wird verwendet, um den Bis-Messwert der Route anzugeben.

• Der Parameterwert Eingabe-Polylinien-Features kann ein Feature-Service-Layer ohne lineare Referenzierung sein. Wenn der Parameterwert Calibration-Point-Feature-Class ein Feature-Service-Layer ist, muss die lineare Referenzierung aktiviert sein.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Polylinien-Features	Die Features, die als Quelle für die Berechnung der Messwerte für die Kalibrierungspunkte verwendet werden.	Feature Layer
Routen-ID-Feld	Mit den in diesem Feld gespeicherten Werten werden die einzelnen Routen eindeutig gekennzeichnet. Der Feldtyp muss mit dem Feld Route ID in der Feature-Class für Kalibrierungspunkte übereinstimmen.	Field
Feld für Von-Datum	Das Feld, das die Werte für das Von-Datum einer Route enthält.	Field
Feld für Bis-Datum	Das Feld, das die Werte für das Bis-Datum einer Route enthält.	Field
Feature-Class für Kalibrierungspunkte	Die vorhandene Feature-Class für Kalibrierungspunkte, der die neuen Features hinzugefügt werden.	Feature Layer
LRS-Netzwerk	Das LRS-Netzwerk, für das die Messwerte in der Feature-Class für Kalibrierungspunkte generiert werden.	String
Kalibrierungsrichtung (optional)	Gibt die Richtung zunehmender Kalibrierung auf einer Route an, wenn Kalibrierungspunkte erstellt werden. Digitalisierrichtung—Die Richtung der Digitalisierung der einzelnen Polylinien-Features bestimmen die Richtung der Kalibrierung für die Route. Dies ist die Standardeinstellung. Messrichtung—Die Richtung der zunehmenden M-Werte der einzelnen Polylinien-Features bestimmen die Richtung der Kalibrierung für die Route.Wenn die einzelnen Polylinien-Features keine M-Werte enthalten, wird die Digitalisierrichtung verwendet.	String
Kalibrierungsmethode (optional)	Gibt die Methode an, die verwendet wird, um beim Erstellen von Kalibrierungspunkten die Messwerte auf einer Route zu bestimmen. Geometrielänge—Die geometrische Länge des Eingabe-Routen-Features wird als Kalibrierungsmethode verwendet. Dies ist die Standardeinstellung. M auf Route—Die Messwerte auf dem Eingabe-Routen-Feature werden als Kalibrierungsmethode verwendet. Attributfelder—Die in Attributfeldern des Eingabe-Routen-Features gespeicherten Messwerte werden als Kalibrierungsmethode verwendet.	String
Von-Messwertfeld (optional)	Das Feld, das den Von-Messwert für die ausgewählte Route enthält. Dieser Parameter ist aktiv, wenn der Parameter Kalibrierungsmethode auf Attributfelder festgelegt wurde.	Field
Bis-Messwertfeld (optional)	Das Feld, das den Bis-Messwert für die ausgewählte Route enthält. Dieser Parameter ist aktiv, wenn der Parameter Kalibrierungsmethode auf Attributfelder festgelegt wurde.	Field

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Feature-Class für Kalibrierungspunkte	Die aktualisierten Kalibrierungs-Features.	Feature Layer
Datei für Ausgabedetails	Eine Textdatei, die Details zu den vom Werkzeug vorgenommenen Änderungen enthält.	Text File

Python

arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, {calibration_direction}, {calibration_method}, {from_measure_field}, {to_measure_field})

Name	Erläuterung	Datentyp
in_polyline_features	Die Features, die als Quelle für die Berechnung der Messwerte für die Kalibrierungspunkte verwendet werden.	Feature Layer
route_id_field	Mit den in diesem Feld gespeicherten Werten werden die einzelnen Routen eindeutig gekennzeichnet. Der Feldtyp muss mit dem Feld Route ID in der Feature-Class für Kalibrierungspunkte übereinstimmen.	Field
from_date_field	Das Feld, das die Werte für das Von-Datum einer Route enthält.	Field
to_date_field	Das Feld, das die Werte für das Bis-Datum einer Route enthält.	Field
in_calibration_point_feature_class	Die vorhandene Feature-Class für Kalibrierungspunkte, der die neuen Features hinzugefügt werden.	Feature Layer
lrs_network	Das LRS-Netzwerk, für das die Messwerte in der Feature-Class für Kalibrierungspunkte generiert werden.	String
calibration_direction (optional)	Gibt die Richtung zunehmender Kalibrierung auf einer Route an, wenn Kalibrierungspunkte erstellt werden. DIGITIZED_DIRECTION—Die Richtung der Digitalisierung der einzelnen Polylinien-Features bestimmen die Richtung der Kalibrierung für die Route. Dies ist die Standardeinstellung. MEASURE_DIRECTION—Die Richtung der zunehmenden M-Werte der einzelnen Polylinien-Features bestimmen die Richtung der Kalibrierung für die Route.Wenn die einzelnen Polylinien-Features keine M-Werte enthalten, wird die Digitalisierrichtung verwendet.	String
calibration_method (optional)	Gibt die Methode an, die verwendet wird, um beim Erstellen von Kalibrierungspunkten die Messwerte auf einer Route zu bestimmen. GEOMETRY_LENGTH—Die geometrische Länge des Eingabe-Routen-Features wird als Kalibrierungsmethode verwendet. Dies ist die Standardeinstellung. M_ON_ROUTE—Die Messwerte auf dem Eingabe-Routen-Feature werden als Kalibrierungsmethode verwendet. ATTRIBUTE_FIELDS—Die in Attributfeldern des Eingabe-Routen-Features gespeicherten Messwerte werden als Kalibrierungsmethode verwendet.	String
from_measure_field (optional)	Das Feld, das den Von-Messwert für die ausgewählte Route enthält. Dieser Parameter wird aktiviert, wenn der Parameter calibration_method auf ATTRIBUTE_FIELDS gesetzt ist.	Field
to_measure_field (optional)	Das Feld, das den Bis-Messwert für die ausgewählte Route enthält. Dieser Parameter wird aktiviert, wenn der Parameter calibration_method auf ATTRIBUTE_FIELDS gesetzt ist.	Field

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_calibration_point_feature_class	Die aktualisierten Kalibrierungs-Features.	Feature Layer
out_details_file	Eine Textdatei, die Details zu den vom Werkzeug vorgenommenen Änderungen enthält.	Text File

Codebeispiel

GenerateCalibrationPoints: Beispiel 1 (Python-Fenster)

Mit dem folgenden Python-Fenster-Skript wird veranschaulicht, wie die Funktion GenerateCalibrationPoints im Python-Fenster verwendet wird.

# Name: GenerateCalibrationPoints.py
# Description: Build calibration point features when an LRS already exists in the geodatabase.
# Requires: ArcGIS Location Referencing

# Tool variables:
in_polyline_features = "SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = "Calibration_Point"
lrs_network = "NonLineNetwork"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Set current workspace
arcpy.env.workspace = r"C:\Data\UPDM.gdb"

# Execute Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, 
                                       to_date_field, in_calibration_point_feature_class, 
                                       lrs_network, calibration_direction, calibration_method)

GenerateCalibrationPoints: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion GenerateCalibrationPoints verwendet wird.

# Name: GenerateCalibrationPoints.py
# Description: Build calibration point features when an LRS already exists in the geodatabase.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
in_polyline_features = r"C:\Data\SourceData.gdb\LRS\SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = r"C:\\Data\UPDM.gdb\LRS\Calibration_Point"
lrs_network = "EngineeringNetwork"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Process: Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, 
                                       to_date_field, in_calibration_point_feature_class, 
                                       lrs_network, calibration_direction, calibration_method)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

GenerateCalibrationPoints: Beispiel 3 (eigenständiges Skript)

Das folgende -Skript veranschaulicht, wie die Funktion GenerateCalibrationPoints verwendet wird, um Kalibrierungspunkte in einem vorhandenen Feature-Service zu erstellen.

# Name: GenerateCPs_Pro_standalone_fs.py
# Description: Build calibration point features in an existing feature service.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing"

# Local variables:
in_polyline_features = r"C:\Data\SourceData.gdb\LRS\SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Input LRS route network is in feature service.  Signing in portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the calibration point layer from the feature service. Here, 5 corresponds to the calibration point layer.
lrs_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Execute the tool
arcpy.locref.GenerateCalibrationPoints(in_calibration_point_feature_class)

# Process: Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, 
                                       to_date_field, in_calibration_point_feature_class, 
                                       lrs_network, calibration_direction, calibration_method)
                                                         
## Check in license
arcpy.CheckInExtension('LocationReferencing')

Umgebungen

Aktueller Workspace, Faktor für parallele Verarbeitung

Sonderfälle

Faktor für parallele Verarbeitung

Wenn Sie den Wert leer lassen, wird der Standardwert (0%) für diese Umgebung verwendet. Absolute Werte für diese Umgebung werden immer auf Werte zwischen 0 und der Anzahl der logischen Kerne im jeweiligen Computer festgelegt.

Lizenzinformationen

• Basic: Erfordert ArcGIS Location Referencing (ArcGIS Pipeline Referencing oder ArcGIS Roads and Highways)
• Standard: Erfordert ArcGIS Location Referencing (ArcGIS Pipeline Referencing oder ArcGIS Roads and Highways)
• Advanced: Erfordert ArcGIS Location Referencing (ArcGIS Pipeline Referencing oder ArcGIS Roads and Highways)