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.

Verwendung

  • Ab ArcGIS Pro 3.3 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:

    Beispiel für das Aktualisieren der Routen-ID-Messwerte mithilfe eines Linien-Features

    Eingabe-LayerFeature-TypRouten-IDVon-MesswertBis-MesswertKommentare

    NonLRS-Eingabe-Layer

    Linie

    Route1

    11

    18

    Die Geometrie des Linien-Features hat eine geometrische Übereinstimmung mit dem LRS-Netzwerk.

    Beispiel für das Aktualisieren der Routen-ID-Messwerte mithilfe eines Punkt-Features

    Eingabe-LayerFeature-TypRouten-IDVon-MesswertBis-MesswertKommentare

    NonLRS-Eingabe-Layer

    Punkt

    Route1

    21

    Das Punkt-Feature ist lagegleich mit der Route auf dem Wert LRS-Netzwerk.

    Beispiel für Routen-ID-Messwerte, die nicht aktualisiert werden können, weil das Linien-Feature nicht exakt lagegleich mit dem LRS-Netzwerk ist

    Eingabe-LayerFeature-TypRouten-IDVon-MesswertBis-MesswertKommentare

    NonLRS-Eingabe-Layer

    Linie

    Die Geometrie des Linien-Features ist nicht lagegleich mit dem Eingabe-Netzwerk. Keine Informationen werden zurückgegeben.

Parameter

BeschriftungErläuterungDatentyp
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

BeschriftungErläuterungDatentyp
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

arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, {to_measure_field})
NameErläuterungDatentyp
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

NameErläuterungDatentyp
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')

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)

Verwandte Themen