Objekte überlagern (Location Referencing Tools)

Zusammenfassung

Überlagert ein oder mehrere Linienobjekt- und Punktobjekt-Layer in einem Zielnetzwerk mit anschließender Ausgabe einer Feature-Class oder Tabelle, die die dynamische Segmentierung der Eingaben darstellt.

Abbildung

Abbildung des Werkzeugs "Objekte überlagern"

Verwendung

Die folgende Tabelle ist 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>

Die Parameterwerte für Objekt-Layer können entweder nur Linienobjekte sein oder sowohl Punkt- als auch Linienobjekte enthalten.
Der Parameter Objekt-Layer kann nur Event-Feature-Classes enthalten, die in einem LRS-Netzwerk registriert sind.

Hinweis:

– In einer Address-Data-Management-Konfiguration kann nach dem Konfigurieren der Feature-Class für Mittelachsen zur Verwendung mit einem LRS die Feature-Class für Mittelachsen als Eingabe des Parameters Objekt-Layer für die dynamische Segmentierung verwendet werden. Die Digitalisierrichtung der Mittelachse wird in der Ausgabe berücksichtigt.

– In einer ArcGIS Utility Network-Konfiguration können nach dem Konfigurieren der Pipeline-Line-, Pipeline-Device- und Pipeline-Junction-Feature-Classes zur Verwendung mit einem LRS diese Feature-Classes als Eingaben des Parameters Objekt-Layer für die dynamische Segmentierung verwendet werden.
Wenn der Eingabe-Layer Adressenbereichsfelder aus einer Address-Data-Management-Konfiguration enthält und als eine Address-Range-Feature-Class in einem LRS konfiguriert ist, werden die Werte in den Adressenbereichsfeldern für jedes Segment in der Ausgabe proportional aktualisiert, wenn der Parameterwert Teilungstyp für Adressenblock auf Proportional festgelegt ist. Wenn der Parameterwert Nächster Adresspunkt lautet, werden die Adressenbereiche für jedes Segment in der Ausgabe auf Grundlage der nächsten flussaufwärts oder flussabwärts gelegenen Adresspunkte aktualisiert.

[Weitere Informationen zu Analysefunktionen in einem kombinierten LRS- und Address-Data-Management-Dataset]../../help/production/roads-highways/manage-address-and-roadway-characteristic-data-together.md#447
Wenn die Eingabeobjekt-Layer unterschiedliche lineare Referenzierungsmethoden (LRM) verwenden, werden sie mit dem LRM des Zielnetzwerks übersetzt.
Dieses Werkzeug unterstützt Auswahlsätze und Definitionsabfragen für die Parameterwerte Eingaberouten-Features und Objekt-Layer.

Hinweis:

Um alle mit den Eingaberouten verknüpften Objektdatensätze einzubeziehen, deaktivieren Sie die Umschaltflächen Ausgewählte Datensätze verwenden oder Gefilterte Datensätze verwenden für jeden Eingabeobjekt-Layer.
Dieses Werkzeug unterstützt Eingabeobjekt-Layer, die so konfiguriert sind, dass sie Objekte enthalten, die sich über mehrere Routen erstrecken. Die Ausgabe wird weiterhin dynamisch auf der Routenebene des Zielnetzwerks unter Verwendung des Parameterwertes Netzwerkfelder segmentiert.
Dieses Werkzeug unterstützt die zeitbezogene Segmentierung (Einrichten von Zeitintervallen). Dies erfolgt standardmäßig und kann durch die Erstellung einer zeitbasierten Definitionsabfrage oder die Anwendung eines Auswahlsatzes auf die Eingaben außer Kraft gesetzt werden.
Dieses Werkzeug unterstützt die Berücksichtigung eines oder mehrerer Felder aus der Network-Feature-Class in der Ausgabe unter Verwendung des Parameters Netzwerkfelder.
Die Ausgabe kann entweder als Tabelle oder als Feature-Class gespeichert werden.
Wenn die Ausgabe als Tabelle oder Feature-Class gespeichert wird, hat die Ausgabe die folgenden Indizes und Felder:
Index

Feld
route_id
Route_ID
rid_dates_measures
Route_ID

From_Date

To_Date

From_Measure

To_Measure

Index	Feld
route_id	`Route_ID`
rid_dates_measures	`Route_ID` `From_Date` `To_Date` `From_Measure` `To_Measure`

Wenn mehr als ein LRS-Netzwerk in einer Utility Network-Konfiguration 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 der Utility Network-Konfiguration Folgendes enthält	Gehören die Kennzahlen in der Pipeline-Line-Feature-Class zu
Liniennetzwerk, Nicht-Liniennetzwerk	Liniennetzwerk
Liniennetzwerk	Liniennetzwerk
Mehr als ein Liniennetzwerk	Liniennetzwerk mit abgeleitetem Netzwerk
Mehr als ein Liniennetzwerk ohne abgeleitetes Netzwerk	Liniennetzwerk mit der niedrigsten Nummer in der Domäne `dLRSNetworks` mit codierten Werten
Mehr als ein Liniennetzwerk mit abgeleiteten Netzwerken	Liniennetzwerk mit der niedrigsten Nummer in der Domäne `dLRSNetworks` mit codierten Werten
Ein Nicht-Liniennetzwerk	Nicht-Liniennetzwerk
Mehr als ein Nicht-Liniennetzwerk	Netzwerk mit der niedrigsten Nummer in der Domäne `dLRSNetworks` mit codierten Werten

Dieses Werkzeug unterstützt physisch lückenhafte Routen und Objekte als Eingaberouten bzw. Eingabeobjekte.
Auf einem Routensegment kann sich nur ein Objekt pro Layer befinden. Für einen Layer mit dem Namen "Geschwindigkeitsbegrenzung" kann sich beispielsweise nur ein Objektdatensatz in diesem Layer auf diesem Segment befinden. Ein Segment kann mehrere Objekte haben, jedes in seinem eigenen Objekt-Layer. Verwenden Sie die Überprüfung ungültiger Objektmesswerte in ArcGIS Data Reviewer, um Probleme bei Objektdaten zu ermitteln und zu beheben.
Wenn beim Ausführen dieses Werkzeug mit Daten aus einem Feature-Service Fehler auftreten oder der Vorgang länger als erwartet dauert, erhöhen Sie die Größe für den Heapspeicher auf Service-Ebene.
Die Umgebungseinstellung "Faktor für parallele Verarbeitung" für dieses Werkzeug gilt nur für Objekte, die mehrere Routen umfassen, sowie für nicht übergreifende Objekte, die nicht im Zielnetzwerk registriert sind.

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 in einem Zielnetzwerk dynamisch segmentiert werden. Der Mittelachsen-Layer kann als Eingabe verwendet werden, um Objekte dynamisch zu segmentieren.	Feature Layer
Ausgabe-Dataset	Eine Tabelle oder Feature-Class, die die Ausgabeobjektdatensätze enthält, wird erstellt.	Table
Geometrie einbeziehen (Optional)	Gibt an, ob der Parameterwert Ausgabe-Dataset Objektgeometrie enthält. Aktiviert—Der Parameterwert Ausgabe-Dataset enthält Objektgeometrie. Objektdatensätze werden als Feature-Class gespeichert. Deaktiviert—Für das Ausgabe-Dataset wird keine Objektgeometrie erstellt. Objektdatensätze werden als Tabelle gespeichert. Dies ist die Standardeinstellung.	Boolean
Netzwerkfelder (Optional)	Die Felder des Netzwerk-Layers, die in der Ausgabe enthalten sein werden.	Field
Teilungstyp für Adressenblock (Optional)	Gibt an, wie Adressenbereiche für jedes Segment der Ausgabe aktualisiert werden. Dieser Parameter ist nur verfügbar, wenn ein konfigurierter Adressenbereich-Layer als Eingabeobjekt-Layer verwendet wird. Nächster Adresspunkt—Adressenbereiche werden für jedes Segment in der Ausgabe auf Grundlage der nächsten flussaufwärts oder flussabwärts gelegenen Adresswerte aktualisiert. Proportional—Adressenbereiche werden für jedes Segment in der Ausgabe proportional von der Teilungsposition aus aktualisiert. Dies ist die Standardeinstellung.	String

arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, {include_geometry}, {network_fields}, {address_block_split_type})

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 in einem Zielnetzwerk dynamisch segmentiert werden. Der Mittelachsen-Layer kann als Eingabe verwendet werden, um Objekte dynamisch zu segmentieren.	Feature Layer
output_dataset	Eine Tabelle oder Feature-Class, die die Ausgabeobjektdatensätze enthält, wird erstellt.	Table
include_geometry (Optional)	Gibt an, ob der Parameterwert `output_dataset` Objektgeometrie enthält. `INCLUDE_GEOMETRY`—Der Parameterwert `output_dataset` enthält Objektgeometrie. Objektdatensätze werden als Feature-Class gespeichert. `EXCLUDE_GEOMETRY`—Der Parameterwert `output_dataset` enthält keine Objektgeometrie. Objektdatensätze werden als Tabelle gespeichert. Dies ist die Standardeinstellung.	Boolean
network_fields [network_fields,...] (Optional)	Die Felder des Netzwerk-Layers, die in der Ausgabe enthalten sein werden.	Field
address_block_split_type (Optional)	Gibt an, wie Adressenbereiche für jedes Segment der Ausgabe aktualisiert werden. Dieser Parameter ist nur verfügbar, wenn ein konfigurierter Adressenbereich-Layer als Eingabeobjekt-Layer verwendet wird. `NEAREST_ADDRESS_POINT`—Adressenbereiche werden für jedes Segment in der Ausgabe auf Grundlage der nächsten flussaufwärts oder flussabwärts gelegenen Adresswerte aktualisiert. `PROPORTIONAL`—Adressenbereiche werden für jedes Segment in der Ausgabe proportional von der Teilungsposition aus aktualisiert. Dies ist die Standardeinstellung.	String

Codebeispiel

OverlayEvents: Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion OverlayEvents verwenden.

# 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 = ""
address_block_split_type = ""

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

# Run the tool
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, Geometry, network_fields, address_block_split_type)

OverlayEvents: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion OverlayEvents 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

# 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 = ""
Address_Block_Split_Type = ""

# Process: Overlay Events
arcpy.locref.OverlayEvents(Network, Events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)

OverlayEvents: Beispiel 3 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion OverlayEvents mit Daten von 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

#Input LRS network and events are in feature service. Portal sign in 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, while 2 and 3 corresponds to the 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 = ""
Address_Block_Split_Type = ""

# Process: Overlay Events.
arcpy.locref.OverlayEvents(in_network, in_events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)

Umgebungen

Aktueller Workspace, Faktor für parallele Verarbeitung

Sonderfälle

Faktor für parallele Verarbeitung: The default value for this environment, if left blank, is 0%. Any absolute value for the environment is always clamped between 0 and the number of logical cores on your machine.

Lizenzierungsinformationen

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)