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. Zum Erstellen eines LRS-Datasets fügen Sie die Kalibrierungspunkt-, Mittelachsen- und Korrekturlinien-Layer einem Feature-Dataset hinzu, und fügen Sie dann das Werkzeug LRS ändern mit der Geodatabase als Eingabe aus.

• 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, verwendet das Werkzeug die M-Werte am Startstützpunkt und am Endstützpunkt der Eingaberouten, um Start- und Endkalibrierungspunkte zu erstellen.

• Wenn der Parameter Kalibrierungsmethode auf Attributfelder festgelegt ist, geht das Werkzeug wie folgt vor:

  • Felder mit dem Feldtyp "Double" werden für die Kalibrierung mithilfe der Methode Attributfelder ausgewertet.
  • 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.

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 für den Wert des Parameters Eingabe-Polylinien-Features bestimmt die Richtung der Kalibrierung für die Route. Dies ist die Standardeinstellung. Messrichtung—Die Richtung der zunehmenden M-Werte für den Wert des Parameters Eingabe-Polylinien-Features bestimmt die Richtung der Kalibrierung für die Route.Wenn der Wert des Parameters Eingabe-Polylinien-Features keine M-Werte enthält, wird stattdessen 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 neue Kalibrierungspunkte erstellt werden. DIGITIZED_DIRECTION—Die Richtung der Digitalisierung für den Wert des Parameters in_polyline_features bestimmt die Richtung der Kalibrierung für die Route. Dies ist die Standardeinstellung. MEASURE_DIRECTION—Die Richtung der zunehmenden M-Werte für den Wert des Parameters in_polyline_features bestimmt die Richtung der Kalibrierung für die Route.Wenn der Wert des Parameters in_polyline_features keine M-Werte enthält, wird stattdessen 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 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

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')

Umgebungen

Aktueller Workspace, Faktor für parallele Verarbeitung

Sonderfälle

Faktor für parallele Verarbeitung

Wenn Sie den Wert leer lassen, wird der Standardwert (100 %) 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
• Standard: Erfordert ArcGIS Location Referencing
• Advanced: Erfordert ArcGIS Location Referencing