Objektmesswerte ableiten (Location Referencing)

Zusammenfassung

Füllt und aktualisiert das Feld DerivedRouteID sowie Messwerte von Punkt- und Linienobjekten, für die diese Felder konfiguriert und aktiviert sind.

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

• Dieses Werkzeug ist für die Ausführung im Rahmen eines umfangreicheren Workflows gedacht. Führen Sie die Werkzeuge Objektverhalten übernehmen und Routen erstellen aus, bevor Sie Objektmesswerte ableiten ausführen. Wenn Sie dieses Werkzeug ausführen, ohne die vorherigen Werkzeuge im Workflow auszuführen, erhalten Sie möglicherweise ungenaue Daten.

• Es wird empfohlen, dieses Werkzeug bei der anfänglichen Migration der Daten für die File-Geodatabase auszuführen. Auf diese Weise wird das Werkzeug schneller ausgeführt, da bei diesem Vorgang jeder Objektdatensatz in der Datenbank geändert werden muss. In der Produktion kann das Werkzeug für einen Auswahlsatz der geänderten Routen ausgeführt werden, um die Ausführung erheblich zu beschleunigen.

• Für den als Eingabe verwendeten Objekt-Feature-Layer müssen das Feld DerivedRouteID und Messwertfelder konfiguriert sein.

• Auswahlsätze für den Eingabe-Routen-Feature-Layer werden berücksichtigt.

• Auswahlsätze in Objekt-Layern werden nicht berücksichtigt.

• Das Werkzeug kann für ein Objekt, mehrere Objekte oder alle Objekte in einem Liniennetzwerk ausgeführt werden.

• Dieses Werkzeug unterstützt die Konfliktvermeidung und versucht, Sperren anzufordern und zu übertragen.

• Wenn die Konfliktvermeidung aktiviert ist, wird Folgendes unterstützt:

  • Für die Objekte, deren abgeleitete Objektmesswerte aktualisiert werden müssen, werden automatisch Objektsperren abgerufen, wenn diese verfügbar sind. Wenn die Sperren nicht abgerufen werden können, gibt das Werkzeug einen Fehler zurück und stellt eine Textdatei mit den entsprechenden Sperren bereit.

    Weitere Informationen zur Konfliktvermeidung in Pipeline Referencing oder Konfliktvermeidung in Roads and Highways

  • Beim Arbeiten in der Default-Version werden die abgerufenen Sperren nach Abschluss des Werkzeugs automatisch aufgehoben.
  • Beim Arbeiten in einer Child-Version behalten die abgerufenen Sperren nach Abschluss des Werkzeugs den Status "Zurückschreiben" bei. Die Benutzer müssen die Version zurückschreiben oder löschen, um die Sperren aufzuheben.
  • Wenn beim Arbeiten in einer Child-Version die Ausführung des Werkzeugs durch eine Unterbrechung abgebrochen wird, behalten die abgerufenen Sperren den Status "Aufhebbar" bei.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Routen-Features	Das LRS-Netzwerk, das die Objekte enthält, für die das Feld DerivedRouteID und Messwertfelder konfiguriert sind.	Feature Layer
Alle im ausgewählten Netzwerk registrierten Event-Feature-Classes aktualisieren (optional)	Gibt an, ob alle Event-Feature-Classes im Netzwerk aktualisiert werden. Aktiviert: Alle Event-Feature-Classes im Netzwerk, die im Wert des Parameters Eingabe-Routen-Features ausgewählt sind, werden aktualisiert. Dies ist die Standardeinstellung. Deaktiviert: Alle Event-Feature-Classes im Netzwerk, die im Wert des Parameters Eingabe-Routen-Features ausgewählt sind, werden nicht aktualisiert. Mit dem Parameter Objekt-Layer können einzelne Objekt-Layer ausgewählt werden.	Boolean
Objekt-Layer (optional)	Die Objekt-Layer, für die das Feld DerivedRouteID und Messwertfelder aktualisiert werden.	Feature Layer

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabeobjekte	Der aktualisierte Objekt-Feature-Layer.	Feature Layer
Datei für Ausgabedetails	Die Textdatei mit Details zu den am Objekt-Feature-Layer vorgenommenen Änderungen. 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.	Text File

Python

arcpy.locref.DeriveEventMeasures(in_route_features, {update_all_events}, {event_layers})

Name	Erläuterung	Datentyp
in_route_features	Das LRS-Netzwerk, das die Objekte enthält, für die das Feld DerivedRouteID und Messwertfelder konfiguriert sind.	Feature Layer
update_all_events (optional)	Gibt an, ob alle Event-Feature-Classes im Netzwerk aktualisiert werden. UPDATE_ALL—Alle Event-Feature-Classes im Netzwerk, die im Wert des Parameters in_route_features ausgewählt sind, werden aktualisiert. Dies ist die Standardeinstellung. UPDATE_SOME—Alle Event-Feature-Classes im Netzwerk, die im Wert des Parameters in_route_features ausgewählt sind, werden nicht aktualisiert. Mit dem Parameter event_layers können einzelne Objekt-Layer ausgewählt werden.	Boolean
event_layers [event_layers,...] (optional)	Die Objekt-Layer, für die das Feld DerivedRouteID und Messwertfelder aktualisiert werden.	Feature Layer

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_events	Der aktualisierte Objekt-Feature-Layer.	Feature Layer
out_details_file	Die Textdatei mit Details zu den am Objekt-Feature-Layer vorgenommenen Änderungen. 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.	Text File

Codebeispiel

DeriveEventMeasures: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion DeriveEventMeasures im unmittelbaren Modus verwendet wird.

# Name: DeriveEventMeasures_ex1.py
# Description: Populate and update the Derived RouteID and measure values on point and line events with those fields configured and enabled in Python window.
# Requires: ArcGIS Location Referencing

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

# Local variables
in_route_features = "LineNetwork"
update_all_events = "UPDATE_SOME"
event_layers = "Casing, Coating"

# Execute the tool
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)

DeriveEventMeasures: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Python-Skript veranschaulicht, wie die Funktion DeriveEventMeasures verwendet wird.

# Name: DeriveEventMeasures_ex2.py
# Description: Populate and update the Derived routeID and measure values on point and line events with those fields configured and enabled in stand-alone script.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
update_all_events = "UPDATE_ALL"
event_layers = ""

# Execute the tool
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)

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

DeriveEventMeasures: Beispiel 3 (eigenständiges Skript)

Das folgende eigenständige Python-Skript veranschaulicht, wie die Funktion DeriveEventMeasures in einem Feature-Service verwendet wird.

# Name: DeriveEventMeasures_ex3.py
# Description: Populate and update Derived RouteID and measure values on point and line events with those fields configured and enabled in stand-alone script.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

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

# Input LRS Route Network is in feature service. Portal signin is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the input route network from the feature service. Here, 3 corresponds to the input route network.
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/3"

# Set tool variables.
update_all_events = "UPDATE_ALL"
event_layers = ""

# Process : Derive Event Measures.
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)

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

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)