Add multiple line events by route and measure

Available with Location Referencing license.

Characteristics of a route can be represented as a line event with start and end measure information along the route. Use the Add Multiple Line Events tool Add multiple line events to add multiple line events at the same time.

Add multiple line events scenario

The example in the following workflow demonstrates adding multiple line events.

The following diagram shows the route attributes. The route (Route1) has measures from 12 to 15.

Before adding line events to a route

The following table provides details about the route attributes:

Route IDFrom DateTo Date

Route1

1/1/2000

<Null>

Add multiple line events by route and measure

Complete the following steps to add multiple line events by route and measure:

  1. Open the map in ArcGIS Pro and zoom in to the location where you want to add the line events.
  2. Click the Location Referencing tab, and in the Events group, click Add > Multiple Line Events Add multiple line events.

    The Add Multiple Line Events pane appears with the Route and Measure default value as the From Measure and To Measure values.

    Add Multiple Line Events pane

    Using the Route and Measure method, the measure location is based on the measure values from the selected route.

  3. Click Next.

    The From: Route and Measure, To: Route and Measure and Dates sections appear in the Add Multiple Line Events pane.

    Add Multiple Line Events pane with route and measure fields
  4. Click the Network drop-down arrow and choose the LRS Network of the route where you want to add line events.

    The network serves as the source linear referencing method (LRM) to define the input measures for the event.

    The network is an LRS Network published as a layer in the feature service.

  5. In the From: Route and Measure section, click the Choose route from map button Choose route from map and click the route on the map.

    Alternatively, provide the route ID in the Route ID text box.

    Note:

    After clicking Choose route from map Choose route from map or Choose measure from map Choose measure from map, you can hover over the route to see the route and measure at the location of the pointer.

    You can set map scale options for the display of route and measure information on the Options dialog box, on the Location Referencing tab.

    Note:

    If a message regarding acquiring locks or reconciling appears, conflict prevention is enabled.

  6. In the From: Route and Measure section, specify the start measure for the new line events along the route by doing one of the following to populate the Measure text box:
    • Click Choose measure from map Choose measure from map and click the route on the map where you want the start measure placed.
    • Check the Use route start measure check box.
    • Provide the start measure value in the Measure text box.

    A green point appears at the selected location on the map.

  7. In the To: Route and Measure section, specify the end measure for the new line events along the route by doing one of the following to populate the Measure text box:
    • Click Choose measure from map Choose measure from map and click the route on the map where you want to place the end measure value.
    • Check the Use route end measure check box.
    • Provide the end measure value in the Measure text box.

    A red point appears at the selected location on the map.

    The new events are created between the green and red dots.

  8. Specify the start date of the line events by doing one of the following:
    • Provide the start date in the Start Date text box.
    • Check the Route start date check box.
    • Double-click in the Start Date text box to use today's date.
  9. Optionally, specify the end date of the event by doing one of the following:
    • Click Calendar Calendar and choose the end date.
    • Provide the end date in the End Date text box.
    • Check the Route end date check box.
    • Double-click in the End Date text box to use today's date.

    If no end date is provided, the event remains valid from the start date into the future.

  10. Choose a data validation option to prevent erroneous input while characterizing a route with line events.
    • Retire overlaps—The measure, start date, and end date of existing events are adjusted to prevent overlaps with respect to time and measure values once the new line event or events have been created. Refer to the retire overlaps scenarios for more examples.
      Retire overlaps behavior simple scenario
    • Merge coincident events—The new event is merged with the existing event and the measure range is expanded accordingly when all attribute values for a new event are exactly the same as an existing event, and if the new event is adjacent to or overlapping an existing event in terms of its measure values, and its time slices are coincident or overlapping. Refer to the merge coincident events scenarios for more examples.
      Merge coincident events simple scenario
  11. Click Next.

    Manage Attributes appears in the pane with the default attribute set in the Attribute Set drop-down list.

    The Attribute Set drop-down list includes other attribute sets if configured.

  12. Optionally, choose an attribute set from the Attribute Set drop-down list.
  13. Provide attribute value information for the events in the attribute set.
    Add Multiple Line Events pane with Manage Attributes
    Note:

    Click Copy attribute values by selecting event on the map Copy attribute values by selecting event on the map and click an existing line event belonging to the same event layer on the map to copy event attributes from that event.

  14. Click Run.

    A confirmation message appears once the line events are added and appear on the map.

The following tables provide details about the line events by event layer:

Counter Peak Lanes

EventRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorCounter Peak Lanes

Event1

Route1

1/1/2000

<Null>

12

15

No Error

3

Cracking Percent

EventRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorCracking Percent

Event1

Route1

1/1/2000

<Null>

12

15

No Error

12

Directional Factor

EventRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorDirectional Factor

Event1

Route1

1/1/2000

<Null>

12

15

No Error

100

Facility Type

EventRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorFacility Type

Event1

Route1

1/1/2000

<Null>

12

15

No Error

One-Way Roadway

IRI

EventRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorIRI

Event1

Route1

1/1/2000

<Null>

12

15

No Error

60

Lane Width

EventRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorLane Width

Event1

Route1

1/1/2000

<Null>

12

15

No Error

15

Median Width

EventRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorMedian Width

Event1

Route1

1/1/2000

<Null>

12

15

No Error

7

The following diagram shows the route and the associated line events on Route1 from 12 to 15 after the edit:

After adding multiple line events to a route using the Add Multiple Line Events tool

Referent offset when using the route and measure method

The Roads and Highways events data model supports the configuration of referent event fields and their enablement using the Enable Referent Fields tool. Once referent fields are configured and enabled in a layer, referent locations are populated and persisted in that layer when events are added or edited.

When events are created using route and measure in a referent-enabled layer, the parent LRS Network is used as the FromRefMethod and ToRefMethod values by default, and the route is used as the FromRefLocation and ToRefLocation values. The from and to measures of the new line events are used as the FromRefOffset and ToRefOffset values.

If either measure of a line event is updated, the corresponding offset value updates to reflect the new measure.

The examples below demonstrate the impact of adding multiple line events that have referent values enabled.

Before adding multiple line events with referents

The following diagram shows the routes before event creation:

Before adding spanning line event to routes on a line in a line network

The following table provides details about the routes:

Route IDFrom DateTo DateFrom MeasureTo Measure

Route1

1/1/2000

<Null>

12

15

After adding multiple line events with referents

The following diagram shows multiple line events that have referents enabled:

After event creation

The following table provides details about the event referent fields after event creation:

FromRefMethodFromRefLocationFromRefOffsetToRefMethodToRefLocationToRefOffset

AllRoutes

Route1

12.64

AllRoutes

Route1

14.91

The following tables provide details about the default event fields after event creation:

Counter Peak Lanes

Event IDFrom DateTo DateFrom MeasureTo Measure

Event1

1/1/2000

<Null>

12.64

14.91

Cracking Percent

Event IDFrom DateTo DateFrom MeasureTo Measure

Event1

1/1/2000

<Null>

12.64

14.91

Directional Factor

Event IDFrom DateTo DateFrom MeasureTo Measure

Event1

1/1/2000

<Null>

12.64

14.91

You can edit the event using the attribute table so that it uses referents other than the default. If subsequent route edits are made, the RefMethod and RefLocation values revert to the parent LRS Network and the route, respectively.

Retire overlaps scenarios

The examples below demonstrate adding line events that overlap when the Retire overlaps check box is checked.

Single event scenario

In this example, Route1 has an existing Speed Limit event that has dates from 1/1/2000 to <Null>. The impact of adding a second Speed Limit event with overlapping measures is demonstrated.

The following diagram shows the route and the existing event:

Route 1 has an existing event from 5 to 7.

The following table provides details about the custom values for EventA before the edit:

Event IDEvent LayerSpeed

Event A

Speed Limit

65

The following table provides details about the default field values for EventA before the edit:

Event IDRoute NameFrom MeasureTo MeasureFrom DateTo Date

EventA

Route1

3

7

1/1/2000

<Null>

The following diagram shows the route and a second event that is added with dates from 1/1/2005 to <Null>:

An overlapping event is added.

The following table provides details about the custom values for EventB:

Event IDEvent LayerSpeed

EventB

Speed Limit

45

The following table provides details about the default field values for EventB after the edit:

Event IDRoute NameFrom MeasureTo MeasureFrom DateTo Date

EventB

Route1

5

7

1/1/2005

<Null>

The following diagram shows the impact of checking the Retire Overlaps check box on the route and both events:

A second overlapping event is added.

The following table provides details about the custom values for both events after event creation:

Tip:

EventA has two event records with identical custom values with different dates (and different from and to measures).

Event IDEvent LayerSpeed

EventA

Speed Limit

65

EventB

Speed Limit

45

The following table provides details about the default values after retire overlaps is applied:

Event IDRoute NameFrom MeasureTo MeasureFrom DateTo Date

EventA

Route1

3

7

1/1/2000

1/1/2005

EventA

Route1

3

5

1/1/2005

<Null>

EventB

Route1

5

7

1/1/2005

<Null>

Multiple events scenario

In this example, Route1 has two existing events, a Speed Limit event and a Parking event, both of which have dates from 1/1/2000 to <Null>. The impact of adding a second pair of events in the same event layers that have overlapping measures is demonstrated.

The following diagram shows the route and the existing events:

Route 1 has multiple existing events.

The following table provides details about custom values for EventA and EventC. The Speed Limit layer has the custom fields Speed and Units, and the Parking layer has the custom fields Side and Type.

Event IDEvent LayerCustom Value 1Custom Value 2

EventA

Speed Limit

65

Miles per hour

EventC

Parking

Left Only

Diagonal

The following table provides details about the default field values for EventA and EventC before the edit:

Event IDRoute NameFrom MeasureTo MeasureFrom DateTo Date

EventA

Route1

3

7

1/1/2000

<Null>

EventC

Route1

2

7

1/1/2000

<Null>

The following diagram shows the route and two new events in the same event layers that are added with dates from 1/1/2005 to <Null>:

An overlapping event is added.

The following table provides details about the custom values for EventB and EventD:

Event IDEvent LayerCustom Value 1Custom Value 2

EventB

Speed Limit

45

Miles per hour

EventD

Parking

Both

Parallel

The following table provides details about the default field values for EventB and EventD:

Event IDRoute NameFrom MeasureTo MeasureFrom DateTo Date

EventB

Route1

5

7

1/1/2005

<Null>

EventD

Route1

5

7

1/1/2005

<Null>

The following diagram shows the route and events after retire overlaps has been applied:

A second overlapping event is added.

The following table provides details about the custom values for EventA and EventB in Speed Limit, as well as EventC and EventD in Parking. Each event layer has two custom fields: Speed Limit has the custom fields Speed and Units, and Parking has the custom fields Side and Type.

Tip:

Each event has multiple custom fields whose values are shown in the Custom Value 1 and Custom Value 2 columns in the following table. Values in these columns correspond to the Event Layer value in the same row.

Event IDEvent LayerCustom Value 1Custom Value 2

EventA

Speed Limit

65

Miles per hour

EventB

Speed Limit

45

Miles per hour

EventC

Parking

Left Only

Diagonal

EventD

Parking

Both

Parallel

The following table provides details about the default values after retire overlaps is applied:

Event IDRoute NameFrom MeasureTo MeasureFrom DateTo Date

EventA

Route1

3

7

1/1/2000

1/1/2005

EventC

Route1

2

7

1/1/2000

1/1/2005

EventA

Route1

3

5

1/1/2005

<Null>

EventC

Route1

2

5

1/1/2005

<Null>

EventB

Route1

5

7

1/1/2005

<Null>

EventD

Route1

5

7

1/1/2005

<Null>

Merge coincident events scenarios

The examples below demonstrate adding line events that have coincident measures when the Merge coincident events check box is checked.

Single event scenario

In this example, Route1 has an existing Speed Limit event that has dates from 1/1/2000 to <Null>. The impact of adding a Speed Limit event that has coincident measures when the Merge coincident events check box is checked is demonstrated.

The following diagram shows the route and the existing event:

Route 1 has an existing event from 0 to 4.

The following table provides details about the custom values for EventA:

Event IDEvent LayerSpeed

Event A

Speed Limit

65

The following table provides details about the default field values for EventA before the edit:

Event IDRoute NameFrom MeasureTo MeasureFrom DateTo Date

EventA

Route1

0

4

1/1/2000

<Null>

The following diagram shows the route and a second event that is added with dates from 1/1/2000 to <Null>:

An event with coincident measures is added.

The following table provides details about the custom values for the new input:

Event IDEvent LayerSpeed

[NewEvent input]

Speed Limit

65

The following table provides details about the default field values for the new input:

Event IDRoute NameFrom MeasureTo MeasureFrom DateTo Date

[NewEvent input]

Route1

4

8

1/1/2000

<Null>

The following diagram shows the impact of checking the Merge coincident events check box when adding the new event:

EventA after the new event is merged

The following table provides details about the custom values for the event after event creation:

Event IDEvent LayerSpeed

EventA

Speed Limit

65

The following table provides details about the default values after the new event measures are merged with EventA:

Event IDRoute NameFrom MeasureTo MeasureFrom DateTo Date

EventA

Route1

0

8

1/1/2000

<Null>

Multiple events scenario

In this example, Route1 has two existing events, a Speed Limit event (EventA) and a Parking event (EventB), both of which have dates from 1/1/2000 to <Null>. The impact of adding a second pair of events that have coincident measures in the same event layers, but different from and to dates, is demonstrated.

The following diagram shows the route and the existing events:

Route 1 has multiple existing events.

The following table provides details about the custom values for EventA and EventB before the edit. The Speed Limit layer has the custom field Speed with the value 65, and the Parking layer has the custom field Side with the value Left Only.

Event IDEvent LayerCustom Value 1

EventA

Speed Limit

65

EventB

Parking

Left Only

The following table provides details about the default field values for EventA and EventB before the edit:

Event IDRoute NameFrom MeasureTo MeasureFrom DateTo Date

EventA

Route1

0

4

1/1/2000

<Null>

EventB

Route1

0

5

1/1/2000

<Null>

The following diagram shows the route and input for the new events that are added with dates from 1/1/2005 to <Null>:

Input for two new events

The following table provides details about the custom values in the new event inputs:

Event IDEvent LayerCustom Value

[NewEvent1 input]

Speed Limit

65

[NewEvent2 input]

Parking

Left Only

The following table provides details about the default field values in the new event inputs:

Event IDRoute NameFrom MeasureTo MeasureFrom DateTo Date

[NewEvent1]

Route1

4

8

1/1/2005

<Null>

[NewEvent2]

Route1

4

8

1/1/2005

<Null>

The following diagram shows the route and events after the new events have been merged based on the coincident measures. In this case, the dates result in a new event record, or new time slice, for the existing events with the updated measures.

Merged coincident events

The following table provides details about the custom values for EventA in Speed Limit and EventB in Parking. Speed Limit has two event records with the Speed value 65. Parking also has two event records with the custom Side value Left Only.

Event IDEvent LayerCustom Value

EventA

Speed Limit

65

EventA

Speed Limit

65

EventB

Parking

Left Only

EventB

Parking

Left Only

The following table provides details about the default values after events are merged:

Event IDRoute NameFrom MeasureTo MeasureFrom DateTo Date

EventA

Route1

0

4

1/1/2000

1/1/2005

EventA

Route1

0

8

1/1/2005

<Null>

EventB

Route1

0

5

1/1/2000

1/1/2005

EventB

Route1

0

8

1/1/2005

<Null>