Event behavior for cartographic realignment

Available with Location Referencing license.

Cartographic realignment is the method of updating the route geometry based on aerial imagery, as-built drawings, or input from field data collectors. To do this, you can directly modify the centerline that is associated with the route.

Learn more about applying cartographic realignment

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.

Cartographic realignment scenario

When cartographic realignment occurs, events are impacted depending on the configured event behavior for each event layer. The following are the results of running the Apply Event Behaviors tool on event features:

BehaviorDescription

Honor Route Measure

Preserves the measure of the event and changes shape according to the route.

Honor Referent Location

Changes both measure and geographic location to maintain the referent location of the event using a persistent offset value.

Note:

When Update route measures in cartographic realignment is enabled in a network in which cartographic realignment is performed, the route's measures can change after cartographic realignment. Subsequently, the configured cartographic realignment event behavior and calibrate event behavior are both applied to events in impacted sections on the route.

You can review the configured event behaviors per edit type by viewing LRS event properties.

For all examples in this topic, Update route measures in cartographic realignment is enabled.

Route cartographic realignment results

In this example, route Route1 is active from 1/1/2000. The cartographic realignment is set to occur on 1/1/2005 where an incorrect curve is fixed. Route1's measures adjust to its new geometry because the Update route measures in cartographic realignment option is enabled for the network. The graphics and tables in the following sections demonstrate the route information before and after the cartographic realignment.

Before route cartographic realignment

The following image shows the route before cartographic realignment. There is an intersection on Route1 where it intersects the county boundary. The intersection is the referent location in the Honor Referent Location event behavior scenario below.

Route1 before cartographic realignment

The following tables provide details about the route and intersection before cartographic realignment:

Route IDFrom DateTo DateFrom MeasureTo Measure

Route1

1/1/2000

<Null>

0

30

Intersection IDFrom DateTo DateRoute IDMeasure

Intersection

1/1/2000

<Null>

Route1

12

After route cartographic realignment

The following image shows the route and intersection after cartographic realignment:

Route1 after cartographic realignment

The following tables provide details about the route and intersection after cartographic realignment:

Route IDFrom DateTo DateFrom MeasureTo Measure

Route1

1/1/2000

<Null>

0

25

Intersection IDFrom DateTo DateRoute IDMeasure

Intersection

1/1/2000

<Null>

Route1

13

Note:

When the centerlines are edited, all routes in all networks, across all times, are modified accordingly. Consequently, Route1 does not get a new time slice, but its shape is changed in the existing time slice.

The intersection's shape and measure are also updated after running Generate Intersections. The intersection does not get a new time slice because its associated route does not time slice.

Events before route cartographic realignment

There is a point event on Route1 and it has a starting date (From Date) of 1/1/2000. The following image shows the route and event before cartographic realignment:

Route1 and Event1 before cartographic realignment

The following table provide details about the event before cartographic realignment:

EventRoute IDFrom DateTo Date Measure

Event1

Route1

1/1/2000

<Null>

17

The following sections describe how event behavior rules are enforced after running the Apply Event Behaviors tool with this route cartographic realignment scenario.

Note:

For a line event, its start and end points follow the same cartographic realignment event behavior as a point event.

Honor Route Measure behavior

If the Update route measures in cartographic realignment parameter is enabled for the network and the route's measures are updated due to cartographic realignment, the resulting event behavior will be a combination of the cartographic realignment behavior and the calibrate behavior. Events in the cartographic realignment area will move proportionally.

Note:

If the route measures have not changed because the Update route measures in cartographic realignment option is disabled for the network, the Honor Route Measure event behavior preserves the measures of the event and updates the event's location.

The following table shows the edit activities involved in the route edit and their corresponding event behaviors:

Edit activityEvent behavior

Cartographic realignment

Honor Route Measure

Calibrate

Stay Put

The route cartographic realignment described above has the following effect:

Event1 was located on Route1 at measure 17. Because it is within cartographic realignment and the route's measures have changed, both the cartographic realignment Honor Route Measure and the calibrate Stay Put behaviors are applied. Event1's measure is updated proportionally to measure 14.2 on Route1, and its location is also updated to stay on Route1.

The following image shows the route and event after cartographic realignment:

Route1 and Event1 after cartographic realignment when Honor Route Measure is the configured event behavior
Note:

Because cartographic realignment does not change a route's time slice, the time slice of the event on the route doesn't change either.

The following table provides details about the event after cartographic realignment:

EventRoute IDFrom DateTo Date Measure

Event1

Route1

1/1/2000

<Null>

14.2

Honor Referent Location behavior

The Honor Referent Location event behavior preserves the referent offset of the event and updates the event's geographic location and measures.

Events can have event referent fields to derive its location using referent location information. The following referent locations can be stored:

  • Offset distance from any point feature in the geodatabase
  • Offset distance from an intersection point feature
  • Offset distance from a point event feature
  • Offset distance from an x,y coordinate
  • Offset distance from a station

The following table shows the edit activities involved in the route edit and their corresponding event behaviors:

Edit activityEvent behavior

Cartographic realignment

Honor Referent Location

Calibrate

Stay Put

The following table shows referent fields in Event1:

EventRoute ID Referent Location Referent Offset

Event1

Route1

Intersection

5

The route cartographic realignment described above has the following effect:

Event1 was located 5 miles downstream of the intersection on Route1, resulting in a measure of 17. After the cartographic realignment is applied, the intersection's measure is updated to 13 on Route1. When the cartographic realignment Honor Referent Location behavior is applied to Event1, it is still located 5 miles downstream of the intersection. The measure of Event1 is updated to 18 on Route1.

The following image shows the route and event after cartographic realignment:

Route1 and Event1 after cartographic realignment when Honor Referent Location is the configured event behavior
Note:

Because cartographic realignment does not change a route's time slice, the time slice of the event on the route doesn't change either.

The following table provides details about the event after cartographic realignment:

EventRoute IDFrom DateTo Date Measure

Event1

Route1

1/1/2000

<Null>

18

Cartographic realignment on routes in a line network with events that span routes

Routes in a line network can also be cartographically realigned by modifying the associated centerline.

In the following example, there are two routes on LineA and the routes are active from 1/1/2000. The cartographic realignment is set to occur on 1/1/2005 from the middle to the end of Route2. Route2's measures adjust to its new geometry because the Update route measures in cartographic realignment option is enabled for the network. The images and tables in the following sections demonstrate the route information before and after the cartographic realignment.

Before route cartographic realignment

The following image shows the routes before cartographic realignment. There is an intersection on Route2 where Route2 intersects the county boundary. The intersection is the referent location in the Honor Referent Location event behavior scenario below.

The two routes on LineA before cartographic realignment
Note:

The length of cartographic realignment is 1.3 times longer than the part of the route being cartographically realigned.

The following tables provide details about the routes and intersection before cartographic realignment:

Route NameLine NameLine OrderFrom DateTo DateFrom MeasureTo Measure

Route1

LineA

100

1/1/2000

<Null>

0

10

Route2

LineA

200

1/1/2000

<Null>

12

22

Intersection IDFrom DateTo DateRoute Name Measure

Intersection

1/1/2000

<Null>

Route2

15

After route cartographic realignment

The following image shows the route and intersection after cartographic realignment:

The two routes on LineA after cartographic realignment

The following tables provides details about the routes and intersection after cartographic realignment:

Route NameLine NameLine OrderFrom DateTo DateFrom MeasureTo Measure

Route1

LineA

100

1/1/2000

<Null>

0

10

Route2

LineA

200

1/1/2000

<Null>

12

25

Intersection IDFrom DateTo DateRoute Name Measure

Intersection

1/1/2000

<Null>

Route2

15

Note:

When the centerlines are edited, all routes in all networks, across all times, are modified accordingly. Consequently, Route2 does not get a new time slice, but its shape is changed in the existing time slice.

Events before route cartographic realignment

There is a point event on Route2 and it has a start date of 1/1/2000. The following image shows the routes and event before cartographic realignment:

The two routes and Event1 on LineA before cartographic realignment

The following tables provide details about the event before cartographic realignment:

EventRoute NameFrom DateTo Date Measure

Event1

Route2

1/1/2000

<Null>

20

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

Note:

For a line event, its start and end points follow the same cartographic realignment event behavior as a point event.

Honor Route Measure behavior

If the Update route measures in cartographic realignment parameter is enabled for the network and the route measures are updated due to cartographic realignment, the resulting event behavior will be a combination of the cartographic realignment behavior and the calibrate behavior. Events in the cartographic realignment area will move proportionally.

Note:

If the route measures have not changed because the Update route measures in cartographic realignment parameter is disabled for the network, the Honor Route Measure event behavior preserves the measures of the event and updates the event's location.

The following table shows the edit activities involved in the route edit and their corresponding event behaviors:

Edit activityEvent behavior

Cartographic realignment

Honor Route Measure

Calibrate

Stay Put

The route cartographic realignment described above has the following effect:

Event1 was located on Route2 at measure 20. Because it is within cartographic realignment and the route measures have changed, both the cartographic realignment Honor Route Measure and the calibrate Stay Put behaviors are applied. Event1's measure is updated proportionally to measure 22.4 on Route2, and its location is also updated to stay on Route2.

The following image shows the routes and event after cartographic realignment:

The two routes and Event1 on LineA after cartographic realignment when Honor Route Measure is the configured event behavior
Note:

Because cartographic realignment does not change a route's time slice, the time slice of the events on the route doesn't change either.

The following table provides details about the event after cartographic realignment:

EventRoute NameFrom DateTo Date Measure

Event1

Route

1/1/2000

<Null>

22.4

Honor Referent Location behavior

The Honor Referent Location event behavior preserves the referent offset of the event and updates the event's geographic location and measures.

Events can have event referent fields to derive its location using referent location information. The following referent locations can be stored:

  • Offset distance from any point feature in the geodatabase
  • Offset distance from an intersection point feature
  • Offset distance from a point event feature
  • Offset distance from an x,y coordinate
  • Offset distance from a station

The following table shows the edit activities involved in the route edit and their corresponding event behaviors:

Edit activityEvent behavior

Cartographic realignment

Honor Referent Location

Calibrate

Stay Put

The following table shows referent fields in Event1:

EventRoute ID Referent Location Referent Offset

Event1

Route2

Intersection

5

The route cartographic realignment described above has the following effect:

Event1 was located 5 miles downstream of the intersection on Route2, resulting in a measure of 20. After the cartographic realignment is applied, it is still located 5 miles downstream of the intersection which is measure 20 on Route2. The location of Event1 is updated to stay on Route2.

The following image shows the route and event after cartographic realignment:

The two routes and Event1 on LineA after cartographic realignment when Honor Referent Location is the configured event behavior

The following table provides details about the event after cartographic realignment:

EventRoute NameFrom DateTo Date Measure

Event1

Route2

1/1/2000

<Null>

20