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 dBASE-Datei oder eine Geodatabase-Tabelle sein.
Die Ausgabetabelle kann in ArcMap angezeigt werden. Nutzen Sie hierfür das Werkzeug Routenereignis-Layer erstellen oder den Befehl "Routenereignisse anzeigen" in ArcMap.
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 Überlagerungsereignisse 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.
Ein Attributindex für das Routenidentifizierungsfeld beschleunigt die dynamische Segmentierung. Wenn Sie die Ausgabeereignistabelle für die dynamische Segmentierung verwenden, empfiehlt es sich, 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.
Syntax
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})
Parameter | Erklärung | Datentyp |
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.
| Route Measure Event Properties |
overlay_table | Die Overlay-Ereignistabelle. | Table View |
overlay_event_properties | Der Parameter, der sich aus den Routenpositionsfeldern und dem in der Overlay-Ereignistabelle festgelegten Ereignistyp zusammensetzt. 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 ("Punkt" oder "Linie").
Von-Messwert-Feld: Enthält Messwerte. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Ereignistyp "Punkt" oder "Linie" festgelegt wurde. Beachten Sie Folgendes: Wenn als Ereignistyp "Punkt" festgelegt ist, ändert sich die Beschriftung für diesen Parameter in "Messwertfeld". Bis-Messwert-Feld: Enthält Messwerte. Dieses Feld muss ein Zahlenfeld sein. Es ist erforderlich, wenn als Ereignistyp "Linie" festgelegt wurde. | Route Measure Event Properties |
overlay_type | Der Typ der durchzuführenden Überlagerung.
| 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.
| Route Measure Event Properties |
zero_length_events (optional) | Gibt an, ob Linienereignisse mit der Länge 0 in der Ausgabetabelle beibehalten werden. Dieser Parameter ist nur gültig, wenn der Ausgabeereignistyp "Linie" lautet.
| Boolean |
in_fields (optional) | Gibt an, ob alle Felder aus den Eingabe- und Overlay-Ereignistabellen in die Ausgabe-Ereignistabelle geschrieben werden.
| Boolean |
build_index (optional) | Gibt an, ob für das Routen-Kennungsfeld, das in die Ausgabeereignistabelle geschrieben wird, ein Attributindex erstellt wird.
| Boolean |
Codebeispiel
OverlayRouteEvents – Beispiel 1 (Python-Fenster)
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)
OverlayRouteEvents – Beispiel 5 (eigenständiges Skript)
Das folgende Python-Skript veranschaulicht, wie die Funktion OverlayRouteEvents in einem eigenständigen Python-Skript mit Personal-Geodatabase-Daten verwendet wird.
# Description: Line-on-line UNION overlay (both tables are in a personal
# geodatabase)
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.mdb"
# 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")
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja