Messwerte aus LRS aktualisieren (Location Referencing)

Mit der Location Referencing-Lizenz verfügbar.

Zusammenfassung

Füllt die Routen- und Messwertattribute für beliebige Punkt- oder Linien-Features auf oder aktualisiert sie, einschließlich Utility Network-Features wie Rohre, Bauteile und Knoten oder LRS-Features wie Objekte und Schnittpunkte.

Zu den aktualisierten Attributen gehören die Routen-ID, der Routenname (falls konfiguriert) und die Messwerte.

Verwendung

• Dieses Werkzeug unterstützt Daten aus einer File-Geodatabase, einer Enterprise-Geodatabase (nach Verzweigung versioniert) oder einem Feature-Service (veröffentlicht aus nach Verzweigung versionierten Daten).

• Raumbezug, XY-Auflösung und XY-Toleranz der Parameterwerte Eingabe-Features und LRS-Netzwerk müssen übereinstimmen.

• Die Parameter Bis-Routen-ID-Feld und Feld für Bis-Routenname sind optional und gelten für Features, die sich über mehrere Routen erstrecken.

• Der Parameter Suchtoleranz wird verwendet, um die Routen- und Messwertattribute der Eingabe-Features zu aktualisieren, wenn sie nicht lagegleich mit einer Route sind.

  • Zur Aktualisierung der Eingabe-Features werden die Route und die Messwerte der nächstgelegenen Route verwendet, die innerhalb der Suchtoleranz verfügbar ist.
  • Wenn zwei oder mehr Routen gleich weit von einem eingegebenen Feature entfernt sind, wird eine beliebige dieser Routen für die Aktualisierung verwendet.
  • Wenn es sich bei dem Eingabe-Feature um ein Linien-Feature handelt, werden die Routen- und Messwertattribute nur dann ausgefüllt, wenn sich der Start- und Endpunkt des Linien-Features innerhalb der Suchtoleranz einer Route befinden.

• Die folgenden Diagramme und Tabellen zeigen, wie die Features für Punkt- und Linien-Eingaben aktualisiert werden:

  

  Aktualisierte Routen- und Messwertattribute im Eingabe-Layer

  Feature-Typ	Routen-ID	Von-Messwert	Bis-Messwert	Kommentare
  Linie	Route1	11	17	Die Geometrie des Linien-Features hat eine geometrische Übereinstimmung mit "Route1".

  

  Aktualisierte Routen- und Messwertattribute im Eingabe-Layer

  Feature-Typ	Routen-ID	Messen	Kommentare
  Punkt	Route1	21	Das Punkt-Feature befindet sich auf "Route1".

  

  Aktualisierte Routen- und Messwertattribute im Eingabe-Layer

  Feature-Typ	Routen-ID	Messen	Kommentare
  Punkt	Route1	21	Das Punkt-Feature befindet sich nicht auf "Route1". Durch die Angabe einer Suchtoleranz werden die Routen- und Messwertattribute anhand der nächstgelegenen Route aktualisiert.

  

  Aktualisierte Routen- und Messwertattribute im Eingabe-Layer

  Feature-Typ	Routen-ID	Routenname	Von-Messwert	Bis-Routen-ID	Bis-Routenname	Bis-Messwert	Kommentare
  Linie	Route1	L1R1	11	Route2	L1R2	28	Die Geometrie des Linien-Features stimmt geometrisch mit den Routen "L1R1" und "L1R2" überein, die zur selben Linie gehören.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
LRS-Netzwerk	Der Feature-Layer, der die Routen, Routen-IDs, Routennamen (sofern konfiguriert) und Messwerte enthält.	Feature Layer
LRS-Datum	Das Datum, mit dem die Zeitdatenansicht des Netzwerks definiert wird.	Date
Eingabe-Features	Die Punkt- oder Linien-Features, die basierend auf der Feature-Geometrie in Bezug auf die Routen im LRS-Netzwerk aktualisiert werden.	Feature Layer
Routen-ID-Feld	Das Feld im Parameterwert Eingabe Features, das das Routen-ID-Attribut enthält. Der Datentyp und die Länge des Feldes müssen mit denen des entsprechenden Feldes im LRS-Netzwerk übereinstimmen.	Field
Messwertfeld	Das Feld im Parameterwert Eingabe-Features, das den Messwert für Punkt-Features oder den Startmesswert für Linien-Features enthält. Der Datentyp und die Länge des Feldes müssen mit denen des entsprechenden Feldes im LRS-Netzwerk übereinstimmen.	Field
Bis-Messwertfeld (optional)	Das Feld im Parameterwert Eingabe-Features, das den Endmesswert für Linien-Features enthält. Der Datentyp und die Länge des Feldes müssen mit denen des entsprechenden Feldes im LRS-Netzwerk übereinstimmen.	Field
Bis-Routen-ID-Feld (optional)	Das Feld im Parameterwert Eingabe Features, das das Bis-Routen-ID-Attribut enthält. Dieser Parameter ist nur verfügbar, wenn der Parameterwert Eingabe-Features ein Linien-Feature-Layer ist. Der Datentyp und die Länge des Feldes müssen mit denen des entsprechenden Feldes im LRS-Netzwerk übereinstimmen.	Field
Feld für Routenname (optional)	Das Feld im Parameterwert Eingabe Features, das das Routennamenattribut enthält. Dieser Parameter ist nur verfügbar, wenn für das LRS-Netzwerk ein Routenname konfiguriert wurde. Der Datentyp und die Länge des Feldes müssen mit denen des entsprechenden Feldes im LRS-Netzwerk übereinstimmen.	Field
Feld für Bis-Routenname (optional)	Das Feld im Parameterwert Eingabe Features, das das Bis-Routennamenattribut enthält. Dieser Parameter ist nur verfügbar, wenn für das LRS-Netzwerk ein Routenname konfiguriert ist und der Parameterwert Eingabe-Features ein Linien-Feature-Layer ist. Der Datentyp und die Länge des Feldes müssen mit denen des entsprechenden Feldes im LRS-Netzwerk übereinstimmen.	Field
Suchtoleranz (optional)	Die Routen, die innerhalb der Suchtoleranz des Eingabe-Features liegen, werden identifiziert. Zur Aktualisierung der Eingabe-Features werden die Route und die Messwerte der nächstgelegenen Route verwendet, die innerhalb der Suchtoleranz verfügbar ist. Die Einheit für die Suchtoleranz basiert auf der XY-Einheit des LRS-Netzwerks.	Double

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Datei für Ausgabedetails	Die Ausgabe-.csv-Datei, die die aktualisierten Eingabe-Features auflistet. Diese .csv-Datei enthält die Routen-ID, den Routennamen (falls konfiguriert) und die Messwertattribute jedes aktualisierten Features vor und nach der Aktualisierung.	File
Ausgabe-Features	Der aktualisierte Feature-Layer. Hinweis: Die Validierungsergebnisse für dieses Werkzeug werden in das ArcGIS Server-Verzeichnis geschrieben. Diese Datei wird standardmäßig automatisch in 10 Minuten bereinigt. Das ist möglicherweise nicht ausreichend, um alle Validierungen zu verarbeiten und auf die Workstation mit ArcGIS Pro zu schreiben. Bei größeren Datenlasten empfiehlt es sich, das maximale Dateialter auf mindestens eine Stunde zu ändern.	Feature Layer

Python

arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, {to_measure_field}, {to_route_id_field}, {route_name_field}, {to_route_name_field}, {search_tolerance})

Name	Erläuterung	Datentyp
lrs_network	Der Feature-Layer, der die Routen, Routen-IDs, Routennamen (sofern konfiguriert) und Messwerte enthält.	Feature Layer
lrs_date	Das Datum, mit dem die Zeitdatenansicht des Netzwerks definiert wird.	Date
in_features	Die Punkt- oder Linien-Features, die basierend auf der Feature-Geometrie in Bezug auf die Routen im LRS-Netzwerk aktualisiert werden.	Feature Layer
route_id_field	Das Feld im Parameterwert in_features, das das Routen-ID-Attribut enthält. Der Datentyp und die Länge des Feldes müssen mit denen des entsprechenden Feldes im LRS-Netzwerk übereinstimmen.	Field
from_measure_field	Das Feld im Parameterwert in_features, das den Messwert für Punkt-Features oder den Startmesswert für Linien-Features enthält. Der Datentyp und die Länge des Feldes müssen mit denen des entsprechenden Feldes im LRS-Netzwerk übereinstimmen.	Field
to_measure_field (optional)	Das Feld im Parameterwert in_features, das den Endmesswert für Linien-Features enthält. Der Datentyp und die Länge des Feldes müssen mit denen des entsprechenden Feldes im LRS-Netzwerk übereinstimmen.	Field
to_route_id_field (optional)	Das Feld im Parameterwert in_features, das das Routen-ID-Attribut enthält. Dieser Parameter ist nur verfügbar, wenn der Parameterwert in_features ein Linien-Feature-Layer ist. Der Datentyp und die Länge des Feldes müssen mit denen des entsprechenden Feldes im LRS-Netzwerk übereinstimmen.	Field
route_name_field (optional)	Das Feld im Parameterwert in_features, das das Routennamenattribut enthält. Dieser Parameter ist nur verfügbar, wenn für das LRS-Netzwerk ein Routenname konfiguriert wurde. Der Datentyp und die Länge des Feldes müssen mit denen des entsprechenden Feldes im LRS-Netzwerk übereinstimmen.	Field
to_route_name_field (optional)	Das Feld im Parameterwert in_features, das das Bis-Routennamenattribut enthält. Dieser Parameter ist nur verfügbar, wenn für das LRS-Netzwerk ein Routenname konfiguriert ist und der Parameterwert in_features ein Linien-Feature-Layer ist. Der Datentyp und die Länge des Feldes müssen mit denen des entsprechenden Feldes im LRS-Netzwerk übereinstimmen.	Field
search_tolerance (optional)	Die Routen, die innerhalb der Suchtoleranz des Eingabe-Features liegen, werden identifiziert. Zur Aktualisierung der Eingabe-Features werden die Route und die Messwerte der nächstgelegenen Route verwendet, die innerhalb der Suchtoleranz verfügbar ist. Die Einheit für die Suchtoleranz basiert auf der XY-Einheit des LRS-Netzwerks.	Double

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_details_file	Die Ausgabe-.csv-Datei, die die aktualisierten Eingabe-Features auflistet. Diese .csv-Datei enthält die Routen-ID, den Routennamen (falls konfiguriert) und die Messwertattribute jedes aktualisierten Features vor und nach der Aktualisierung.	File
out_features	Der aktualisierte Feature-Layer. Hinweis: Die Validierungsergebnisse für dieses Werkzeug werden in das ArcGIS Server-Verzeichnis geschrieben. Diese Datei wird standardmäßig automatisch in 10 Minuten bereinigt. Das ist möglicherweise nicht ausreichend, um alle Validierungen zu verarbeiten und auf die Workstation mit ArcGIS Pro zu schreiben. Bei größeren Datenlasten empfiehlt es sich, das maximale Dateialter auf mindestens eine Stunde zu ändern.	Feature Layer

Codebeispiel

UpdateMeasuresFromLRS: Beispiel 1 (Python-Fenster)

Dieses Codebeispiel veranschaulicht, wie die Funktion UpdateMeasuresFromLRS im Python-Fenster verwendet wird.

# Name: UpdateMeasuresFromLRS_Sample1.py
# Description: This will populate the Route ID and measures in the input layer based on overlapping routes from the network layer. 
# The output is the input layer with the updated Route ID and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing

# Variables are supported from feature service only. Signing into Portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the lrs network from the feature service. Here, 8 corresponds to the lrs route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date = "10/8/2019"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"
to_route_id_field = None
route_name_field = None
to_route_name_field = None
search_tolerance = None

# Execute the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field, to_route_id_field, route_name_field, to_route_name_field, search_tolerance)

UpdateMeasuresFromLRS: Beispiel 2 (eigenständiges Skript)

Dieses Codebeispiel veranschaulicht, wie die Funktion UpdateMeasuresFromLRS in einem eigenständigen Python-Skript verwendet wird.

# Name: UpdateMeasuresFromLRS_Sample2.py
# Description: Populate the route ID and measures in the input layer based on overlapping routes from the network layer. 
# The output is the input layer with the updated route ID and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing
 
# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Variables are supported from feature service only. Portal signin is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Initialize variables
# Map the lrs network from the feature service. Here, 8 corresponds to the LRS route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date= "10/8/2019"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"
to_route_id_field = None
route_name_field = None
to_route_name_field = None
search_tolerance = None

# Execute the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field, to_route_id_field, route_name_field, to_route_name_field, search_tolerance)

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

UpdateMeasuresFromLRS: Beispiel 3 (Python-Fenster)

Dieses Codebeispiel veranschaulicht, wie die Funktion UpdateMeasuresFromLRS im Python-Fenster für überspannende Features verwendet wird.

# Name: UpdateMeasuresFromLRS_sample3.py
# Description: This will populate the Route ID, Route Name, and measures in the input layer based on overlapping routes from the network layer. 
# The output is the input layer with the updated Route ID, Route Name and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing

# Variables are supported from feature service only. Signing into Portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the lrs network from the feature service. Here, 8 corresponds to the lrs route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input spannning feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date = "12/31/2024"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"
to_route_id_field = "TOROUTEID"
route_name_field = "RteName"
to_route_name_field = "ToRteName"
search_tolerance = None

# Execute the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field, to_route_id_field, route_name_field, to_route_name_field, search_tolerance)

Umgebungen

Aktueller Workspace

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)