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.

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

    IndexFeld

    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 "Gas 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 das ArcGIS Data Reviewer-Werkzeug Ungültige Objekte, 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.

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.

  • Deaktiviert: Der Wert Ausgabe-Dataset enthält keine Objektgeometrie. Die Objektdatensätze werden als Tabelle gespeichert. Dies ist die Standardeinstellung.
  • Aktiviert: Der Wert Ausgabe-Dataset enthält eine Objektgeometrie. 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.

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.

  • EXCLUDE_GEOMETRYDer Wert output_dataset enthält keine Objektgeometrie. Die Objektdatensätze werden als Tabelle gespeichert. Dies ist die Standardeinstellung.
  • INCLUDE_GEOMETRYDer Wert output_dataset enthält eine 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

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

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

# Check in license
arcpy.CheckInExtension('LocationReferencing')
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\LRS\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\LRS\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
  • Standard: Erfordert ArcGIS Location Referencing
  • Advanced: Erfordert ArcGIS Location Referencing

Verwandte Themen