Beschriftung | Erläuterung | Datentyp |
Eingabe-Routen-Features | Das Zielnetzwerk, auf dem die Objekt-Layer dynamisch segmentiert werden. | Feature Layer |
Objekt-Layer | Die Objekt-Layer, die zusammen auf einem Zielnetzwerk dynamisch segmentiert werden. Der Mittelachsen-Layer kann als Eingabe verwendet werden, um Objekte dynamisch zu segmentieren. | Feature Layer |
Ausgabe-Dataset | Die Tabelle oder Feature-Class, die die Ausgabe-Objektdatensätze enthält, die erstellt werden. | Table |
Geometrie einbeziehen (optional) | Gibt an, ob für das Ausgabe-Dataset eine Objektgeometrie erstellt wird.
| Boolean |
Netzwerkfelder (optional) | Die Felder aus dem Netzwerk-Layer, die in die Ausgabe einbezogen werden. | Field |
Mit der Location Referencing-Lizenz verfügbar.
Zusammenfassung
Überlagert mindestens einen Linien- und Punkt-Objekt-Layer auf einem Zielnetzwerk und gibt eine Feature-Class oder Tabelle aus, die die dynamische Segmentierung der Eingaben darstellt.
Abbildung
Verwendung
Die folgende Tabelle zeigt die Ausgabe für das oben abgebildete Werkzeug:
Ausgabe (Objekte überlagern)
Typ Von-Messwert Bis-Messwert Linienobjekt 1 Linienobjekt 2 Punktobjekt Linie
0
2
A
1
<NULL>
Punkt
2
2
A
1
PE1
Linie
2
3
A
1
<NULL>
Linie
3
4
B
1
<NULL>
Linie
4
5
B
2
<NULL>
Alle Werte unter Objekt-Layer können entweder nur Linienobjekte sein oder sowohl Punkt- als auch Linienobjekte enthalten.
Der Parameter Objekt-Layer kann nur Feature-Classes für Objekte enthalten, die in einem ArcGIS Location Referencing-Netzwerk registriert sind.
Hinweis:
Der Mittelachsen-Layer kann als Eingabe für den Parameter Objekt-Layer verwendet werden, um Objekte dynamisch zu segmentieren, wenn der Mittelachsen-Layer Teil einer Lösung für die Verwaltung von Adressendaten oder einer Utility Network-Konfiguration ist. Die Richtung der Mittelachse wird in den Ausgaben berücksichtigt, wenn der Layer der Mittelachse Teil der Lösungskonfiguration einer Verwaltung von Adressendaten ist.
Wenn der Eingabe-Layer Adressenbereichsfelder aus einer Konfiguration für die Verwaltung von Adressendaten enthält und als Address-Feature-Class in einem LRS konfiguriert ist, werden die Werte in den Adressenbereichsfeldern für jedes Segment in der Ausgabe aktualisiert.
Wenn die Eingabeobjekte andere lineare Referenzierungsmethoden (LRM) verwenden, werden sie mit der LRM des Zielnetzwerks übertragen.
Dieses Werkzeug unterstützt Auswahlsätze für die Parameterwerte Eingabe-Routen-Features und Objekt-Layer.
Dieses Werkzeug unterstützt Definitionsfilter für die Parameterwerte Eingabe-Routen-Features und Objekt-Layer.
Dieses Werkzeug unterstützt Eingabewerte für Objekt-Layer, die so konfiguriert sind, dass sie Objekte enthalten, die sich über mehrere Routen erstrecken. Die Ausgabe wird trotzdem mit dem Parameterwert Netzwerkfelder dynamisch auf Routenebene des Zielnetzwerks segmentiert.
Dieses Werkzeug unterstützt eine zeitliche Segmentierung (Zeitintervalle). Dies erfolgt standardmäßig und kann außer Kraft gesetzt werden, indem eine zeitbasierte Definitionsabfrage erstellt oder ein Auswahlsatz auf die Eingaben angewendet wird.
Dieses Werkzeug unterstützt die Aufnahme von mindestens einem Feld aus der Network-Feature-Class in die Ausgabe unter Verwendung des Parameters Netzwerkfelder.
Die Ausgabe kann als Tabelle oder als Feature-Class gespeichert werden.
Wenn die Ausgabe als Tabelle oder Feature-Class gespeichert wird, enthält die Ausgabe die folgenden Indizes und Felder:
Index Feld Route_ID
- Route_ID
Rid_Dates_Me
- Route_ID
- From_Date
- To_Date
- From_Measure
- To_Measure
Dieses Werkzeug unterstützt den Pipeline-Feature-Layer Gas Utility Network Configuration als Eingabeobjekt-Layer, wenn diese Feature-Class mit dem Werkzeug Utility Network-Feature-Class konfigurieren zur Verwendung mit einem LRS konfiguriert wurde.
Wenn mehr als ein LRS-Netzwerk in "Gas Utility Network Configuration" vorhanden ist, stimmen die Messwerte für die Eingabeobjekt-Layer mit den Messwerten in der zweiten Spalte der folgenden Tabelle überein:
Wenn das LRS mit "Utility Network Configuration" Folgendes enthält Gehören die Messwerte der PipelineLine-Feature-Class zu Liniennetzwerk, Nicht-Liniennetzwerk
Liniennetzwerk
Liniennetzwerk
Liniennetzwerk
Mehr als ein Liniennetzwerk
Liniennetzwerk mit dem abgeleiteten Netzwerk
Mehr als ein Liniennetzwerk ohne ein abgeleitetes Netzwerk
Liniennetzwerk mit der niedrigsten Nummer in der Domäne mit codierten Werten dLRSNetworks
Mehr als ein Liniennetzwerk mit abgeleiteten Netzwerken
Liniennetzwerk mit der niedrigsten Nummer in der Domäne mit codierten Werten dLRSNetworks
Ein Nicht-Liniennetzwerk
Nicht-Liniennetzwerk
Mehr als ein Nicht-Liniennetzwerk
Netzwerk mit der niedrigsten Nummer in der Domäne mit codierten Werten dLRSNetworks
Dieses Werkzeug unterstützt physisch lückenhafte Routen und Objekte als Eingaberouten bzw. Eingabeobjekte.
Nur ein Objekt pro Layer kann sich auf einem Routensegment befinden. Beispielsweise kann für den Layer "Geschwindigkeitsbegrenzung" nur ein Objektdatensatz in dem Layer auf dem Segment vorhanden sein. Ein Segment kann mehrere Objekte aufweisen, jedes in einem eigenen Objekt-Layer. Verwenden Sie die ArcGIS Data Reviewer-Prüfung Ungültige Objektmesswerte, um Probleme mit Objektdaten zu ermitteln und zu beheben.
Parameter
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, {include_geometry}, {network_fields})
Name | Erläuterung | Datentyp |
in_route_features | Das Zielnetzwerk, auf dem die Objekt-Layer dynamisch segmentiert werden. | Feature Layer |
event_layers [event_layers,...] | Die Objekt-Layer, die zusammen auf einem Zielnetzwerk dynamisch segmentiert werden. Der Mittelachsen-Layer kann als Eingabe verwendet werden, um Objekte dynamisch zu segmentieren. | Feature Layer |
output_dataset | Die Tabelle oder Feature-Class, die die Ausgabe-Objektdatensätze enthält, die erstellt werden. | Table |
include_geometry (optional) | Gibt an, ob der Parameterwert output_dataset eine Objektgeometrie enthält.
| Boolean |
network_fields [network_fields,...] (optional) | Die Felder aus dem Netzwerk-Layer, die in die Ausgabe einbezogen werden. | Field |
Codebeispiel
Mit dem folgenden Python-Fenster-Skript wird veranschaulicht, wie die Funktion OverlayEvents im Python-Fenster verwendet wird.
# Name: OverlayEvents_ex1.py
# Description: Overlays linear event feature layers against a target network and output a feature class or table that represents the dynamic segmentation of those inputs.
# Requirements: ArcGIS Location Referencing
# tool variables
in_route_features = r"C:\Data\NY_Data.gdb\LRS\LRSN_MilePoint"
event_layers = [r"C:\Data\NY_Data.gdb\LRS\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRS\LRSE_Functional_Class"]
output_dataset = r"C:\Data\NY_Data.gdb\Output"
Geometry = "EXCLUDE_GEOMETRY"
network_fields = ""
# Set current workspace
arcpy.env.workspace = r"C:\Data\NY_Data.gdb"
# Execute the tool
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, Geometry, network_fields)
Das folgende Python-Skript veranschaulicht, wie die Funktion OverlayEvents in einem eigenständigen Python-Skript verwendet wird.
# Name: OverlayEvents_ex2.py
# Description: Overlay linear event feature layers against a target network then output a feature class or table that represents the dynamic segmentation of those inputs.
# Requires: ArcGIS Location Referencing
# Import arcpy module
import arcpy
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
# Local variables:
Network = r"C:\Data\NY_Data.gdb\LRS\LRSN_MilePoint"
Events = [r"C:\Data\NY_Data.gdb\LRS\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRSE_Functional_Class"]
Output_Dataset = r"C:\Data\NY_Data.gdb\Output"
Geometry = "EXCLUDE_GEOMETRY"
Network_Fields = ""
# Process: Overlay Events
arcpy.locref.OverlayEvents(Network, Events, Output_Dataset, Geometry, Network_Fields)
# Check in license
arcpy.CheckInExtension('LocationReferencing')
Das folgende eigenständige Skript veranschaulicht, wie die Funktion OverlayEvents in einem Feature-Service verwendet wird.
# Name: OverlayEvents_Pro_Ex3.py
# Description: Overlay events using a feature service. It is recommended to work in a version and post to the default version.
# Requires: ArcGIS Location Referencing
# Import arcpy module
import arcpy
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
#Input LRS network and events are in feature service. Portal signi is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')
# Map the input LRS network and events from the feature service. Here, 1 corresponds to the input LRS network and 2 and 3 corresponds to input events.
in_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"
event1 = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/2"
event2 = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/3"
in_events = [event1, event2]
# Set tool variables
Output_Dataset = r"C:\Data\LocationReferencing.gdb\output"
Geometry = "EXCLUDE_GEOMETRY"
Network_Fields = ""
# Process: Overlay Events.
arcpy.locref.OverlayEvents(in_network, in_events, Output_Dataset, Geometry, Network_Fields)
# Check in license
arcpy.CheckInExtension('LocationReferencing')
Umgebungen
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)