Add line events by location offset

Available with Location Referencing license.

Characteristics of a route can be represented as a line event offset from a location. The location offset method is an optional method in the Add Line Events pane and the Add Multiple Line Events pane that is applicable when intersections are found in the active map.

Location offset scenarios

In the examples below, the from measure and to measure of a line event are located using the location offset method.

Nonspanning line event

In the following diagram, the route has measures from 0 to 10 miles. The Event1 from measure is located 2 miles from the intersection on the left and the to measure is -4 miles from the intersection on the right.

Since the direction of calibration of the route is from left to right, the offset distance is calculated in the reverse direction (from right to left) and the offset distance in the second case is shown as a negative number. Alternatively, the to measure in this case can be located by an offset distance of 6 miles from the intersection on the left.

Spanning line event

In the following diagram, a line event spans routes on a line in a line network. Event1 has a from measure of 5 on Route1 and a to measure of 35 on Route3. Because the from measure is upstream of the intersection, the offset distance is -10 miles, and the offset distance of the to measure is 10 miles. In this case, both measures refer to the same intersection.

Add a line event by location offset

Complete the following steps using the Add Line Event tool to create a single line event using location offset:

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

   The Add Line Event pane appears. The From Method and To Method drop-down lists are populated with the Route and Measure value by default.

3. Click the From Method drop-down arrow and choose Location Offset.
4. Click the To Method drop-down arrow and choose Location Offset.

   Using the Location Offset method, the measure location is based on an offset from a specified location.

   

5. Click Next.

   The Event Layer and Network options and the Location Offset sections appear in the Add Line Event pane.

6. Click the Event Layer drop-down arrow and choose the line event layer.

   The parent LRS Network is populated based on the Event Layer value.

7. If the network is a line network, specify the name of the line feature on which the events is located by doing one of the following:
   • Type the line name in the Line Name text box.
   • Click Choose line from map and select the line from the map.

   The line is highlighted in light blue. The arrow at the end shows the direction of calibration of the line.

   

8. In the From: Location Offset section, specify the route by doing one of the following:
   • Click the Route Name drop-down arrow and choose the route on which the event's from measure will be located.
   • Type the route name in the Route Name text box.
   • Click Choose route from map and click the route on the map.

   Tip:

   If the parent LRS Network is a line network, you can also choose the route from the Route Name drop-down list. Only routes that are part of the chosen line can be selected.

9. Click the Location drop-down arrow and choose an intersection layer name.
10. Specify the name of the intersection record by doing one of the following:
    • Type the intersection name in the Name text box.

      Tip:

      The name will automatically complete if found.

    • Click the Choose location from map tool and click an intersection point feature on the map.
11. Specify the Offset value for the location by doing one of the following:
    • Click the Offset drop-down arrow to choose the offset direction, type the measure value, and choose the units.
    • Type the measure value and choose the units.
    • Click Choose offset from map and click a location along the route on the map.

    A green dot appears at the offset location along the route on the map. This is the location of the from measure value for the event.

    Note:

    • This value is the distance between the chosen intersection and the proposed from measure on the selected route.
    • The direction is an optional selection.
    • If no direction is selected, a positive offset value places the from measure location along the direction of calibration from the selected point feature.
    • If no direction is selected, a negative offset value places the from measure location opposite the direction of calibration from the selected point feature.
12. In the To: Location Offset section, specify the route by doing one of the following:
    • Click the Route Name drop-down arrow and choose the route on which the event's to measure will be located.
    • Type the route name in the Route Name text box.
    • Click Choose route from map and click the route on the map.

    If the routes are on a line in a line network, only routes that are part of the specified line can be selected.

13. Click the Location drop-down arrow and choose an intersection layer name.
14. Specify the name of the intersection record by doing one of the following:
    • Type the intersection name in the Name text box.

      Tip:

      The name will automatically complete if found.

    • Click the Choose location from map tool and click an intersection point feature on the map.
15. Specify the Offset value for the reference offset by doing one of the following:
    • Click the Offset drop-down arrow to choose the offset direction, type a measure, and choose the units.
    • Type the measure value and choose the units.
    • Click the Choose offset from map tool and click a location along the route on the map.

    A red dot appears at the offset location along the route on the map. This is the location of the to measure value for the events.

    Note:

    • This value is the distance between the chosen intersection and the proposed to measure on the selected route.
    • The direction is an optional selection.
    • If no direction is selected, a positive offset value places the from measure location along the direction of calibration from the selected point feature.
    • If no direction is selected, a negative offset value places the from measure location opposite the direction of calibration from the selected point feature.
16. Provide the date that defines the start date of the events by doing one of the following:
    • Type the start date in the Start Date text box.
    • Click Calendar and choose the start date.

    Note:

    The start date cannot be before the start date of the selected route.

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

17. Provide the date that defines the end date of the events by doing one of the following:
    • Type the end date in the End Date text box.
    • Click Calendar and choose the end date.

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

18. Choose a data validation option to prevent erroneous input while characterizing a route with linear 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. Optionally, refer to the retire overlaps scenarios for more detailed examples.

      

    • 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. Optionally, refer to the merge coincident events scenarios for more detailed examples.

      

19. Click Next.

    Manage Attributes appears.

20. Provide attribute information for the new event using the Manage Attributes settings.

    Some custom fields in the event layer accept text entry, while other fields may only accept selection from among configured values.

    

21. Click Run.

    The new line event is created and appears on the map. A confirmation message appears at the top of the pane once the newly added line event is created.

Add multiple line events by location offset

Complete the following steps using the Add Multiple Line Events tool to create line events using location offset:

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

   The Add Multiple Line Events pane appears with the default Route and Measure value.

3. Click the From Method drop-down arrow and choose Location Offset.
4. Click the To Method drop-down arrow and choose Location Offset.

   

5. Click Next.

   The Network and Location Offset sections appear in the Add Multiple Line Events pane.

6. Click the Network drop-down arrow and choose the parent LRS Network of the line event layer.
7. If the network is a line network, specify the name of the line feature on which the events will be located by doing one of the following:
   • Type the line name in the Line Name text box.
   • Click Choose line from map

   The line is highlighted in light blue. The arrow at the end shows the direction of calibration of the line.

   

8. In the From: Location Offset section, specify the route by doing one of the following:
   • Type the route name.
   • Click the Route Name drop-down arrow and choose the route on which the event's from measure will be located.
   • Click Choose route from map and click the route on the map.

   If the routes are on a line in a line network, only routes that are part of the chosen line can be selected.

9. Click the Location drop-down arrow and choose an intersection layer name.
10. Specify the name of the intersection record by doing one of the following:
    • Type the intersection name in the Name text box.

      Tip:

      The name will automatically complete if found.

    • Click the Choose location from map tool and click an intersection point feature on the map.
11. Specify the Offset value for the location by doing one of the following:
    • Click the Offset drop-down arrow to choose the offset direction, type the measure value, and choose the units.
    • Type the measure value and choose the units.
    • Click Choose offset from map and click a location along the route on the map.

    A green dot appears at the offset location along the route on the map. This is the location of the from measure value for the event.

    Note:

    • This value is the distance between the chosen intersection and the proposed from measure on the selected route.
    • The direction is an optional selection.
    • If no direction is selected, a positive offset value places the from measure location along the direction of calibration from the selected point feature.
    • If no direction is selected, a negative offset value places the from measure location opposite the direction of calibration from the selected point feature.
12. In the To: Location Offset section, specify the route by doing one of the following:
    • Click the Route Name drop-down arrow and choose the route on which the event's to measure will be located.
    • Type the route name in the Route Name text box.
    • Click Choose route from map and click the route on the map.

    If the routes are on a line in a line network, only routes that are part of the specified line can be selected.

13. Click the Location drop-down arrow and choose an intersection layer name.
14. Specify the name of the intersection record by doing one of the following:
    • Type the intersection name in the Name text box.

      Tip:

      The name will automatically complete if found.

    • Click the Choose location from map tool and click an intersection point feature on the map.
15. Specify the Offset value for the reference offset by doing one of the following:
    • Click the Offset drop-down arrow to choose the offset direction, type a measure, and choose the units.
    • Type the measure value and choose the units.
    • Click the Choose offset from map tool and click a location along the route on the map.

    A red dot appears at the offset location along the route on the map. This is the location of the to measure value for the events.

    Note:

    • This value is the distance between the chosen intersection and the proposed to measure on the selected route.
    • The direction is an optional selection.
    • If no direction is selected, a positive offset value places the from measure location along the direction of calibration from the selected point feature.
    • If no direction is selected, a negative offset value places the from measure location opposite the direction of calibration from the selected point feature.
16. Provide the date that defines the start date of the events by doing one of the following:
    • Type the start date in the Start Date text box.
    • Click Calendar and choose the start date.

    Note:

    The start date cannot be before the start date of the selected route.

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

17. Provide the date that defines the end date of the events by doing one of the following:
    • Type the end date in the End Date text box.
    • Click Calendar and choose the end date.

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

18. Choose a data validation option to prevent erroneous input while characterizing a route with linear 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. Optionally, refer to the retire overlaps scenarios for more detailed examples.

      

    • 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. Optionally, refer to the merge coincident events scenarios for more detailed examples.

      

19. Click Next.

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

    The Attribute Set list includes other attribute sets if configured.

20. Provide attribute information for the events in the Manage Attributes settings.

    

    Note:

    Click Copy attribute values by selecting event on the map and click a route on the map to copy event attributes from another route.

21. Click Run.

    The new line events are created and appear on the map. A confirmation message appears at the top of the pane once the newly added line events are created.

Referent offset when using the location offset method

The Pipeline Referencing events data model supports the configuration of referent 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 line events are created using the location offset method in a referent-enabled layer, the intersection layer's name is used as the From RefMethod and ToRefMethod values, and the intersection ID is used as the FromRefLocation and ToRefLocation 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:

The following table provides details about the routes:

Route ID	From Measure	To Measure	From Date	To Date
R1	0	5	1/1/2000	<Null>
R2	7	12	1/1/2000	<Null>
R3	13	18	1/1/2000	<Null>

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

FromRefMethod	FromRefLocation	FromRefOffset	ToRefMethod	ToRefLocation	ToRefOffset
<Null>	<Null>	<Null>	<Null>	<Null>	<Null>

After adding a line event with referents

The following diagram shows a line event that has been added to an event layer that has referents enabled:

The following table provides details about the event referent fields in Event1 after event creation. The Intersection layer is used as the FromRefMethod and ToRefMethod values, and the intersection is used as the FromRefLocation and ToRefLocation values.

FromRefMethod	FromRefLocation	FromRefOffset	ToRefMethod	ToRefLocation	ToRefOffset
IntersectionLayer	Intersection1	-7.5	IntersectionLayer	Intersection1	7.5

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

Event ID	FromRouteID	ToRouteID	From Date	To Date	From Measure	To Measure
Event1	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 FromRefMethod, ToRefMethod, FromRefLocation, and ToRefLocation values revert to the route.

Before adding multiple line events with referents

The following diagram shows the routes before event creation:

The following table provides details about the routes:

Route ID	From Measure	To Measure	From Date	To Date
R1	0	5	1/1/2000	<Null>
R2	7	12	1/1/2000	<Null>
R3	13	18	1/1/2000	<Null>

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

FromRefMethod	FromRefLocation	FromRefOffset	ToRefMethod	ToRefLocation	ToRefOffset
<Null>	<Null>	<Null>	<Null>	<Null>	<Null>

After adding multiple line events with referents

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

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

FromRefMethod	FromRefLocation	ToRefMethod	ToRefLocation	FromRefOffset	To RefOffset
IntersectionLayer	Intersection1	IntersectionLayer	Intersection1	-7.5	7.5

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

ConsequenceSegment

Event ID	FromRouteID	ToRouteID	From Date	To Date	From Measure	To Measure
Event1	R1	R3	1/1/2000	<Null>	0	18

DOTClass

Event ID	FromRouteID	ToRouteID	From Date	To Date	From Measure	To Measure
Event1	R1	R3	1/1/2000	<Null>	0	18

ExcavationDamage

Event ID	FromRouteID	ToRouteID	From Date	To Date	From Measure	To Measure
Event1	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 FromRefMethod, ToRefMethod, FromRefLocation, and ToRefLocation values revert to the route.

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

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

Event ID	Event Layer	Class Type
Event A	DOT Class	Class 1

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

Event ID	Route Name	From Measure	To Measure	From Date	To 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>:

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

Event ID	Event Layer	Class Type
EventB	DOT Class	Class 2

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

Event ID	Route Name	From Measure	To Measure	From Date	To 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:

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

Event ID	Event Layer	Class 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 ID	Route Name	From Measure	To Measure	From Date	To 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 DOT Class event and an Operating Pressure Range 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:

The following table provides details about the custom values for EventA and EventC. The DOT Class layer has the custom fields Class Type and Class Source, and the Operating Pressure Range layer has the custom fields Pressure Type and Pressure Value.

Event ID	Event Layer	Custom Value 1	Custom Value 2
EventA	DOT Class	Class 1	Calculated
EventC	Operating Pressure Range	Design	500

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

Event ID	Route Name	From Measure	To Measure	From Date	To 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>:

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

Event ID	Event Layer	Custom Value 1	Custom Value 2
EventB	DOT Class	Class 2	Calculated
EventD	Operating Pressure Range	Certificate	700

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

Event ID	Route Name	From Measure	To Measure	From Date	To 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:

The following table provides details about the custom values for EventA and EventB in DOT Class, as well as EventC and EventD in Operating Pressure Range:

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 ID	Event Layer	Custom Value 1	Custom Value 2
EventA	DOT Class	Class 1	Calculated
EventB	DOT Class	Class 2	Calculated
EventC	Operating Pressure Range	Design	500
EventD	Operating Pressure Range	Certificate	700

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

Event ID	Route Name	From Measure	To Measure	From Date	To 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 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:

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

Event ID	Event Layer	Class Type
Event A	DOT Class	Class 1

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

Event ID	Route Name	From Measure	To Measure	From Date	To 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>:

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

Event ID	Event Layer	Class Type
[NewEvent input]	DOT Class	Class 1

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

Event ID	Route Name	From Measure	To Measure	From Date	To 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:

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

Event ID	Event Layer	Class 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 ID	Route Name	From Measure	To Measure	From Date	To Date
EventA	Route1	0	8	1/1/2000	<Null>

Multiple events scenario

In this example, Route1 has two existing events, a DOT Class event (EventA) and an Operating Pressure Range 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:

The following table provides details about the custom values for EventA and EventB before the edit. The DOT Class layer has the custom field Class Type with the value Class 1, and the Operating Pressure Range layer has the custom field Pressure Type with the value Design.

Event ID	Event Layer	Custom Value 1
EventA	DOT Class	Class 1
EventB	Operating Pressure Range	Design

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

Event ID	Route Name	From Measure	To Measure	From Date	To 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>:

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

Event ID	Event Layer	Custom Value
[NewEvent1 input]	DOT Class	Class 1
[NewEvent2 input]	Operating Pressure Range	Design

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

Event ID	Route Name	From Measure	To Measure	From Date	To 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.

The following table provides details about the custom values for EventA in DOT Class and EventB in Operating Pressure Range. DOT Class has two event records with the custom Class Type value, Class 1. Operating Pressure Range also has two event records with the custom Pressure Type value, Design.

Event ID	Event Layer	Custom Value
EventA	DOT Class	Class 1
EventA	DOT Class	Class 1
EventB	Operating Pressure Range	Design
EventB	Operating Pressure Range	Design

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

Event ID	Route Name	From Measure	To Measure	From Date	To 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>