Available with Location Referencing license.
During route reassignment, events are impacted in the edit activity areas, and upstream and downstream of the reassignment, depending on the event behavior configured for the event layer.
Note:
Events are not updated until the Apply Event Behaviors geoprocessing tool is applied after route edits. If you are using conflict prevention, you are prompted to run Apply Event Behaviors, which must be done before posting can be completed.
The following sections detail the results of executing this tool on event features.
Route reassignment scenario
This route reassignment scenario involves two routes. A portion of Route1 is reassigned to Route2.
Stay Put behavior
Although the geographic location of the event outside the reassign region is maintained, the measures may change. The event may also split if it crosses the reassign region. Portions in the reassign region are removed.
Move behavior
Although the measures of the event are maintained, the geographic location may change.
Retire behavior
Events intersecting the reassignment region are retired.
Snap behavior
Although the geographic location of the event is maintained by snapping to the route that it was reassigned to, the measures may change. The event may also split if it crosses the reassign region.
Upstream and downstream sections
Route editing impacts upstream and downstream sections differently. Use the following diagram and table to understand this impact for the configured event behavior.
The following diagram shows the upstream and downstream section for the route reassignment scenario.
The following table details how the reassignment editing activity impacts upstream and downstream events according to the configured event behavior.
| Behavior | Events upstream reassignment | Events intersecting reassignment | Events downstream reassignment |
|---|---|---|---|
Stay Put | No action | Retire event. Line events crossing the edit section will be split and the original event retired. | If route calibration is changed, the recalibrate event behavior is applied; otherwise, no action. |
Move | Shape regenerated, if needed, to new location of route measures | Shape regenerated to the new location of route measures. | If route calibration is changed, the recalibrate event behavior is applied; otherwise, no action. |
Retire | No action | Retire event. Line events crossing the reassignment region will not be split. | If route calibration is changed, the recalibrate event behavior is applied; otherwise, no action. |
Snap | No action | Geographic location (x,y) is maintained. The event will be migrated to the reassigned route. Line events crossing the edit section will be split. | If route calibration is changed, the recalibrate event behavior is applied; otherwise, no action. |
Note:
- Point events follow the same behavior as linear events but don't need to be split.
- If the option to recalibrate route downstream is chosen, the events downstream of the edited portion of the route will have calibrate route event behaviors applied.
- The network may contain events that span multiple routes in a line network. In that case, the behaviors are still applied in the same manner.
- Since the LRS is time aware, edit activities such as reassigning a route will time slice routes and events.
Detailed behavior results
The following sections detail how event behavior rules are enforced when a route is reassigned.
Stay Put behavior
If the reassignment is set to occur on 1/1/2005 with target values of 0 to 5, and Recalibrate route downstream is chosen, it will have the following effects:
- Event1 will be represented by two time slices. There will be a time slice as of 1/1/2000 to 1/1/2005, with the original measures of 0 to 7, and a time slice as of 1/1/2005 to <null>, with measures of 0 to 5 that will stay in the same location geographically but have the new measures of Route1.
- Event2 will retire to maintain geographic location.
Before Stay Put event behavior
The following diagram and table provide details about the route and its measures before reassignment.
| Event | Route name | From date | To date | From measure | To measure |
|---|---|---|---|---|---|
Event1 | Route1 | 1/1/2000 | <null> | 0 | 7 |
Event2 | Route1 | 1/1/2000 | <null> | 7 | 10 |
After Stay Put event behavior
The following diagram and table detail how event behavior rules are enforced after reassignment when Stay Put is the configured event behavior.
| Event | Route name | From date | To date | From measure | To measure | Location error |
|---|---|---|---|---|---|---|
Event1 | Route1 | 1/1/2000 | 1/1/2005 | 0 | 7 | No error |
Event1 | Route1 | 1/1/2005 | <null> | 0 | 5 | No error |
Event2 | Route1 | 1/1/2000 | 1/1/2005 | 7 | 10 | No error |
Move behavior
If the reassignment is set to occur on 1/1/2005 with target values of 0 to 5 and Recalibrate route downstream chosen, this will have the following effects:
- Event1 will be represented by two time slices. There will be a time slice as of 1/1/2000 to 1/1/2005, with the original measures of 0 to 7, and a time slice as of 1/1/2005 to <null> with measures of 0 to 7 that will move geographically to maintain the original event measures. This new time slice will only partially locate since the event time slice has measures of 0 to 7, but the underlying route time slice only has measures of 0 to 5. The event has the same measures but different geometry in the new time slice.
- Event2 will be represented by two time slices. There will be a time slice as of 1/1/2000 to 1/1/2005, with the original measures of 7 to 10, and a time slice as of 1/1/2005 to <null>, with measures of 7 to 10 that will move geographically to maintain the original event measures. This new time slice will not locate since the event time slice has measures of 7 to 10, but the underlying route time slice only has measures of 0 to 5. The event has the same measures but different geometry in the new time slice.
Before Move event behavior
The following diagram and table provide details about the route and its measures before reassignment.
| Event | Route name | From date | To date | From measure | To measure |
|---|---|---|---|---|---|
Event1 | Route1 | 1/1/2000 | <null> | 0 | 7 |
Event2 | Route1 | 1/1/2000 | <null> | 7 | 10 |
After Move event behavior
The following diagram and table detail how event behavior rules are enforced after reassignment when Move is the configured event behavior.
| Event | Route name | From date | To date | From measure | To measure | Location error |
|---|---|---|---|---|---|---|
Event1 | Route1 | 1/1/2000 | 1/1/2005 | 0 | 7 | No error |
Event1 | Route1 | 1/1/2005 | <null> | 0 | 7 | Partial match for the To Measure |
Event2 | Route1 | 1/1/2000 | 1/1/2005 | 7 | 10 | No error |
Retire behavior
If the reassignment is set to occur on 1/1/2005 with target values of 0 to 5 and Recalibrate route downstream is chosen, this will have the following effects:
- Event1 will retire.
- Event2 will retire.
Before Retire event behavior
The following diagram and table provide details about the route and its measures before reassignment.
| Event | Route name | From date | To date | From measure | To measure |
|---|---|---|---|---|---|
Event1 | Route1 | 1/1/2000 | <null> | 0 | 7 |
Event2 | Route1 | 1/1/2000 | <null> | 7 | 10 |
After Retire event behavior
The following diagram and table detail how event behavior rules are enforced after reassignment when Retire is the configured event behavior.
| Event | Route name | From date | To date | From measure | To measure | Location error |
|---|---|---|---|---|---|---|
Event1 | Route1 | 1/1/2000 | 1/1/2005 | 0 | 7 | No Error |
Event2 | Route1 | 1/1/2000 | 1/1/2005 | 7 | 10 | No Error |
Snap behavior
If the reassignment is set to occur on 1/1/2005 with target values of 0 to 5 and Recalibrate route downstream is chosen, this will have the following effects:
- Event1 will be represented by three time slices since it will split. There will be a time slice as of 1/1/2000 to 1/1/2005, with the original measures of 0 to 7, a time slice as of 1/1/2005 to <null>, with measures of 0 to 5 that will snap to the new measures of Route1; and a time slice as of 1/1/2005 to <null>, with measures of 0 to 2 that will snap to the new measures of Route2.
- Event2 will be represented by two time slices. There will be a time slice as of 1/1/2000 to 1/1/2005, with the original measures of 7 to 10, and a time slice as of 1/1/2005 to <null>, with measures of 2 to 5 that will snap to the new measures of Route2.
Before Snap event behavior
The following diagram and table provide details about the route and its measures before reassignment.
| Event | Route name | From date | To date | From measure | To measure |
|---|---|---|---|---|---|
Event1 | Route1 | 1/1/2000 | <null> | 0 | 7 |
Event2 | Route1 | 1/1/2000 | <null> | 7 | 10 |
After Snap event behavior
The following diagram and table detail how event behavior rules are enforced after reassignment when Stay Put is the configured event behavior.
| Event | Route name | From date | To date | From measure | To measure | Location error |
|---|---|---|---|---|---|---|
Event1 | Route1 | 1/1/2000 | 1/1/2005 | 0 | 7 | No error |
Event1 | Route1 | 1/1/2005 | <null> | 0 | 5 | No error |
Event1 | Route2 | 1/1/2005 | <null> | 0 | 2 | No error |
Event2 | Route1 | 1/1/2000 | 1/1/2005 | 7 | 10 | No error |
Event2 | Route2 | 1/1/2005 | <null> | 2 | 5 | No error |
Detailed behavior results on routes in a line network with events that span routes
The following sections detail how event behavior rules are enforced when routes on a line in a line network are reassigned.
Stay Put behavior
The routes are active from 1/1/2000, and if the reassignment is set to occur on 1/1/2005, from measure 25 on Route3 to 48 on Route4, and Recalibrate route downstream is not selected, this has the following effects:
- Reassignment is used for merging Route3 and Route4 to create a new Route3A.
- Event1 is represented by two time slices. There is a time slice from 1/1/2000 to 1/1/2005, with the original measures of 0 on Route1 to 30 on Route3. The second time slice is from 1/1/2005 to <null>, with measures of 0 on Route1 to 22 on Route2 as it stays the same geographically. The portion of the event on Route3 will be retired since there is no Route3 to build the event shape on any longer.
- Event2 retires as the event is completely within the reassigned portion. There is no longer a Route3 or Route4 on which to build the event shape.
Before Stay Put behavior
The following diagram and table provide details about the routes, events, and measures before reassignment of the edit region.
| Event ID | From Date | To Date | From RouteID | To Route ID | From Measure | To Measure |
|---|---|---|---|---|---|---|
Event1 | 1/1/2000 | <null> | Route1 | Route3 | 0 | 30 |
Event2 | 1/1/2000 | <null> | Route3 | Route4 | 30 | 48 |
After Stay Put behavior
The following diagram and table detail how event behavior rules are enforced after reassignment when Stay Put is the configured event behavior.
| Event ID | From Date | To Date | From RouteID | To Route ID | From Measure | To Measure | Location Error |
|---|---|---|---|---|---|---|---|
Event1 | 1/1/2000 | 1/1/2005 | Route1 | Route3 | 0 | 30 | No Error |
Event1 | 1/1/2005 | <null> | Route1 | Route2 | 0 | 22 | No Error |
Event2 | 1/1/2000 | 1/1/2005 | Route3 | Route4 | 30 | 48 | Route Not Found |
Move behavior
The routes are active from 1/1/2000 and if the reassignment is set to occur on 1/1/2005, from measure 25 on Route3 to 48 on Route4 and Recalibrate route downstream is unchecked, this has the following effects:
- Event1 is represented by two time slices. There is a time slice from 1/1/2000 to 1/1/2005, with the original measures of 0 on Route1 to 30 on Route3. The second time slice is from 1/1/2005 to <null>, with measures of 0 on Route1 to 30 on Route3, but Route3 has been reassigned, so the shape can’t be built in that location. In the new time slice, the event has the same measures but different geometry.
- Event2 is represented by two time slices. There is a time slice from 1/1/2000 to 1/1/2005, with the original measures of 30 on Route3 to 48 on Route4. In the second time slice from 1/1/2005 to <null>, with measures of 30 on Route3 to 48 on Route4, but Route3 and Route4 have been reassigned, so there is no shape for this event.
Before Move behavior
The following diagram and table provide details about the routes, events, and measures before reassignment of the edit region.
| Event ID | From Date | To Date | From RouteID | To Route ID | From Measure | To Measure |
|---|---|---|---|---|---|---|
Event1 | 1/1/2000 | <null> | Route1 | Route3 | 0 | 30 |
Event2 | 1/1/2000 | <null> | Route3 | Route4 | 30 | 48 |
After Move behavior
The following diagram and table detail how event behavior rules are enforced after reassignment when Move is the configured event behavior.
| Event ID | From Date | To Date | From Route ID | To Route ID | From Measure | To Measure | Location Error |
|---|---|---|---|---|---|---|---|
Event1 | 1/1/2000 | 1/1/2005 | Route1 | Route3 | 0 | 30 | No Error |
Event1 | 1/1/2005 | <null> | Route1 | Route3 | 0 | 30 | Partial Match for the To Measure |
Event2 | 1/1/2000 | 1/1/2005 | Route3 | Route4 | 30 | 48 | No Error |
Event2 | 1/1/2005 | <null> | Route3 | Route4 | 30 | 48 | Route Not Found |
Note:
Event2 exists after Apply Events Behavior is run but has no shape.
Retire behavior
The routes are active from 1/1/2000 and if the reassignment is set to occur on 1/1/2005, from measure 25 on Route3 to 48 on Route4 and Recalibrate route downstream is not selected, this has the following effects:
- Event1 will retire since it is located in the reassigned region.
- Event2 will retire since it is located in the reassigned region.
Before retire behavior
The following diagram and table provide details about the routes, events, and measures before reassignment of the edit region.
| Event ID | From Date | To Date | From RouteID | To Route ID | From Measure | To Measure |
|---|---|---|---|---|---|---|
Event1 | 1/1/2000 | <null> | Route1 | Route3 | 0 | 30 |
Event2 | 1/1/2000 | <null> | Route3 | Route4 | 30 | 48 |
After retire behavior
The following diagram and table detail how event behavior rules are enforced after reassignment when Retire is the configured event behavior.
| Event ID | From Date | To Date | From Route ID | To Route ID | From Measure | To Measure | Location Error |
|---|---|---|---|---|---|---|---|
Event1 | 1/1/2000 | 1/1/2005 | Route1 | Route3 | 0 | 30 | No Error |
Event2 | 1/1/2000 | 1/1/2005 | Route3 | Route4 | 30 | 48 | No Error |
Snap behavior
The routes are active from 1/1/2000 and if the reassignment is set to occur on 1/1/2005, from measure 25 on Route3 to 48 on Route4 and Recalibrate route downstream is unchecked, this has the following effects:
- Event1 is represented by two time slices. There is a time slice from 1/1/2000 to 1/1/2005, with the original measures of 0 on Route1 to 30 on Route3. The second time slice is from 1/1/2005 to <null> with two different records. Because the reassignment took place in the middle of the event, it will split with one record having measures of 0 on Route1 to 22 on Route2 and the second record having measures of 23 on Route3A to 30 on Route3A. Both events stay in the same location geographically, but the second event snaps to the new route at the location, Route3A.
- Event2 is represented by two time slices. There is a time slice from 1/1/2000 to 1/1/2005, with the original measures of 30 on Route3 to 48 on Route4. The second time slice is from 1/1/2005 to <null>, with measures of 30 on Route3A to 48 on Route3A. The event stays in the same location geographically, but snaps to the new route at location, Route3A.
Before Snap event behavior
The following diagram and table provide details about the routes, events, and measures before reassignment of the edit region.
| Event ID | From Date | To Date | From RouteID | To Route ID | From Measure | To Measure |
|---|---|---|---|---|---|---|
Event1 | 1/1/2000 | <null> | Route1 | Route3 | 0 | 30 |
Event2 | 1/1/2000 | <null> | Route3 | Route4 | 30 | 48 |
After Snap event behavior
The following diagram and table detail how event behavior rules are enforced after reassignment when Snap is the configured event behavior.
| Event | From Date | To Date | From RouteID | To Route ID | From Measure | To Measure | Location Error |
|---|---|---|---|---|---|---|---|
Event1 | 1/1/2000 | 1/1/2005 | Route1 | Route3 | 0 | 30 | No Error |
Event1 | 1/1/2005 | <null> | Route1 | Route2 | 0 | 22 | No Error |
Event1 | 1/1/2005 | <null> | Route3A | Route3A | 25 | 30 | No Error |
Event2 | 1/1/2000 | 1/1/2005 | Route3 | Route4 | 30 | 48 | No Error |
Event2 | 1/1/2005 | <null> | Route3A | Route3A | 30 | 48 | No Error |