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. | 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 der Wert Ausgabe-Dataset eine Objektgeometrie enthält.
| Boolean |
Netzwerkfelder (optional) | Felder aus dem Netzwerk-Layer, die in die Ausgabe einbezogen werden. | Field |
Mit der Location Referencing-Lizenz verfügbar.
Zusammenfassung
Überlagert mindestens einen linearen Objekt-Feature-Layer auf einem Zielnetzwerk und gibt eine Feature-Class oder Tabelle aus, die die dynamische Segmentierung der Eingaben darstellt.
Verwendung
Alle Eingabewerte für Objekt-Layer müssen Linienobjekte sein.
Der Parameter Objekt-Layer kann nur Feature-Classes für lineare Objekte enthalten, die in einem ArcGIS Location Referencing-Netzwerk registriert sind.
Wenn die Eingabeobjekte andere lineare Referenzierungsmethoden (LRM) verwenden, werden sie mit der LRM des Zielnetzwerks übertragen.
Dieses Werkzeug unterstützt Auswahlsätze.
Dieses Werkzeug unterstützt Definitionsfilter.
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 Parameter 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
Wenn das Ziel-LRS-Netzwerk als Liniennetzwerk mit Unterstützung für eine Mehrfeld-Routen-ID konfiguriert wurde, sind die folgenden Parameter zum Anhängen von Routen nicht erforderlich:
- Feld für Routenname
- Feld für Linienname
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 den Eingabeobjekt-Layer mit den Messwerten in der rechten 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 das ArcGIS Data Reviewer-Werkzeug 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. | 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 Wert output_dataset eine Objektgeometrie enthält.
| Boolean |
network_fields [network_fields,...] (optional) | 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"
include_geometry = "EXCLUDE_GEOMETRY"
network_fields = ""
# Set current workspace
arcpy.env.workspace = "C:\Data\NY_Data.gdb"
# Execute the tool
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, include_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)