Add line events to dominant routes

Available with Location Referencing license.

The Add Line Event tool allows you to add line events to dominant routes where route concurrencies exist.

Concurrent routes

Concurrent routes are routes that share the same centerlines. This relationship may exist to model two routes with different directions of calibration. Where these concurrent routes exist, you can use a set of rules to choose a route that's considered dominant.

You can add line events to dominant routes using the Add Line Event tool. For example, in the following image, there are three routes named L1Route2B, L0Route1B, and L4Route4B.

The route dominance rule is set as the lesser the route name, the more dominant the route.

To add line events from the start to the end of route L1Route2B, that process is done in four sections as shown in the following image and table:

The callout numbers in the image above correspond to the numbers in the following table:

Section	Description
	Route L1Route2B is the dominant route because no other route exists in this section.
	Route L0Route1B has the greater order of dominance; the event is added to route L0Route1B.
	Route L1Route2B is the dominant route based on the dominance rule in this section.
	Route L1Route2B is the dominant route because no other route exists in this section.

Note:

• Configure route dominance rules to access this functionality.
• Events in the attribute set must belong to the same network as the selected Route Name value.
• You can add events to one route at a time.

Concurrent routes with different time ranges

The following image shows concurrent routes with different time ranges:

Route L1Route2B has a start date of 1/1/2000, and route L0Route1B and route L4Route4B both have a start date of 1/1/2010. As a result, if the selected start date of the event is 1/1/2000, there are two route time ranges as follows:

• 1/1/2000 to 1/1/2010, when only route L1Route2B existed.

  

• 1/1/2010 to Null, when all three routes existed.

  

Concurrent routes in a line for spanning event

The following image shows concurrent routes in a line for a spanning event:

Concurrent sections are identified route by route and the table contains all of the routes in the span of the line event being added.

Add the line events

To add line events to dominant routes, complete the following steps:

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 .

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

   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 Line Event pane.

   

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 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 and select the route on the map to populate the Route Name 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 by doing one of the following to populate the Measure text box:
   • Click Choose measure from map and select 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.

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

8. Optionally, for spanning events, in the To: Route and Measure section, click Choose route from map and click the end route on the map.

   Alternatively, provide the route name in the Route Name text box.

9. 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 and select the end 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 red points.

10. Specify the start date of the event by doing one of the following:
    • Click Calendar and choose the start date.
    • 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 the current date.

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

11. Optionally, specify the end date of the event by doing one of the following:
    • Click 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 the current date.

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

12. 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 Retire overlaps scenarios.

      

    • 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 Merge coincident events scenarios.

      

13. Check the Add event to dominant route check box.
14. Click Next.

    The route dominance table appears in the Add Line Event pane.

    

    The From Measure and To Measure columns show the values for each section of the chosen route from the previous pane. The From Measure and To Measure boxes under Route Name show the value for each dominant route where the events are added.

    A route name in black text without a drop-down arrow signifies that there was a single route in that section. A route name in blue text with a drop-down arrow signifies that there are concurrent routes in that section, and the route in blue text is selected automatically based on the route dominance rules. You can manually select any other route using the drop-down arrow.

    If you checked the Merge coincident events check box, the records in sections 3 and 4 are merged because they have the same route name.

15. Click Next.

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

16. Provide attribute value information for the event.

    

    Note:

    Click 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.

17. Click Run.

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