Routenobjekte überlagern (Linear Referencing Tools)

Zusammenfassung

Überlagert zwei Objekttabellen, um eine Ausgabe-Objekttabelle als Vereinigung oder Überschneidung der Eingabe zu erstellen.

Verwendung

Die Überlagerungen "Linie auf Linie", "Punkt auf Punkt", "Punkt auf Linie" und "Punkt auf Punkt" können ausgeführt werden.
Die Eingabe- und Overlay-Objekte sollten auf derselben Routenreferenz basieren.
Als Eingabetabelle können alle von ArcGIS unterstützten Tabellentypen verwendet werden. Die Ausgabetabelle kann eine .dbf-Datei oder eine Geodatabase-Tabelle sein.
Der Parameterwert Ausgabe-Objekttabelle kann mit dem Werkzeug Routenobjekt-Layer erstellen in einer Karte angezeigt werden.
Wenn sowohl die Eigenschaften der Eingabe- als auch der Overlay-Objekte vom Typ Punkt sind, müssen auch die Eigenschaften der Ausgabeobjekte als Punkt definiert werden.
Wenn sowohl die Eigenschaften der Eingabe- als auch der Overlay-Objekte vom Typ Linie sind, müssen auch die Eigenschaften der Ausgabeobjekte als Linie definiert werden.
Wenn entweder die Eigenschaften der Eingabe- oder die der Overlay-Objekte vom Typ Punkt sind, müssen die Eigenschaften der Ausgabeobjekte als Punkt definiert werden, wenn der Parameter Typ der Überlagerung den Wert Überschneiden aufweist. Die Eigenschaften der Ausgabeobjekte müssen als Linie definiert werden, wenn der Parameter Typ der Überlagerung den Wert Vereinigen aufweist.
Wenn sowohl die Eigenschaften der Eingabe- als auch der Overlay-Objekte vom Typ Punkt sind, gelten nur die Punkte als sich überlagernd, die über einen identischen Messwert verfügen. Es ist keine Suchtoleranz vorhanden.
Mit einem Attributindex für das Routenidentifizierungsfeld wird der dynamische Segmentierungsprozess beschleunigt. Wenn Sie den Parameterwert Ausgabe-Objekttabelle für dynamische Segmentierung verwenden, sollten Sie einen Attributindex erstellen.
Um die Anzahl der zu verarbeitenden Objekte zu reduzieren, verwenden Sie das Werkzeug Tabellensicht erstellen, bevor Sie dieses Werkzeug ausführen.
Wenn die Eingabe- oder Overlay-Objekte kein ObjectID-Feld enthalten, verwenden Sie zunächst das Werkzeug Abfragetabelle erstellen, bevor Sie mit diesem Werkzeug ein virtuelles ObjectID-Feld hinzufügen.

Beschriftung	Erläuterung	Datentyp
Eingabe-Objekttabelle	Die Eingabe-Objekttabelle.	Table View
Eigenschaften der Eingabe-Objekttabelle	Die Routenpositionsfelder und der Objekttyp in der Eingabe-Objekttabelle. Routenkennungsfeld: Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Objekte befinden. Bei diesem Feld kann es sich um ein numerisches Feld, ein Textfeld oder ein GUID-Feld handeln. Objekttyp: Der Objekttyp in der Eingabe-Objekttabelle (Punkt oder Linie). Punkt: Punktobjekte stellen eine exakte Position entlang einer Route dar. Es muss lediglich das Von-Messwert-Feld angegeben werden. Linie: Linienobjekte definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. Von-Messwert-Feld: Ein Feld mit Messwerten. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Objekttyp Punkt oder Linie festgelegt wurde. Wenn als Wert für Objekttyp die Option Punkt festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld. Bis-Messwert-Feld: Ein Feld mit Messwerten. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Objekttyp Linie festgelegt wurde.	Route Measure Event Properties
Overlay-Objekttabelle	Die Overlay-Objekttabelle.	Table View
Eigenschaften der Overlay-Objekttabelle	Die Routenpositionsfelder und der Objekttyp in der Overlay-Objektabelle. Routen-Kennungsfeld: Die Werte in diesem Feld geben an, entlang welcher Route sich die einzelnen Objekte befinden. Bei diesem Feld kann es sich um ein numerisches Feld, ein Textfeld oder ein GUID-Feld handeln. Objekttyp: Der Objekttyp in der Overlay-Objekttabelle (Punkt oder Linie). Punkt: Punktobjekte stellen eine exakte Position entlang einer Route dar. Es muss lediglich das Von-Messwert-Feld angegeben werden. Linie: Linienobjekte definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. Von-Messwert-Feld: Ein Feld mit Von-Messwerten. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Objekttyp Punkt oder Linie festgelegt wurde. Wenn als Objekttyp die Option Punkt festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld. Bis-Messwert-Feld: Enthält Bis-Messwerte. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Objekttyp Linie festgelegt wurde.	Route Measure Event Properties
Typ der Überlagerung	Gibt den Typ der Überlagerung an, die durchgeführt wird. Überschneiden—Es werden nur überlappende Objekte in die Ausgabe-Objekttabelle geschrieben. Dies ist die Standardeinstellung. Vereinigen—Alle Objekte werden in die Ausgabetabelle geschrieben. Lineare Objekte werden an ihren Schnittpunkten geteilt.	String
Ausgabe-Objekttabelle	Die Tabelle, die erstellt wird.	Table
Eigenschaften der Ausgabe-Objekttabelle	Die Routenpositionsfelder und der in die Ausgabe-Objekttabelle zu schreibende Objekttyp. Routenkennungsfeld: Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Objekte befinden. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein. Objekttyp: Der in der Ausgabe-Objekttabelle enthaltene Objekttyp (Punkt oder Linie). Punkt: Punktobjekte stellen eine exakte Position entlang einer Route dar. Es muss lediglich ein einzelnes Messwertfeld angegeben werden. Linie: Linienobjekte definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. Von-Messwert-Feld: Ein Feld mit Messwerten. Dieses Feld ist erforderlich, wenn als Objekttyp Punkt oder Linie festgelegt wurde. Wenn als Wert für Objekttyp die Option Punkt festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld. Bis-Messwert-Feld: Ein Feld mit Messwerten. Dieses Feld ist erforderlich, wenn als Objekttyp Linie festgelegt wurde.	Route Measure Event Properties
Linienobjekte mit der Länge 0 beibehalten (Optional)	Gibt an, ob Linienobjekte mit der Länge 0 zum Parameterwert Ausgabe-Objekttabelle hinzugefügt werden. Dieser Parameter ist nur gültig, wenn der Ausgabe-Objekttyp Linie lautet. Aktiviert—Linienobjekte mit der Länge 0 werden hinzugefügt. Dies ist die Standardeinstellung. Deaktiviert—Linienobjekte mit der Länge 0 werden nicht hinzugefügt.	Boolean
Alle Felder der Eingabe einbeziehen (Optional)	Gibt an, ob alle Felder aus den Eingabe- und Overlay-Objekttabellen in den Parameterwert Ausgabe-Objekttabelle eingefügt werden. Aktiviert—Alle Felder aus den Eingabetabellen werden in die Ausgabetabelle eingefügt. Dies ist die Standardeinstellung. Deaktiviert—Alle Felder aus den Eingabetabellen werden nicht in die Ausgabetabelle eingefügt. Nur das Feld `ObjectID` und die Routenpositionsfelder werden eingefügt.	Boolean
Index erstellen (Optional)	Gibt an, ob für das Routen-Kennungsfeld, das in den Parameterwert Ausgabe-Objekttabelle geschrieben wird, ein Attributindex erstellt wird. Aktiviert—Es wird ein Attributindex erstellt. Dies ist die Standardeinstellung. Deaktiviert—Es wird kein Attributindex erstellt.	Boolean

arcpy.lr.OverlayRouteEvents(in_table, in_event_properties, overlay_table, overlay_event_properties, overlay_type, out_table, out_event_properties, {zero_length_events}, {in_fields}, {build_index})

Name	Erläuterung	Datentyp
in_table	Die Eingabe-Objekttabelle.	Table View
in_event_properties	Die Routenpositionsfelder und der Objekttyp in der Eingabe-Objekttabelle. Route identifier field—Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Objekte befinden. Bei diesem Feld kann es sich um ein numerisches Feld, ein Textfeld oder ein GUID-Feld handeln. Event type—Der Objekttyp in der Eingabe-Objekttabelle (`POINT` oder `LINE`). `POINT`—Punktobjekte stellen eine exakte Position entlang einer Route dar. Es muss lediglich das Von-Messwert-Feld angegeben werden. `LINE`—Linienobjekte definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. From-measure field—Ein Feld, das Messwerte enthält. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Objekttyp `POINT` oder `LINE` festgelegt wurde. To-measure field—Ein Feld, das Messwerte enthält. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Objekttyp `LINE` festgelegt wurde.	Route Measure Event Properties
overlay_table	Die Overlay-Objekttabelle.	Table View
overlay_event_properties	Die Routenpositionsfelder und der Objekttyp in der Overlay-Objektabelle. Routen-Kennungsfeld: Die Werte in diesem Feld geben an, entlang welcher Route sich die einzelnen Objekte befinden. Bei diesem Feld kann es sich um ein numerisches Feld, ein Textfeld oder ein GUID-Feld handeln. Objekttyp: Der Objekttyp in der Overlay-Objekttabelle (`POINT` oder `LINE`). `POINT`—Punktobjekte stellen eine exakte Position entlang einer Route dar. Es muss lediglich das Von-Messwert-Feld angegeben werden. `LINE`—Linienobjekte definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. Von-Messwert-Feld: Enthält Messwerte. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Objekttyp `POINT` oder `LINE` festgelegt wurde. Bis-Messwert-Feld: Enthält Messwerte. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Objekttyp `LINE` festgelegt wurde.	Route Measure Event Properties
overlay_type	Gibt den Typ der Überlagerung an, die durchgeführt wird. `INTERSECT`—Es werden nur überlappende Objekte in die Ausgabe-Objekttabelle geschrieben. Dies ist die Standardeinstellung. `UNION`—Alle Objekte werden in die Ausgabetabelle geschrieben. Lineare Objekte werden an ihren Schnittpunkten geteilt.	String
out_table	Die Tabelle, die erstellt wird.	Table
out_event_properties	Die Routenpositionsfelder und der in die Ausgabe-Objekttabelle zu schreibende Objekttyp. Route identifier field—Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Objekte befinden. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein. Event type—Der in der Ausgabe-Objekttabelle enthaltene Objekttyp (`POINT` oder `LINE`). `POINT`—Punktobjekte stellen eine exakte Position entlang einer Route dar. Es muss lediglich ein einzelnes Messwertfeld angegeben werden. `LINE`—Linienobjekte definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. From-measure field—Ein Feld mit Messwerten. Dieses Feld ist erforderlich, wenn als Objekttyp `POINT` oder `LINE` festgelegt wurde. To-measure field—Ein Feld mit Messwerten. Dieses Feld ist erforderlich, wenn als Objekttyp `LINE` festgelegt wurde.	Route Measure Event Properties
zero_length_events (Optional)	Gibt an, ob Linienobjekte mit der Länge 0 zum Parameterwert `out_table` hinzugefügt werden. Dieser Parameter ist nur gültig, wenn der Ausgabe-Objekttyp `LINE` lautet. `ZERO`—Linienobjekte mit der Länge 0 werden hinzugefügt. Dies ist die Standardeinstellung. `NO_ZERO`—Linienobjekte mit der Länge 0 werden nicht hinzugefügt.	Boolean
in_fields (Optional)	Gibt an, ob alle Felder aus den Eingabe- und Overlay-Objekttabellen in den Parameterwert `out_table` eingefügt werden. `FIELDS`—Alle Felder aus den Eingabetabellen werden in die Ausgabetabelle eingefügt. Dies ist die Standardeinstellung. `NO_FIELDS`—Alle Felder aus den Eingabetabellen werden nicht in die Ausgabetabelle eingefügt. Nur das Feld `ObjectID` und die Routenpositionsfelder werden eingefügt.	Boolean
build_index (Optional)	Gibt an, ob für das Routen-Kennungsfeld, das in den Parameterwert `out_table` geschrieben wird, ein Attributindex erstellt wird. `INDEX`—Es wird ein Attributindex erstellt. Dies ist die Standardeinstellung. `NO_INDEX`—Es wird kein Attributindex erstellt.	Boolean

Codebeispiel

OverlayRouteEvents: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.OverlayRouteEvents("accident.dbf", "rkey POINT mile", "pavecond.dbf",
                            "rkey LINE fmp tmp", "INTERSECT", "accpav",
                            "rkey POINT mile" )

OverlayRouteEvents: Beispiel 2 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion OverlayRouteEvents in einem eigenständigen Python-Skript verwendet wird.

# Description: Point-on-line INTERSECT overlay (both tables are dBASE)

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data"

# Set local variables
in_tbl = "accident.dbf"
in_props = "rkey POINT mile"  # reused as out event properties
ov_tbl = "pavecond.dbf"
ov_props = "rkey LINE fmp tmp"
out_tbl = "accpav"

# Run OverlayRouteEvents
arcpy.lr.OverlayRouteEvents(in_tbl, in_props, ov_tbl, ov_props, "INTERSECT",
                            out_tbl, in_props)

OverlayRouteEvents: Beispiel 3 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion OverlayRouteEvents in einem eigenständigen Python-Skript mit File-Geodatabase-Daten verwendet wird.

# Description: Line-on-line UNION overlay (both tables are in a file
#              geodatabase)

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"

# Set local variables
in_tbl = "pavecond"
in_props = "rkey LINE fmp tmp"  # reused as overlay and out event properties
ov_tbl = "pavetype"
out_tbl = "condtype"

# Run OverlayRouteEvents
arcpy.lr.OverlayRouteEvents(in_tbl, in_props, ov_tbl, in_props, "UNION",
                            out_tbl, in_props, "NO_ZERO")

OverlayRouteEvents: Beispiel 4 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion OverlayRouteEvents in einem eigenständigen Python-Skript mit Enterprise-Geodatabase-Daten verwendet wird.

# Description: Point-on-line INTERSECT overlay (both tables are in an enterprise
#              geodatabase)

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"

# Set local variables
in_tbl = arcpy.ValidateTableName("accident", wkspc)
in_props = "rkey POINT mile"
ov_tbl = arcpy.ValidateTableName("pavecond", wkspc)
ov_props = "rkey LINE fmp tmp"
out_tbl = "accpav"
out_props = "routekey POINT milepost"  # names are changed for out table

# Run OverlayRouteEvents
arcpy.lr.OverlayRouteEvents(in_tbl, in_props, ov_tbl, ov_props, "INTERSECT",
                            out_tbl, out_props)

Umgebungen

Aktueller Workspace, Ausgabe-CONFIG-Schlüsselwort, Scratch-Workspace

Lizenzierungsinformationen