Objektmesswerte übertragen (Location Referencing)

Mit der Location Referencing-Lizenz verfügbar.

Zusammenfassung

Überträgt die Messwerte (M-Werte) eines Punkt- oder Linienobjekt-Layers aus einer linearen Referenzierungsmethode (LRM) in eine andere.

Ein Anwendungsfall für dieses Werkzeug wäre die Übertragung von Objektdaten aus einem meilenbasierten in ein kilometerbasiertes Netzwerk.

Neben den Messwerten können sich auch die Routenzuordnungen der Objekt-Features in den beiden LRMs unterscheiden. Die Ausgabe dieses Werkzeugs ist eine Feature-Class mit den korrekten Messwerten und Routenzuordnungen des Ziel-LRS-Netzwerks.

Verwendung

  • Der Eingabeobjekt-Layer muss eine Point- oder Line-Feature-Class sein.

  • Beide Eingaben werden von diesem Werkzeug nicht geändert. Als Ausgabe wird eine Feature-Class erstellt.

  • Dieses Werkzeug unterstützt jeweils eine zeitliche Darstellung. Erstellen Sie eine zeitbasierte Definitionsabfrage, oder wenden Sie einen zeitbasierten Auswahlsatz auf den Eingabeobjekt-Layer sowie das Ziel-LRS-Netzwerk an, bevor Sie dieses Werkzeug ausführen. Der Zeitschieberegler in ArcGIS Pro kann ebenfalls verwendet werden, wenn die Zeit für beide Eingabe-Layer konfiguriert wird.

  • Dieses Werkzeug unterstützt das Übertragen von Objekten für Routen mit Lücken.

  • Wenn das Zielnetzwerk ein LRS-Liniennetzwerk (auch als technisches Netzwerk bezeichnet) ist, kann der Eingabeobjekt-Layer auch dann übertragen werden, wenn das ursprüngliche Netzwerk des Eingabeobjekt-Layers das Linienkonzept nicht unterstützt.

  • Der Typ der Ausgabe-Feature-Class (Line bzw. Point) muss mit dem Typ des Eingabeobjekt-Layers übereinstimmen.

  • Die Toleranz- und Auflösungseinstellungen für den Eingabeobjekt-Layer müssen mit denen des Ziel-LRS-Netzwerks übereinstimmen.

  • Zur Identifizierung von Übereinstimmungsbedingungen, die während der Übertragung auftreten, wird in der Ausgabe-Feature-Class ein Feld namens Loc_Error mit Werten wie Multi-Match, Partial Match, No Match und No Error erstellt.

  • Die Attributfelder des Eingabeobjekt-Layers werden in die Ausgabe-Feature-Class einbezogen.

  • Wenn das Ziel-LRS-Netzwerk parallele Routen enthält, verwenden Sie die Option Abgleich paralleler Routen.

  • Wenn für Abgleich paralleler Routen die Option Route mit übereinstimmender Routen-ID verwendet wird, muss der Eingabeobjekt-Layer als LRS-Objekt-Layer in ArcGIS Location Referencing registriert sein.

  • Dieses Werkzeug führt eine räumliche Überlagerung des Eingabeobjekt-Layers auf dem Ziel-LRS-Netzwerk durch, um Features für das Eingabeobjekt entlang des Zielnetzwerks zu generieren. Diese Features enthalten die Routen-ID und Messwertinformationen zu dieser Position auf der Route.

  • Der Eingabeobjekt-Layer und das Zielnetzwerk sollten lediglich einen einzelnen Zeitpunkt darstellen, um eine genaue Ausgabe zu erhalten. Wenn der Eingabeobjekt-Layer mehrere Zeitpunkte darstellt, setzen Sie mit dem Zeitschieberegler einen Filter, oder verwenden Sie eine Definitionsabfrage für die Datumsspalten.

  • Mit dem Werkzeug Objekte anhängen können die Ausgabedaten einem neuen oder vorhandenen LRS-Objekt hinzugefügt werden. Wenn im Eingabeobjekt-Layer mehrere zeitliche Darstellungen enthalten waren und das Werkzeug infolgedessen mehrmals mit unterschiedlichen Datumsfiltern ausgeführt wurde, können alle Ausgaben unter Verwendung von Objekte anhängen einer einzigen LRS-Event-Feature-Class hinzugefügt werden.

Parameter

BeschriftungErläuterungDatentyp
Quellobjekt-Layer

Der zu übertragende Eingabeobjekt-Layer.

Feature Layer
Eingabe-Features der Zielroute

Das Ziel-LRS-Netzwerk, für das die Eingabeobjekte übertragen werden.

Feature Layer
Ausgabeobjekt-Layer

Die Ausgabe-Feature-Class, in das die übertragenen Objekt-Features aufgenommen werden.

Feature Class
Abgleich paralleler Routen
(optional)

Gibt an, welche Methode verwendet wird, um zu ermitteln, für welche Route das Objekt übertragen werden soll, wenn im Ziel-LRS-Netzwerk parallele Routen vorhanden sind. Dieser Parameter wird nur angewendet, wenn die Position der Objektübertragung auf das Ziel-LRS-Netzwerk parallele Routen (Routen mit einer gemeinsamen Position) aufweist.

  • Beliebige parallele RouteDer Eingabeobjekt-Layer wird für die erste von zwei oder mehr im Ziel-LRS-Netzwerk gefundene parallele Routen übertragen.
  • Route mit übereinstimmender RouteIDDie Routen-ID des Quellobjekts wird mit den Routen-IDs paralleler Routen im Ziel-LRS-Netzwerk verglichen. Das Quellobjekt wird basierend auf Routen-ID-Übereinstimmungen im Quellobjekt und Zielnetzwerk übertragen. Die Routen-IDs des Eingabeobjekts und des Ziel-LRS-Netzwerks müssen exakt übereinstimmen, damit das Objekt mit dieser Methode korrekt übertragen wird. Für die Verwendung dieser Methode muss der Eingabeobjekt-Layer ebenfalls ein registriertes LRS-Objekt sein.
  • Alle parallelen RoutenDas Eingabeobjekt wird für alle parallelen Routen an dieser Position im Ziel-LRS-Netzwerk übertragen.
String

arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, {in_concurrent_route_matching})
NameErläuterungDatentyp
in_source_event

Der zu übertragende Eingabeobjekt-Layer.

Feature Layer
in_target_route_features

Das Ziel-LRS-Netzwerk, für das die Eingabeobjekte übertragen werden.

Feature Layer
out_target_event

Die Ausgabe-Feature-Class, in das die übertragenen Objekt-Features aufgenommen werden.

Feature Class
in_concurrent_route_matching
(optional)

Gibt an, welche Methode verwendet wird, um zu ermitteln, für welche Route das Objekt übertragen werden soll, wenn im Ziel-LRS-Netzwerk parallele Routen vorhanden sind. Dieser Parameter wird nur angewendet, wenn die Position der Objektübertragung auf das Ziel-LRS-Netzwerk parallele Routen (Routen mit einer gemeinsamen Position) aufweist.

  • ANYDer Eingabeobjekt-Layer wird für die erste von zwei oder mehr im Ziel-LRS-Netzwerk gefundene parallele Routen übertragen.
  • ROUTE_IDDie Routen-ID des Quellobjekts wird mit den Routen-IDs paralleler Routen im Ziel-LRS-Netzwerk verglichen. Das Quellobjekt wird basierend auf Routen-ID-Übereinstimmungen im Quellobjekt und Zielnetzwerk übertragen. Die Routen-IDs des Eingabeobjekts und des Ziel-LRS-Netzwerks müssen exakt übereinstimmen, damit das Objekt mit dieser Methode korrekt übertragen wird. Für die Verwendung dieser Methode muss der Eingabeobjekt-Layer ebenfalls ein registriertes LRS-Objekt sein.
  • ALLDas Eingabeobjekt wird für alle parallelen Routen an dieser Position im Ziel-LRS-Netzwerk übertragen.
String

Codebeispiel

TranslateEventMeasures – Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie das Werkzeug TranslateEventMeasures im unmittelbaren Modus in ArcGIS Pro verwendet wird:

# Name: TranslateEventMeasures_ex1.py
# Description: Translate the measures (m-values) of events from one linear referencing method (LRM) to another. The output is a new event layer feature class.
# Requires: ArcGIS Location Referencing

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

# Tool variables
in_source_event = "TestPressureRange"
in_target_route_features = "StationSeriesNetwork"
out_target_event = "Test_Pressure_Range_Station_Series"
in_concurrent_route_matching = "ANY"

# Execute the tool
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)
TranslateEventMeasures – Beispiel 2 (eigenständiges Skript)

Im folgenden eigenständigen Skript wird veranschaulicht, wie das Werkzeug TranslateEventMeasures in ArcGIS Pro verwendet wird:

# Name: TranslateEventMeasures_ex2.py
# Description: Translates the measures (m-values) of events from one linear referencing method (LRM) to another. The output is a new event layer feature class.
# Requires: ArcGIS Location Referencing
 
# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
in_source_event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure"
in_target_route_features = r"C:\Data\Pipeline_Data.gdb\LRS\StationSeries"
out_target_event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure_Transform"
in_concurrent_route_matching = "ANY"

# Process: Translate Event Measures
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
TranslateEventMeasures – Beispiel 3 (eigenständiges Skript)

Im folgenden eigenständigen Skript wird veranschaulicht, wie das Werkzeug TranslateEventMeasures in einem Feature-Service verwendet wird:

# Name: TranslateEventMeasures_Pro_Ex3.py
# Description: Translate event measures in stand-alone mode using a feature service. It is recommended to work in a version and post to a default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

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

# Input event and target LRS network are in feature service.  Signing in portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the input event and target LRS network from the feature service. Here, 53 corresponds to the target LRS network and 31 corresponds to source event.
in_source_event = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/31"
in_target_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/53"

# Set tool variables
out_target_event = r"C:\Data\LocationReferencing.gdb\outputevent"
in_concurrent_route_matching = "ANY"

# Process: Translate Event Measures.
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)

# 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