Objektmesswerte ableiten (Location Referencing Tools)

Zusammenfassung

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

Verwendung

Zur Ausführung dieses Werkzeugs ist ein LRS-Dataset erforderlich.
- Weitere Informationen zum Erstellen eines LRS-Datasets in ArcGIS Pipeline Referencing
- Weitere Informationen 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 generieren 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.
  
  Erfahren Sie mehr über die Konfliktvermeidung in Pipeline Referencing oder die 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 benannten Version behalten die abgerufenen Sperren nach Abschluss des Werkzeugs den Status "Beim Zurückschreiben" bei. Sie müssen die Version zurückschreiben oder löschen, um die Sperren aufzuheben.
- Wenn beim Arbeiten in einer benannten Version die Ausführung des Werkzeugs durch eine Unterbrechung abgebrochen wird, behalten die abgerufenen Sperren den Status "Aufhebbar" bei.

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 in mindestens eine Stunde zu ändern.	Text File

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 in 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 Direkt-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"

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

DeriveEventMeasures: Beispiel 2 (eigenständiges Skript)

Im folgenden eigenständigen Python-Skript wird veranschaulicht, wie Sie die Funktion DeriveEventMeasures verwenden.

# 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

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

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

DeriveEventMeasures: Beispiel 3 (eigenständiges Skript)

Im folgenden eigenständigen Python-Skript wird veranschaulicht, wie Sie die Funktion DeriveEventMeasures in einem Feature-Service verwenden.

# 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

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

Umgebungen

Aktueller Workspace

Lizenzierungsinformationen

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)

Objektmesswerte ableiten (Location Referencing Tools)

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Hinweis:

Umgebungen

Lizenzierungsinformationen

Verwandte Themen