Objekte überlagern (Location Referencing)

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.

    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 der Konfiguration einer Verwaltung von Adressdaten oder eines Versorgungsnetzes ist. Die Richtung der Mittelachse wird in den Ausgaben berücksichtigt, wenn der Layer der Mittelachse Teil der Konfiguration einer Verwaltung von Adressdaten ist.

  • 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 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:

    IndexFeld

    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ältGehö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

BeschriftungErläuterungDatentyp
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.

  • Deaktiviert: Für das Ausgabe-Dataset wird keine Objektgeometrie erstellt. Die Objektdatensätze werden als Tabelle gespeichert. Dies ist die Standardeinstellung.
  • Aktiviert: Für das Ausgabe-Dataset wird eine Objektgeometrie erstellt. Die Objektdatensätze werden als Feature-Class gespeichert.
Boolean
Netzwerkfelder
(optional)

Felder aus dem Netzwerk-Layer, die in die Ausgabe einbezogen werden.

Field

arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, {include_geometry}, {network_fields})
NameErläuterungDatentyp
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.

  • EXCLUDE_GEOMETRYDer Parameterwert output_dataset enthält keine Objektgeometrie. Die Objektdatensätze werden als Tabelle gespeichert. Dies ist die Standardeinstellung.
  • INCLUDE_GEOMETRYDer Parameterwert output_dataset enthält Objektgeometrie. Die Objektdatensätze werden als Feature-Class gespeichert.
Boolean
network_fields
[network_fields,...]
(optional)

Felder aus dem Netzwerk-Layer, die in die Ausgabe einbezogen werden.

Field

Codebeispiel

OverlayEvents: Beispiel 1 (Python-Fenster)

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)
OverlayEvents: Beispiel 2 (eigenständiges Skript)

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')
OverlayEvents: Beispiel 3 (eigenständiges Skript)

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

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