Skip to main content

Add a point event by route and measure

Available with the Linear Referencing license.

You can represent route characteristics as point events with measure information along the route. Use the Add Point Event tool to add a point event.

Before using this tool to edit a feature service, you must share branch versioned linear referencing system (LRS) data as a web layer. If the feature service is not yet published, see Share as web layers.

Add a point event

The example in the following workflow demonstrates adding a point event at measure 5 on Route 1 using the Route and Measure method in the Add Point Event tool .

Route 1 has measures from 0 to 20. The following diagram shows the route attributes:

Before adding a point event to a route using the Add Point Event tool

The following table provides details about the route attributes:

Route Name From Date To Date
Route1 1/1/2000 <Null>
Route ID From Date To Date
10100000123000001 1/1/2000 <Null>

To add a point event by route and measure, complete the following steps:

  1. Start ArcGIS Pro and open a project with LRS data in the map.

  2. Zoom to the location where you want to add a point event.

  3. On the Linear Referencing tab, in the Event Editing group, click Add Point .

    The Add Point Event pane appears with Route and Measure as the default method.

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

    Add Point Event pane

  4. Click Next.

    The Route and Measure and Dates sections appear in the Add Point Event pane.

    Add Point Event pane

    Add Point Event pane

  5. Click the Event Layer drop-down arrow and choose the point event layer to which you want to add an event.

    The Network parameter is automatically populated based on the specified event layer.

  6. Specify a route by doing one of the following:

    • Provide a route name in the Route Name text box.

    • Provide a route ID in the Route ID text box.

    • Click Choose route from map and click a route on the map.

    If multiple routes exist at the edit location, select one of the routes in the Select a Route dialog box.

    The Measure text box is initially populated using the route location where you clicked, and a green point appears on the map at that measure location.

    Tip:
    • After clicking Choose route from map or Choose measure from map , you can hover over the routes 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 in the Linear Referencing options.

    • When hovering near a feature, you can turn snapping on to improve the accuracy of the pointer.

    Note:

    If a message about acquiring locks appears, it means that conflict prevention is enabled. After you select a route, the tool attempts to release the route lock if the active user acquires the route lock in a different named version and the releasable status value is Yes.

  7. Optionally, specify a new measure location by doing one of the following:

    • Enter a value in the Measure text box.

    • Click Choose measure from map and click a location along the route on the map.

    The location of the green point on the map is updated.

  8. Optionally, change the start date by doing one of the following:

    • Provide the start date in the Start Date text box.

    • Click Calendar and choose the start date.

    • Check the Route start date check box.

    The default start date is the current date.

  9. Optionally, specify the end date for the point event by doing one of the following:

    • Provide the end date in the End Date text box.

    • Click Calendar , and choose the end date.

    • Check the Route end date check box.

    If you do not provide an end date, the event remains valid from the start date into the future.

  10. Click Next.

    The attributes for the point event layer appear under the Manage Attributes section.

    Manage Attributes section

    Manage Attributes section

  11. Optionally, provide attribute values for the event layer.

    Tip:

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

    Note:
    • After events are selected, event locks are acquired or transferred to the current user in the current named version.

    • Unlike route locks, there is no attempt to release event locks in any editing activity.

  12. Click Run.

    A confirmation message appears, and the new point event appears on the map.

The following table provides details about the point event in the example above:

Event Route Name From Date To Date Measure Location Error Inspection Date Anomaly Type Anomaly Status Priority Severity
Event1 Route1 1/1/2000 <Null> 5 No Error 1/1/2000 External Corrosion Scheduled Monitored Low
Event Route ID From Date To Date Measure Location Error Record_Status NBI Owner Date Attribute Effective BackStation
Event1 10100000123000001 1/1/2000 <Null> 5 No Error Active <Null> Govt 4/27/2022 <Null>

The following diagram shows the route and the associated event after the edit:

Route 1 with a point event added

Referent offset when using the Route and Measure method

The LRS events data model supports the configuration of event 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 a point event is created using the Route and Measure method in a referent-enabled layer, the parent LRS Network is used as the RefMethod value by default. The route ID is used as the RefLocation value, and the measure of the new point event is used as its RefOffset value.

If you update the measure of a point event, the RefOffset value updates to reflect the new measure value.

The examples below demonstrate the impact of adding a point event record to an event layer that has referent values enabled.

Before adding a point event with referents

The following diagram shows the route:

Before event creation with referents

The following table provides details about the route:

Route ID From Date To Date
Route1 1/1/2000 <Null>

After adding a point event with referents

In the following diagram, a point event that has referents has been added at measure 5:

After event creation with referents

The following table provides details about the event referent fields after event creation. The parent LRS Network is used as the RefMethod value, and the route is used as the RefLocation value:

Event ID RefMethod RefLocation RefOffset
Event1 EngineeringNetwork Route1 5
Event ID RefMethod RefLocation RefOffset
Event1 CountyLog Route1 5

The following table provides details about the other event fields after adding a point event at measure 5:

Event ID Route ID From Date To Date Measure
Event1 Route1 1/1/2000 <Null> 5

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