Overlay Route Events (Linear Referencing)

License Level:BasicStandardAdvanced

Summary

Overlays two event tables to create an output event table that represents the union or intersection of the input.

Usage

Syntax

OverlayRouteEvents_lr (in_table, in_event_properties, overlay_table, overlay_event_properties, overlay_type, out_table, out_event_properties, {zero_length_events}, {in_fields}, {build_index})
ParameterExplanationData Type
in_table

The input event table.

Table View
in_event_properties

Parameter consisting of the route location fields and the type of events in the input event table.

  • Route Identifier Field—The field containing values that indicate along which route each event is. This field can be numeric or character.
  • Event Type—The type of events in the input event table (POINT or LINE).
    • POINT—Point events occur at a precise location along a route. Only a from-measure field must be specified.
    • LINE—Line events define a portion of a route. Both from- and to-measure fields must be specified.
  • From-Measure Field—A field containing measure values. This field must be numeric and is required when the event type is POINT or LINE. Note when the Event Type is POINT, the label for this parameter becomes Measure Field.
  • To-Measure Field—A field containing measure values. This field must be numeric and is required when the event type is LINE.
Route Measure Event Properties
overlay_table

The overlay event table.

Table View
overlay_event_properties

Parameter consisting of the route location fields and the type of events in the overlay event table.

Route Identifier Field—The field containing values that indicate which route each event is along. This field can be numeric or character.

Event Type—The type of events in the overlay event table (POINT or LINE).

  • POINT—Point events occur at a precise location along a route. Only a from-measure field must be specified.
  • LINE—Line events define a portion of a route. Both from- and to-measure fields must be specified.

From-Measure Field—A field containing measure values. This field must be numeric and is required when the event type is POINT or LINE. Note when the Event Type is POINT the label for this parameter becomes "Measure Field".

To-Measure Field—A field containing measure values. This field must be numeric and is required when the event type is LINE.

Route Measure Event Properties
overlay_type

The type of overlay to be performed.

  • INTERSECTWrites only overlapping events to the output event table. This is the default.
  • UNIONWrites all events to the output table. Linear events are split at their intersections.
String
out_table

The table to be created.

Table
out_event_properties

Parameter consisting of the route location fields and the type of events that will be written to the output event table.

  • Route Identifier Field—The field that will contain values that indicate along which route each event is.
  • Event Type—The type of events the output event table will contain (POINT or LINE).
    • POINT—Point events occur at a precise location along a route. Only a single measure field must be specified.
    • LINE—Line events define a portion of a route. Both from- and to-measure fields must be specified.
  • From-Measure Field—A field that will contain measure values. Required when the event type is POINT or LINE. Note when the Event Type is POINT, the label for this parameter becomes Measure Field.
  • To-Measure Field—A field that will contain measure values. Required when the event type is LINE.
Route Measure Event Properties
zero_length_events
(Optional)

Specifies whether to keep zero length line events in the output table. This parameter is only valid when the output event type is LINE.

  • ZEROKeeps zero length line events. This is the default.
  • NO_ZERODoes not keep zero length line events.
Boolean
in_fields
(Optional)

Specifies whether all the fields from the input and overlay event tables will be written to the output event table.

  • FIELDSIncludes all the fields from the input tables in the output table. This is the default.
  • NO_FIELDSDoes not include all the fields from the input tables in the output table. Only the ObjectID and the route location fields are kept.
Boolean
build_index
(Optional)

Specifies whether an attribute index will be created for the route identifier field that is written to the output event table.

  • INDEXCreates an attribute index. This is the default.
  • NO_INDEXDoes not create an attribute index.
Boolean

Code Sample

OverlayRouteEvents Example (Python Window)
import arcpy
from arcpy import env

env.workspace = "C:/Data"
arcpy.OverlayRouteEvents_lr ("accident.dbf", "rkey POINT mile" , "pavecond.dbf", "rkey LINE fmp tmp", "INTERSECT", \
                              "accpav", "rkey POINT mile" )
OverlayRouteEvents Example (Stand-alone Python Script)

The following Python script demonstrates how to use the OverlayRouteEvents function in a stand-alone Python script.

# NAme: OverlayRouteEvents_Example.py
# Description: Point-on-line INTERSECT overlay (both tables are dBASE)
# Author: ESRI

# Import system modules 
import arcpy
from arcpy import env

# Set workspace
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 Example 2 (Stand-alone Python Script)

The following Python script demonstrates how to use the OverlayRouteEvents function in a stand-alone Python script using file geodatabase data.

# Name OverlayRouteEvents_Example2.py
# Description: Line-on-line UNION overlay (both tables are in a file geodatabase)
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set workspace
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 Example 3 (Stand-alone Python Script)

The following Python script demonstrates how to use the OverlayRouteEvents function in a stand-alone Python script using personal geodatabase data.

# Name: OverlayRouteEvents_Example3.py
# Description: Line-on-line UNION overlay (both tables are in a personal geodatabase)
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set workspace
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")
OverlayRouteEvents Example 4 (Stand-alone Python Script)

The following Python script demonstrates how to use the OverlayRouteEvents function in a stand-alone Python script using SDE data.

# Name: OverlayRouteEvents_Example4.py
# Description:  Point-on-line INTERSECT overlay (both tables are in enterprise geodatabase)

# Import system modules 
import arcoy
from arcpy import env

# Set workspace
env.workspace = "Database Connections/Connection to Jerry.sde"

# Set local variables
in_tbl = gp.QualifyTableName("accident", wkspc)
in_props = "rkey POINT mile"  
ov_tbl = gp.QualifyTableName("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)

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Yes
ArcGIS for Desktop Standard: Yes
ArcGIS for Desktop Advanced: Yes
6/18/2012