Messwerte aus LRS aktualisieren (Location Referencing)

Mit der Location Referencing-Lizenz verfügbar.

Zusammenfassung

Füllt oder aktualisiert die Messwerte und Routen-IDs von Utility Network-Features (UN), beispielsweise Rohre, Geräte und Knoten, oder von Features in Feature-Classes, bei denen es sich nicht um UN- oder LRS-Feature-Classes handelt.

Dieses Werkzeug findet geeignete Routen über den Parameter LRS-Netzwerk, ruft die Messwerte dieser Route ab und füllt oder aktualisiert den Messwert und Routenattribute für die Features in der nonLRS-Feature-Class.

Hinweis:

Für die Verwendung dieses Werkzeugs ist die Erweiterung ArcGIS Pipeline Referencing oder ArcGIS Roads and Highways erforderlich, wenn Datasets aus einem Feature-Service verwendet werden.

Verwendung

• Ab ArcGIS Pro 3.1 unterstützt dieses Werkzeug direkte Verbindungen (Client- und Serververbindungen) unter Verwendung von Verzweigungsversionierung sowie zuvor unterstützte Verbindungen über einen Feature-Service unter Verwendung von Verzweigungsversionierung.

• Die Feldeigenschaften der Parameter Eingabe-Features und LRS-Netzwerk müssen übereinstimmen.

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

• Ein Textprotokoll wird lokal geschrieben und gibt an, dass das Werkzeug ausgeführt wurde, und enthält Folgendes:

  • Informationen zu Eingabe-Features, deren Validierung fehlgeschlagen ist
  • Die Routen-ID und Messwerte für die aktualisierten Eingabe-Features von vor und nach der Aktualisierung

• Der Wert der Eingabe-Features muss exakt lagegleich mit den Features des LRS-Netzwerks sein.

  Die folgenden Diagramme und Tabellen zeigen, wie Linien- und Punkt-Features aus den Werten der Eingabe-Features, die keine LRS-Feature-Classes, aber lagegleich mit Route1 in den Features des LRS-Netzwerks sind, aktualisiert werden:

  

  Eingabe-Layer	Feature-Typ	Routen-ID	Von-Messwert	Bis-Messwert	Kommentare
  NonLRS-Eingabe-Layer	Linie	Route1	11	18	Die Geometrie des Linien-Features hat eine geometrische Übereinstimmung mit dem LRS-Netzwerk.

  

  Eingabe-Layer	Feature-Typ	Routen-ID	Von-Messwert	Bis-Messwert	Kommentare
  NonLRS-Eingabe-Layer	Punkt	Route1	21		Das Punkt-Feature ist lagegleich mit der Route auf dem Wert LRS-Netzwerk.

  

  Eingabe-Layer	Feature-Typ	Routen-ID	Von-Messwert	Bis-Messwert	Kommentare
  NonLRS-Eingabe-Layer	Linie				Die Geometrie des Linien-Features ist nicht lagegleich mit dem Eingabe-Netzwerk. Keine Informationen werden zurückgegeben.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
LRS-Netzwerk	Der Feature-Layer, der die Routen, Routen-IDs und Messwerte enthält.	Feature Layer
LRS-Datum	Das Datum, mit dem die Zeitdatenansicht des Netzwerks zum Erfassen der Route und der Messwerte definiert wurde.	Date
Eingabe-Features	Der Layer, der die Routen-ID und die Messwertfelder enthält, die basierend auf der Feature-Geometrie relativ zu Routen im Parameter LRS-Netzwerk aktualisiert werden.	Feature Layer
Routen-ID-Feld	Das Feld im Layer Eingabe-Features, das den Routen-ID-Wert enthält.	Field
Messwertfeld	Das Feld im Layer Eingabe-Features, das den Von-Messwert für Polylinien-Features enthält.	Field
Bis-Messwertfeld (optional)	Das Feld im Layer Eingabe-Features, das den Messwert für Punkt-Features oder den Bis-Messwert für Polylinien-Feature enthält.	Field

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Datei für Ausgabedetails	Die Ausgabe-Protokolldatei, die die aktualisierten Features aus dem Parameter Eingabe-Features auflistet. Diese Protokolldatei enthält die Werte vor und nach der Routen-ID sowie die Von-Messwert- und Bis-Messwertfelder für jedes aktualisierte Feature.	Text 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})

Name	Erläuterung	Datentyp
lrs_network	Der Feature-Layer, der die Routen, Routen-IDs und Messwerte enthält.	Feature Layer
lrs_date	Das Datum, mit dem die Zeitdatenansicht des Netzwerks zum Erfassen der Route und der Messwerte definiert wurde.	Date
in_features	Der Layer, der die Routen-ID und die Messwertfelder enthält, die basierend auf der Feature-Geometrie relativ zu Routen im Parameter lrs_network aktualisiert werden.	Feature Layer
route_id_field	Das Feld im Layer in_features, das den Routen-ID-Wert enthält.	Field
from_measure_field	Das Feld im Layer in_features, das den Von-Messwert für Polylinien-Features enthält.	Field
to_measure_field (optional)	Das Feld im Layer in_features, das den Messwert für Punkt-Features oder den Bis-Messwert für Polylinien-Feature enthält.	Field

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_details_file	Die Ausgabe-Protokolldatei, die die aktualisierten Features aus dem Parameter in_features auflistet. Diese Protokolldatei enthält die Werte vor und nach der Routen-ID sowie die Von-Messwert- und Bis-Messwertfelder für jedes aktualisierte Feature.	Text 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"

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

UpdateMeasuresFromLRS – Beispiel 2 (eigenständiges Skript)

Dieses Codebeispiel veranschaulicht, wie die Funktion UpdateMeasuresFromLRS als eigenständiges Python-Skript in einem Feature-Service 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"

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

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

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

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)