Event behavior for route extension

Available with Location Referencing license.

When routes are extended, events are impacted, depending on the configured event behavior for each event layer.

Note:

Events are not updated until the Apply Event Behaviors tool is run after route edits. If you are using conflict prevention on branch versioned data, you are prompted to run Apply Event Behaviors before posting to the default version.

Note:

When Recalibrate route downstream is chosen for an LRS route edit, the configured calibrate event behavior is applied to downstream sections. You can review configured event behaviors by viewing LRS event properties.

The route extension and corresponding event behaviors are described below.

Route extension scenario

A route can be extended at the beginning or at the end of the route.

Upstream and downstream sections

Route editing impacts upstream and downstream sections differently.

Refer to the following diagrams to understand the upstream and downstream section for the route extension scenario:

Upstream and downstream sections of route extension scenarios

The following table details how a route extension impacts upstream and downstream events according to the configured event behavior:

Behavior Events upstream Events intersecting Events downstream

Stay Put

No action.

The shape is regenerated only if the event can be located using route and measures.

If the route is extended, measures are adjusted to retain x,y.

Move

No action.

The shape is regenerated to the new location of route measures.

If the route is extended, measures move to retain x,y.

Retire

No action.

Retire event; line events crossing the edit region are not split.

If the route is extended, measures change to retain x,y.

Cover

No action.

The shape is regenerated to the new location of route measures.

If the route is extended, measures move to retain x,y.

Note:

The network can contain events that span multiple routes in a line network. The behaviors are still applied in the same manner.

Because the LRS is time aware, edit activities, such as extending a route, slice time on routes and events.

Route extension results

In this example, Route1 is active from 1/1/2000. The extension is set to occur on 1/1/2005 where a length of 20 is added to the beginning of Route1 and the Recalibrate route downstream option is checked. The graphics and tables below demonstrate the route information before and after the extension

Before route extension

The following image shows the route before the extension:

Route1 before extension

The following table provides details about the route before the extension:

Route IDFrom DateTo DateFrom MeasureTo Measure

Route1

1/1/2000

<Null>

0

55

After route extension

The following image shows the route after the extension:

Route1 after extension

The following table provides details about the route after the extension:

Route IDFrom DateTo DateFrom MeasureTo Measure

Route1

1/1/2000

1/1/2005

0

55

Route1

1/1/2005

<Null>

0

75

Events before route extension

There are three events on Route1 and all of them have a start date (From Date) of 1/1/2000. The following image shows the route and events before extension:

Route1 and associated events before extension

The following table provides details about the events before extension:

EventRoute IDFrom DateTo DateFrom MeasureTo Measure

Event1

Route1

1/1/2000

<Null>

0

20

Event2

Route1

1/1/2000

<Null>

20

30

Event3

Route1

1/1/2000

<Null>

30

45

The following sections detail how event behavior rules are enforced after running the Apply Event Behaviors tool under this route extension scenario.

Stay Put event behavior

Although the geographic location of the event is maintained, the measures can change.

The route extension described above has the following effects:

  • Event1 is retired on the date of extension because it is in the downstream portion of the edit section. A new event is created on the post-extension route with the extension date as the starting date (From Date). The start measure (From Measure) value changes to 20 and the end measure (To Measure) value changes to 40 to accommodate the new measures of Route1.
  • Event2 is retired on the date of extension because it is in the downstream portion of the edit section. A new event is created on the post-extension route with the extension date as the starting date. The start measure value changes to 40 and the end measure value changes to 50 to accommodate the new measures of Route1.
  • Event3 is retired on the date of extension because it is in the downstream portion of the edit section. A new event is created on the post-extension route with the extension date as the starting date. The start measure value changes to 50 and end measure value changes 65 to accommodate the new measures of Route1.

The following image shows the route and events after the extension:

Route1 and associated events after extension when Stay Put is the configured event behavior.
Note:

The retired event is not drawn in the graphic above.

The following table provides details about the events after the extension when Stay Put is the configured event behavior:

EventRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation Error

Event1

Route1

1/1/2000

1/1/2005

0

20

No Error

Event1

Route1

1/1/2005

<Null>

20

40

No Error

Event2

Route1

1/1/2000

1/1/2005

20

30

No Error

Event2

Route1

1/1/2005

<Null>

40

50

No Error

Event3

Route1

1/1/2000

1/1/2005

30

45

No Error

Event3

Route1

1/1/2005

<Null>

50

65

No Error

Move event behavior

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

The route extension described above has the following effects:

  • Event1 is retired on the date of extension because it is in the downstream portion of the edit section. A new event is created on the post-extension route with the extension date as the starting date. Because the measures do not change for the Move behavior, the event shifts to the left to maintain its original start measure value of 0 and end measure value of 20.
  • Event2 is retired on the date of extension because it is in the downstream portion of the edit section. A new event is created on the post-extension route with the extension date as the starting date. Because the measures do not change for the Move behavior, the event shifts to the left to maintain its original start measure value of 20 and end measure value of 30.
  • Event3 is retired on the date of extension because it is in the downstream portion of the edit section. A new event is created on the post-extension route with the extension date as the starting date. Because the measures do not change for the Move behavior, the event shifts to the left to maintain its original start measure value of 30 and end measure value of 45.

The following image shows the route and events after the extension:

Route1 and associated events after extension when Move is the configured event behavior

The following table provides details about the events after the extension when Move is the configured event behavior:

EventRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation Error

Event1

Route1

1/1/2000

1/1/2005

0

20

No Error

Event1

Route1

1/1/2005

<Null>

0

20

No Error

Event2

Route1

1/1/2000

1/1/2005

20

30

No Error

Event2

Route1

1/1/2005

<Null>

20

30

No Error

Event3

Route1

1/1/2000

1/1/2005

30

45

No Error

Event3

Route1

1/1/2005

<Null>

30

45

No Error

Retire event behavior

Events in the downstream portion of the extension are retired. All three events are retired.

The route extension described above has the following effects:

  • Event1 was present in the downstream portion of the extension; it is retired on the date of extension.
  • Event2 was present in the downstream portion of the extension; it is retired on the date of extension.
  • Event3 was present in the downstream portion of the extension; it is retired on the date of extension.

The following image shows the route and events after the extension:

Route1 and associated events after extension when Retire is the configured event behavior.

The following table provides details about the events after the extension when Retire is the configured event behavior:

EventRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation Error

Event1

Route1

1/1/2000

1/1/2005

0

20

No Error

Event2

Route1

1/1/2000

1/1/2005

20

30

No Error

Event3

Route1

1/1/2000

1/1/2005

30

45

No Error

Cover event behavior

If the event touches the extension, its shape is also extended to cover the extended portion of the route. The measures of the event are also updated to reflect the new shape.

The route extension described above has the following effects:

  • Event1 is retired on the date of extension because it is in the downstream portion of the edit section. A new event is created on the post-extension route with the extension date as the start date. Because the event touches the route extension, it is also extended to cover the added length of 20 at the beginning or the route. The start measure value updates to 0 and the end measure value updates to 40.
  • Event2 is retired on the date of extension because it is in the downstream portion of the edit section. A new event is created on the post-extension route with the extension date as the start date. Because the event does not touch the extension, it only updates the start measure value to 40 and the end measure value to 50 to maintain its location.
  • Event3 is retired on the date of extension because it is in the downstream portion of the edit section. A new event is created on the post-extension route with the extension date as the start date. Because the event does not touch the extension, it only updates the start measure value to 50 and the end measure value to 65 to maintain its location.

The following image shows the route and events after the extension:

Route1 and associated events after extension when Cover is the configured event behavior.

The following table provides details about the events after the extension when Cover is the configured event behavior:

EventRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation Error

Event1

Route1

1/1/2000

1/1/2005

0

20

No Error

Event1

Route1

1/1/2005

<Null>

0

40

No Error

Event2

Route1

1/1/2000

1/1/2005

20

30

No Error

Event2

Route1

1/1/2005

<Null>

40

50

No Error

Event3

Route1

1/1/2000

1/1/2005

30

45

No Error

Event3

Route1

1/1/2005

<Null>

50

65

No Error

Detailed behavior on routes in a line network with events that span routes

In this example, there are four routes on the same line and the routes are active from 1/1/2000. The extension is set to occur on 1/1/2005 where a length of 10 is added to the beginning of Route1, and the Recalibrate route downstream option is chosen. The images and tables below demonstrate the route information before and after the extension.

Before route extension

The following image shows the routes before the extension:

The four routes on LineA before the extension

The following table provides details about the routes before the extension:

Route NameLine NameLine OrderFrom Date To DateFrom MeasureTo Measure

Route1

LineA

100

1/1/2000

<Null>

0

10

Route2

LineA

200

1/1/2000

<Null>

12

22

Route3

LineA

300

1/1/2000

<Null>

25

35

Route4

LineA

400

1/1/2000

<Null>

38

48

After route extension

The following image shows the routes after the extension:

The four routes on LineA after extending Route1

The following table provides details about the routes after the extension:

Route NameLine NameLine OrderFrom Date To DateFrom MeasureTo Measure

Route1

LineA

100

1/1/2000

1/1/2005

0

10

Route1

LineA

100

1/1/2005

<Null>

0

20

Route2

LineA

200

1/1/2000

<Null>

12

22

Route3

LineA

300

1/1/2000

<Null>

25

35

Route4

LineA

400

1/1/2000

<Null>

38

48

Events before extension

There are two spanning events on routes on LineA. The following image shows the routes and events before the extension:

The four routes and associated events before the extension

The following table provides details about the events before the extension:

Event IDFrom DateTo DateFrom Route NameTo Route NameFrom MeasureTo Measure

Event1

1/1/2000

<Null>

Route1

Route3

0

30

Event2

1/1/2000

<Null>

Route3

Route4

30

48

The following sections describe how event behavior rules are enforced rules are enforced when a route on a line in a line network is extended.

Stay Put event behavior

Although the geographic location of the event is maintained, the measures can change.

The route extension described above has the following effects:

  • Event1 is retired on the date of extension because it is in the downstream portion of the edit section. A new event is created on the post-extension route with the extension date as the starting date (From Date). The start measure (From Measure) value changes to 10 on Route1 and the end measure (To Measure) value changes to 30 on Route3 to accommodate the new measures of Route1.
  • Event2 is not affected because it is only associated with Route3 and Route4, which are not involved in the extension.

The following image shows the routes and events after the extension:

The four routes and associated events after the extension when Stay Put is the configured event behavior
Note:

The retired event is not drawn in the image above.

The following table provides details about the events after the extension when Stay Put is the configured event behavior:

Event IDFrom DateTo DateFrom Route NameFrom MeasureTo Route NameTo Measure

Event1

1/1/2000

1/1/2005

Route1

0

Route3

30

Event1

1/1/2005

<Null>

Route1

10

Route3

30

Event2

1/1/2000

<Null>

Route3

30

Route4

48

Move event behavior

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

The route extension described above has the following effects:

  • Event1 is retired on the date of extension because it is in the downstream portion of the edit section. A new event is created on the post-extension route with the extension date as the starting date. Because the measures do not change for the Move behavior, the event also extends to the left to maintain its original start measure value of 0 on Route1 and end measure value of 30 on Route3.
  • Event2 is not affected because it is only associated with Route3 and Route4, which are not involved in the extension.

The following image shows the routes and events after the extension:

The four routes and associated events after the extension when Move is the configured event behavior

The following table provides details about the events after the extension when Move is the configured event behavior:

Event IDFrom DateTo DateFrom Route NameFrom MeasureTo Route NameTo MeasureLocation Error

Event1

1/1/2000

1/1/2005

Route1

0

Route3

30

No Error

Event1

1/1/2005

<Null>

Route1

0

Route3

30

No Error

Event2

1/1/2000

<Null>

Route3

30

Route4

48

No Error

Retire event behavior

Events in the downstream portion of the extension are retired.

The route extension described above has the following effects:

  • Event1 was present in the downstream portion of the extension; it is retired on the date of extension.
  • Event2 is not affected because it is only associated with Route3 and Route4, which are not involved in the extension.

The following image shows the routes and events after the extension:

The four routes and associated events after the extension when Retire is the configured event behavior

The following table provides details about the events after the extension when Retire is the configured event behavior:

Event IDFrom DateTo DateFrom Route NameFrom MeasureTo Route NameTo MeasureLocation Error

Event1

1/1/2000

1/1/2005

Route 1

0

Route 3

30

No Error

Event2

1/1/2000

<Null>

Route 3

30

Route 4

48

No Error

Cover event behavior

If the event touches the extension, its shape is also extended to cover the extended portion of the route. The measures of the event are also updated to reflect the new shape.

The route extension described above has the following effects:

  • Event1 is retired on the date of extension because it is in the downstream portion of the edit section. A new event is created on the post-extension route with the extension date as the starting date. Because the event touches the route extension, it is also extended to cover the added length of 10 at the beginning of the route. The start measure value is updated to 0 on Route1 and the end measure value is updated to 30 on Route3.
  • Event2 is not affected because it is only associated with Route3 and Route4, which are not involved in the extension.

The following image shows the routes and events after the extension:

The four routes and associated events after the extension when Cover is the configured event behavior

The following table provides details about the events after the extension when Cover is the configured event behavior:

Event IDFrom DateTo DateFrom Route NameFrom MeasureTo Route NameTo MeasureLocation Error

Event1

1/1/2000

1/1/2005

Route1

0

Route3

30

No Error

Event1

1/1/2005

<Null>

Route1

0

Route3

30

No Error

Event2

1/1/2000

<Null>

Route3

30

Route4

48

No Error

Detailed behavior on concurrent routes with Cover behavior

The following sections detail how the Cover event behavior rule is enforced when concurrent routes result after extension.

Concurrent routes with Cover behavior and a nonspanning event

In the following scenario, there are two routes: Route1 and Route2. There is an Event1 on Route2. Route2 is extended to the start position of Route1 at the beginning of the route, with the Cover behavior configured as the event behavior. The Route2 extension uses two centerlines (CL1 and CL2). The route is active from 1/1/2000, and the extension is set to occur on 1/1/2005 with Recalibrate route downstream checked. The graphics and tables below demonstrate the route information before and after the extension.

Before route extension of a concurrent route

The following image shows the routes before the extension:

Route1 and Route2 before extension

The following table provides details about the routes before extension:

Route IDFrom DateTo DateFrom MeasureTo Measure

Route1

1/1/2000

<Null>

0

5

Route2

1/1/2000

<Null>

0

15

After route extension of a concurrent route

The following image shows the routes after the extension:

Route1 and Route2 after extension

The following table provides details about the routes after the extension:

Route IDFrom DateTo DateFrom MeasureTo Measure

Route1

1/1/2000

<Null>

0

5

Route2

1/1/2000

1/1/2005

0

15

Route2

1/1/2005

<Null>

0

30

Events before extension of a concurrent route with Cover behavior

There is one nonspanning event on Route2. The following image shows the routes and events before the extension:

Route1, Route2, and Event1 on Route2 before extension

The following table provides details about the events before extension:

Event IDRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation Error

Event1

Route2

1/1/2000

<Null>

0

15

No Error

Events after extension of a concurrent route with Cover behavior

After the extension, Route2 is concurrent with the dominant route, Route1, at the beginning of the extended section. Event1 is retired on the date of extension because it is in the downstream portion of the edit section. A new event is created on the post-extension route with the extension date as the start date. Because Event1 touches the route extension, it extends to the left but it does not cover the section where Route2 overlaps Route1 because Route1 is the dominant route in the concurrent section.

The following diagram provides details about the routes and event after the extension:

Route1, Route2, and Event1 on Route2 after the extension when Cover is the configured event behavior.
Note:

The retired event is not drawn in the graphic above.

The following table provides details about the events after the extension of a concurrent route when Cover is the configured event behavior:

Event IDRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation Error

Event1

Route2

1/1/2000

1/1/2005

0

15

No Error

Event1

Route2

1/1/2005

<Null>

5

30

No Error

Concurrent routes with Cover behavior and spanning events

In the following scenario, there are four routes on two different lines. There is a spanning event Event1 that goes from measure 0 on Route2 to measure 17 on Route3, and another spanning event Event2 that goes from measure 17 on Route3 to measure 36 on Route4. Both events are configured with the Cover behavior. Route2 is extended to the start position of Route1 at the beginning of the route. The Route2 extension uses two centerlines (CL1 and CL2). The route is active from 1/1/2000, and the extension is set to occur on 1/1/2005 with Recalibrate route downstream checked. The graphics and tables below demonstrate the route information before and after the extension

Before route extension of a concurrent route

The following image shows the routes before the extension:

The four routes on two different lines before extension.

The following table provides details about the routes before the extension:

Route NameLine NameLine OrderFrom DateTo DateFrom MeasureTo Measure

Route1

LineB

100

1/1/2000

<Null>

0

5

Route2

LineA

100

1/1/2000

<Null>

0

10

Route3

LineA

200

1/1/2000

<Null>

12

22

Route4

LineA

300

1/1/2000

<Null>

28

38

After route extension of a concurrent route

The following image shows the routes after the extension:

The four routes on two different lines after extension.

The following table provides details about the routes after the extension:

Route NameLine NameLine OrderFrom DateTo DateFrom MeasureTo Measure

Route1

LineB

100

1/1/2000

<Null>

0

5

Route2

LineA

100

1/1/2000

1/1/2005

0

10

Route2

LineA

100

1/1/2005

<Null>

0

20

Route3

LineA

200

1/1/2000

<Null>

12

22

Route4

LineA

300

1/1/2000

<Null>

28

38

Events before extension of a concurrent route with Cover behavior

There are two spanning events associated with routes on LineA.

The following image shows the routes and events before the extension:

The four routes on two different lines and associated spanning events before extension.

The following table provides details about the events before the extension:

Event IDFrom Route NameTo Route NameFrom DateTo DateFrom MeasureTo MeasureLocation Error

Event1

Route2

Route3

1/1/2000

<Null>

0

17

No Error

Event2

Route3

Route4

1/1/2000

<Null>

17

36

No Error

Events after extension of a concurrent route with Cover behavior

After extension, Route2 is concurrent with the dominant route, Route1, at the beginning of the extended section. Event1 is retired on the date of extension because it is in the downstream portion of the edit section. A new event is created on the post-extension route with the extension date as the starting date. Because Event1 touches the route extension, it extends to the left but it does not cover the section where Route2 overlaps Route1 because Route1 is the dominant route in the concurrent section.

Event2 is not affected because it is only associated with Route3 and Route4, which are not involved in extension.

The following image provides details about the routes and events after extension:

The four routes and associated spanning events after extension when Cover is the configured event behavior.

The following table provides details about the events after extension of a concurrent route when Cover is the configured event behavior:

Event IDFrom Route NameTo Route NameFrom DateTo DateFrom MeasureTo MeasureLocation Error

Event1

Route2

Route3

1/1/2000

1/1/2005

0

17

No Error

Event1

Route2

Route3

1/1/2005

<Null>

5

17

No Error

Event2

Route3

Route4

1/1/2000

<Null>

17

36

No Error