Event behavior for route reassignment

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.

Before reassignment

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.

Stay Put event behavior

Move behavior

Although the measures of the event are maintained, the geographic location may change.

Move event behavior

Retire behavior

Events intersecting the reassignment region are retired.

Retire event behavior

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.

Snap event behavior

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.

Upstream and downstream

The following table details how the reassignment editing activity impacts upstream and downstream events according to the configured event behavior.

BehaviorEvents upstream reassignmentEvents intersecting reassignmentEvents 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.

Before Stay Put event behavior

EventRoute nameFrom dateTo dateFrom measureTo 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.

After Stay Put event behavior

EventRoute nameFrom dateTo dateFrom measureTo measureLocation 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.

Before Move event behavior

EventRoute nameFrom dateTo dateFrom measureTo 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.

After Move event behavior

EventRoute nameFrom dateTo dateFrom measureTo measureLocation 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.

Before Retire event behavior

EventRoute nameFrom dateTo dateFrom measureTo 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.

After Retire event behavior

EventRoute nameFrom dateTo dateFrom measureTo measureLocation 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.

Before Snap event behavior

EventRoute nameFrom dateTo dateFrom measureTo 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.

After Snap event behavior

EventRoute nameFrom dateTo dateFrom measureTo measureLocation 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.

Before Stay Put event behavior

Event IDFrom DateTo DateFrom RouteIDTo Route IDFrom MeasureTo 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.

After Stay Put event behavior

Event IDFrom DateTo DateFrom RouteIDTo Route IDFrom MeasureTo MeasureLocation 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.

Before Move event behavior

Event IDFrom DateTo DateFrom RouteIDTo Route IDFrom MeasureTo 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.

After Move event behavior

Event IDFrom DateTo DateFrom Route IDTo Route IDFrom MeasureTo MeasureLocation 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.

Before Retire event behavior

Event IDFrom DateTo DateFrom RouteIDTo Route IDFrom MeasureTo 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.

After Retire event behavior

Event IDFrom DateTo DateFrom Route IDTo Route IDFrom MeasureTo MeasureLocation 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.

Before Snap event behavior

Event IDFrom DateTo DateFrom RouteIDTo Route IDFrom MeasureTo 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.

After Snap even behavior

EventFrom DateTo DateFrom RouteIDTo Route IDFrom MeasureTo MeasureLocation 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