Event behavior for route reassignment

Disponible avec la licence Location Referencing.

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.

Remarque :

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.

Remarque :

• 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