Add a line event by route and measure

This ArcGIS 3.1 documentation has been archived and is no longer updated. Content and links may be outdated. See the latest documentation.

Available with Pipeline 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 Line Event tool to add line events to the geodatabase.

ArcGIS Pipeline Referencing allows you to add events that span multiple routes on a line.

Add a line event by route and measure

The example in the following workflow demonstrates adding a line event.

Before event creation

The following table provides details about attributes for the routes (LA_Route1, LA_Route2, and LA_Route3) that belong to LineA:

Route IDFrom DateTo Date

LA_Route1

1/1/2000

<Null>

LA_Route2

1/1/2000

<Null>

LA_Route3

1/1/2000

<Null>

Complete the following steps to add a line event by route and measure:

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

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

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

    Add Line Event pane
  3. Click Next.

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

    Add Line Event pane with route and measure and dates fields
  4. Click the Event Layer drop-down arrow and choose the line event layer.

    The Network layer is automatically populated once the event layer is chosen. 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. If the selected event layer's parent network is a line network, click Choose line from map Choose line from map and choose a value to populate the Line Name text box.

    Alternatively, provide the line name in the Line Name text box.

  6. Click Choose route from map Choose route from map and click the route on the map to populate the route value.
    Note:

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

  7. In the From: Route and Measure section, specify the start measure for the new line event 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 start measure value along the route on the map.
    • Check the Route start date check box.
    • Provide the start measure value in the Measure text box.
    Note:

    After clicking the Choose route from map button Choose route from map or the Choose measure from map button 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 display of route and measure information on the Options dialog box on the Location Referencing tab.

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

  8. Optionally, in the To: Route and Measure section, specify the end measure for the new line event 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 select the start measure value along the route on the map.
    • 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 event will be created between the green and the red points.

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

    The start date default value is today's date, but you can choose a different date using the date picker.

  10. 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.
    • 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 event start date into the future.

  11. 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 are created. For more information, refer to the retire overlaps scenarios.
      Scenario of retire overlaps behavior
    • Merge coincident events—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, the new event is merged with the existing event and the measure range is expanded accordingly. For more information, refer to the merge coincident events scenarios
      Scenario of merge coincident events
  12. Click Next.

    The attributes for the chosen event layer appear under Manage Attributes.

  13. Provide attribute value information for the event.
    Add Line Event 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.

    Note:

    Coded value domains, range domains, subtypes, contingent values, and attribute rules are supported when configured for a field.

  14. Click Run.

    A confirmation message appears once the line event is added and appears on the map.

The following table provides details about the spanning event after adding the line event:

EventFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorMAOP Design Pressure

Event1

LA_Route1

LA_Route3

1/1/2000

<Null>

5

35

No Error

800

The following diagram shows the routes and the spanning event after the tool is run:

The spanning event begins on LR_Route1 and ends on LA_Route3.

Referent offset when using the route and measure method

The Pipeline Referencing 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 a line event is created using route and measure in a referent-enabled layer, the parent LRS Network is used by default as the FromRefMethod and ToRefMethod values, and the route is used as the FromRefLocation and ToRefLocation values. The from and to measures of the line event 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 a line event that has referent values enabled.

Before adding a line event with referents

The following diagram shows the routes before event creation:

Before event creation with referents

The following table provides details about the routes:

Route IDFrom DateTo DateFrom MeasureTo Measure

R1

1/1/2000

<Null>

0

5

R2

1/1/2000

<Null>

7

12

R3

1/1/2000

<Null>

13

18

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

FromRefMethodFromRefLocationFromRefOffsetToRefMethodToRefLocationToRefOffset

<Null>

<Null>

<Null>

<Null>

<Null>

<Null>

After adding a line event with referents

The following diagram shows the route and an associated event:

After event creation with referents

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

FromRefMethodFromRefLocationFromRefOffsetToRefMethodToRefLocationToRefOffset

PipeSeriesNetwork

R1

0

PipeSeriesNetwork

R3

18

The following table shows the default event fields after event creation:

From Route IDTo Route IDFrom DateTo DateFrom MeasureTo Measure

R1

R3

1/1/2000

<Null>

0

18

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 scenario

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

In this example, Route1 has an existing DOT Class event that has dates from 1/1/2000 to <Null>. The impact of adding a second DOT Class 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 LayerClass Type

Event A

DOT Class

Class 1

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>:

A second overlapping event is added.

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

Event IDEvent LayerClass Type

EventB

DOT Class

Class 2

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:

Event IDEvent LayerClass Type

EventA

DOT Class

Class 1

EventB

DOT Class

Class 2

Tip:

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

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>

Merge coincident events scenario

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

In this example, Route1 has an existing DOT Class event that has dates from 1/1/2000 to <Null>. The impact of adding a DOT Class event that has coincident measures when Merge coincident events 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 LayerClass Type

Event A

DOT Class

Class 1

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 LayerClass Type

[NewEvent input]

DOT Class

Class 1

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 LayerClass Type

EventA

DOT Class

Class 1

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>