Available with Location Referencing license.
Events are located along a route in a linear referencing system (LRS). Changes in the route due to route editing activities such as extend, realign, reassign, retire, reverse, cartographic realignment, and calibration have a direct impact on how events are located and how they are rendered on a map. Behavior changes with measure or geographic location, or both, on one or more events due to route editing is called event behavior.
ArcGIS Roads and Highways keeps event measures and geographic location (x,y) in alignment with route edits. You can configure event behavior rules for an individual event layer to define how event measures and shapes are updated for each type of route edit.
In the following example, a portion of Route1 is retired. This edit activity affects Event1 according to the event layer's configured event behavior.
Note:
Events must be updated after route editing using the Apply Event Behaviors tool.
After the route is retired, the events are updated using event behavior rules, which are set at the event layer level.
Types of event behavior rules
When an LRS route is edited, behavior rules are applied to the events. By configuring event behavior rules at the layer level, you can specify how the event responds when the route changes: preserve location, preserve measure, or maintain referent location.
Location Referencing supports the following event behaviors:
| Event behavior rule | Description |
|---|---|
Stay Put | Preserves the geographic location of the event; measures can change |
Move | Preserves the measure or measures of the event; geographic location can change |
Retire | Preserves both measure and geographic location; event is retired |
Snap | Preserves the location of an event by snapping the event to a reassigned or abandoned route; measure or measures can change |
Cover | Changes both measure and geographic location to make the event go across the entire route |
Honor Route Measure | Preserves the measure of the event or changes the measure proportionally to the route measure change |
Honor Referent Location | Changes both measure and geographic location to maintain the referent location of the event using a persistent offset value |
To understand how LRS events get updated due to the route edit type for each event behavior rule, refer to:
Configuration of event behavior rules
Default event behavior is configured during the event registration process when using either the Create LRS Event or Create LRS Event From Existing Dataset tool.
The following event behavior rules are set by default:
| Activity | Rule |
|---|---|
Calibrate Route | Stay Put |
Retire Route | Stay Put |
Extend Route | Stay Put |
Reassign Route | Stay Put |
Realign Route | Stay Put |
Reverse Route | Stay Put |
Carto Realign Route | Honor Route Measure |
You can modify the default behavior for route calibration, route retirement, route extension, route reassignment, route realignment, and route reversal in an LRS Network using the Modify Event Behavior Rules tool.
Note:
For any LRS route edit in which Recalibrate route downstream is chosen, the configured calibrate event behavior is applied to downstream sections. You can review configured event behaviors by viewing LRS event properties.
Apply event behavior
To apply event behaviors after route edits, run the Apply Event Behaviors tool for the route network. This tool processes event behaviors for all event feature classes registered to the route network.
You do not need to run the Apply Event Behaviors tool after each route edit activity. You can schedule it to run based on your business requirements. It only processes event behaviors for those routes that have been edited but not yet processed.