Routenereignisse überlagern (Linear Referencing)

Zusammenfassung

Überlagert zwei Ereignistabellen, um eine Ausgabe-Ereignistabelle 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 Überlagerungsereignisse sollten auf derselben Routenreferenz basieren.

  • Als Eingabe-Tabellen können alle von ArcGIS unterstützten Tabellentypen verwendet werden. Die Ausgabetabelle kann eine .dbf-Datei oder eine Geodatabase-Tabelle sein.

  • Der Parameterwert Ausgabe-Ereignistabelle kann mit dem Werkzeug Routenereignis-Layer erstellen in einer Karte angezeigt werden.

  • Wenn sowohl die Eigenschaften der Eingabe- als auch der Overlay-Ereignisse vom Typ Punkt sind, müssen auch die Eigenschaften der Ausgabeereignisse als Punkt definiert werden.

  • Wenn sowohl die Eigenschaften der Eingabe- als auch der Overlay-Ereignisse vom Typ Linie sind, müssen auch die Eigenschaften der Ausgabeereignisse als Linie definiert werden.

  • Wenn entweder die Eigenschaften der Eingabe- oder der Overlay-Ereignisse vom Typ Punkt sind, müssen die Eigenschaften der Ausgabeereignisse als Punkt definiert werden, wenn Überschneiden als Typ der Überlagerung ausgeführt wird. Sie müssen als Linie definiert werden, wenn eine Überlagerung vom Typ Vereinigen ausgeführt wird.

  • Wenn sowohl die Eigenschaften der Eingabe- als auch der Overlay-Ereignisse 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-Ereignistabelle für die dynamische Segmentierung verwenden, wird empfohlen, einen Attributindex zu erstellen.

  • Um die Anzahl der zu verarbeitenden Ereignisse effektiv zu reduzieren, nutzen Sie das Werkzeug Tabellensicht erstellen, bevor Sie dieses Werkzeug verwenden.

  • Wenn die Eingabe- oder Überlagerungsereignisse kein ObjectID-Feld enthalten, verwenden Sie zunächst das Werkzeug Abfragetabelle erstellen, bevor Sie mit diesem Werkzeug ein virtuelles ObjectID-Feld hinzufügen.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Ereignistabelle

Die Eingabe-Ereignistabelle.

Table View
Eigenschaften der Eingabe-Ereignistabelle

Der Parameter, der sich aus den Routenpositionsfeldern und dem in der Eingabeereignistabelle festgelegten Ereignistyp zusammensetzt.

  • Routenkennungsfeld: Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Ereignisse befinden. Bei diesem Feld kann es sich um ein Zahlen- oder Zeichenfeld handeln.
  • Ereignistyp: Der Typ der Ereignisse in der Ausgabeereignistabelle (POINT oder LINE).
    • POINT: Punktereignisse stellen eine exakte Position entlang einer Route dar. Es muss lediglich das Von-Messwert-Feld angegeben werden.
    • LINE: Linienereignisse 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 Ereignistyp POINT oder LINE festgelegt wurde. Beachten Sie Folgendes: Wenn als Ereignistyp die Option POINT 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 Ereignistyp LINE festgelegt wurde.
Route Measure Event Properties
Overlay-Ereignistabelle

Die Overlay-Ereignistabelle.

Table View
Eigenschaften der Overlay-Ereignistabelle

Die Routenpositionsfelder und der Ereignistyp in der Overlay-Ereignistabelle.

Routen-Kennungsfeld: Die Werte in diesem Feld geben an, entlang welcher Route sich die einzelnen Ereignisse befinden. Bei diesem Feld kann es sich um ein Zahlen- oder Zeichenfeld handeln.

Ereignistyp: Der Ereignistyp in der Overlay-Ereignistabelle (POINT oder LINE).

  • POINT: Punktereignisse stellen eine exakte Position entlang einer Route dar. Es muss lediglich das Von-Messwert-Feld angegeben werden.
  • LINE: Linienereignisse definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden.

Von-Messwert-Feld: Das Feld mit Von-Messwerten. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Ereignistyp POINT oder LINE festgelegt wurde. Wenn als Ereignistyp die Option POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld.

Bis-Messwert-Feld: Das Feld mit Bis-Messwerten. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Ereignistyp LINE festgelegt wurde.

Route Measure Event Properties
Typ der Überlagerung

Gibt den Typ der Überlagerung an, die durchgeführt wird.

  • Überschneiden (Intersect)Es werden nur überlappende Ereignisse in die Ausgabe-Ereignistabelle geschrieben. Dies ist die Standardeinstellung.
  • Vereinigen (Union)Alle Ereignisse werden in die Ausgabetabelle geschrieben. Lineare Ereignisse werden an ihren Schnittpunkten geteilt.
String
Ausgabe-Ereignistabelle

Die zu erstellende Tabelle.

Table
Eigenschaften der Ausgabe-Ereignistabelle

Parameter, der sich aus den Routenpositionsfeldern und dem in die Ausgabeereignistabelle zu schreibenden Ereignistyp zusammensetzt.

  • Routenkennungsfeld: Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Ereignisse befinden.
  • Ereignistyp: Der Typ der Ereignisse in der Ausgabeereignistabelle (POINT oder LINE).
    • POINT: Punktereignisse stellen eine exakte Position entlang einer Route dar. Es muss lediglich ein einzelnes Messwertfeld angegeben werden.
    • LINE: Linienereignisse definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden.
  • Von-Messwert-Feld: Ein Feld mit Messwerten. Erforderlich, wenn der Ereignistyp POINT oder LINE ist. Beachten Sie Folgendes: Wenn als Ereignistyp die Option POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld.
  • Bis-Messwert-Feld: Ein Feld mit Messwerten. Erforderlich, wenn der Ereignistyp LINE ist.
Route Measure Event Properties
Linienereignisse mit der Länge 0 beibehalten
(optional)

Gibt an, ob Linienereignisse mit der Länge 0 zum Parameterwert Ausgabe-Ereignistabelle hinzugefügt werden. Dieser Parameter ist nur gültig, wenn der Ausgabeereignistyp LINE lautet.

  • Aktiviert: Linienereignisse mit der Länge 0 werden hinzugefügt. Dies ist die Standardeinstellung.
  • Deaktiviert: Linienereignisse 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-Ereignistabellen in den Parameterwert Ausgabe-Ereignistabelle eingefügt werden.

  • Aktiviert: Alle Felder aus den Eingabetabellen werden in die Ausgabetabelle eingefügt. Dies ist die Standardeinstellung.
  • Deaktiviert: Es werden nicht alle Felder aus den Eingabetabellen 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-Ereignistabelle 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})
NameErläuterungDatentyp
in_table

Die Eingabe-Ereignistabelle.

Table View
in_event_properties

Der Parameter, der sich aus den Routenpositionsfeldern und dem in der Eingabeereignistabelle festgelegten Ereignistyp zusammensetzt.

  • Routenkennungsfeld: Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Ereignisse befinden. Bei diesem Feld kann es sich um ein Zahlen- oder Zeichenfeld handeln.
  • Ereignistyp: Der Typ der Ereignisse in der Ausgabeereignistabelle (POINT oder LINE).
    • POINT: Punktereignisse stellen eine exakte Position entlang einer Route dar. Es muss lediglich das Von-Messwert-Feld angegeben werden.
    • LINE: Linienereignisse 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 Ereignistyp POINT oder LINE festgelegt wurde. Beachten Sie Folgendes: Wenn als Ereignistyp die Option POINT 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 Ereignistyp LINE festgelegt wurde.
Route Measure Event Properties
overlay_table

Die Overlay-Ereignistabelle.

Table View
overlay_event_properties

Die Routenpositionsfelder und der Ereignistyp in der Overlay-Ereignistabelle.

Routen-Kennungsfeld: Die Werte in diesem Feld geben an, entlang welcher Route sich die einzelnen Ereignisse befinden. Bei diesem Feld kann es sich um ein Zahlen- oder Zeichenfeld handeln.

Ereignistyp: Der Ereignistyp in der Overlay-Ereignistabelle (POINT oder LINE).

  • POINT: Punktereignisse stellen eine exakte Position entlang einer Route dar. Es muss lediglich das Von-Messwert-Feld angegeben werden.
  • LINE: Linienereignisse definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden.

Von-Messwert-Feld: Das Feld mit Von-Messwerten. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Ereignistyp POINT oder LINE festgelegt wurde. Wenn als Ereignistyp die Option POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld.

Bis-Messwert-Feld: Das Feld mit Bis-Messwerten. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Ereignistyp LINE festgelegt wurde.

Route Measure Event Properties
overlay_type

Gibt den Typ der Überlagerung an, die durchgeführt wird.

  • INTERSECTEs werden nur überlappende Ereignisse in die Ausgabe-Ereignistabelle geschrieben. Dies ist die Standardeinstellung.
  • UNIONAlle Ereignisse werden in die Ausgabetabelle geschrieben. Lineare Ereignisse werden an ihren Schnittpunkten geteilt.
String
out_table

Die zu erstellende Tabelle.

Table
out_event_properties

Parameter, der sich aus den Routenpositionsfeldern und dem in die Ausgabeereignistabelle zu schreibenden Ereignistyp zusammensetzt.

  • Routenkennungsfeld: Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Ereignisse befinden.
  • Ereignistyp: Der Typ der Ereignisse in der Ausgabeereignistabelle (POINT oder LINE).
    • POINT: Punktereignisse stellen eine exakte Position entlang einer Route dar. Es muss lediglich ein einzelnes Messwertfeld angegeben werden.
    • LINE: Linienereignisse definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden.
  • Von-Messwert-Feld: Ein Feld mit Messwerten. Erforderlich, wenn der Ereignistyp POINT oder LINE ist. Beachten Sie Folgendes: Wenn als Ereignistyp die Option POINT festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld.
  • Bis-Messwert-Feld: Ein Feld mit Messwerten. Erforderlich, wenn der Ereignistyp LINE ist.
Route Measure Event Properties
zero_length_events
(optional)

Gibt an, ob Linienereignisse mit der Länge 0 zum Parameterwert out_table hinzugefügt werden. Dieser Parameter ist nur gültig, wenn der Ausgabeereignistyp LINE lautet.

  • ZEROLinienereignisse mit der Länge 0 werden hinzugefügt. Dies ist die Standardeinstellung.
  • NO_ZEROLinienereignisse mit der Länge 0 werden nicht hinzugefügt.
Boolean
in_fields
(optional)

Gibt an, ob alle Felder aus den Eingabe- und Overlay-Ereignistabellen in den Parameterwert out_table eingefügt werden.

  • FIELDSAlle Felder aus den Eingabetabellen werden in die Ausgabetabelle eingefügt. Dies ist die Standardeinstellung.
  • NO_FIELDSEs werden nicht alle Felder aus den Eingabetabellen 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.

  • INDEXEs wird ein Attributindex erstellt. Dies ist die Standardeinstellung.
  • NO_INDEXEs 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.OverlayRouteEvents_lr("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"

# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr(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" 

# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr(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 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

# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr(in_tbl, in_props, ov_tbl, ov_props, "INTERSECT", 
                            out_tbl, out_props)

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen