Add a point event by route and measure

Available with Location Referencing license.

Characteristics of a route can be represented as point events with measure information along the route. Use the Add Point Event tool to create single point events in ArcGIS Pro.

The example in the following workflow demonstrates adding a point event at measure 5 on Route1 using the Add Point Event tool .

The following diagram shows the route attributes. The route (Route1) has measures from 0 to 20.

The following table provides details about the route attributes:

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

Add a point event

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

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

   The Add Point Event pane appears.

   

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

3. Click Next.

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

   

4. Click the Event Layer drop-down arrow and choose the point event layer where you want to add the event.

   The selected Network value is based on the selected event layer.

5. Specify a route by doing one of the following:
   • Provide a route name in the Route Name text box.
   • Click Choose route from map and click the point on the route where you want to add the point event.

   The measure is initially populated using the route location where you clicked.

   You can choose a new measure using Choose measure from map .

   Tip:

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

   Learn more about setting map scale options for display of route and measure information

   Note:

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

   After a route is selected, the tool will attempt to release the route lock if the route lock is acquired by the current user in a different version and its releasable status is yes.

6. Specify a new location by doing one of the following:
   • Provide the value in the Measure text box.
   • Click Choose measure from map and click the measure value along the route on the map.

   Once the measure is provided, a green dot appears on the map at that measure location.

7. The start date default value is the current date, but you can change the 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.
8. 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 no end date is provided, the events remain valid from the event start date into the future.

9. Click Next.

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

   

10. Provide attribute values for the event layer.

    Note:

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

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

11. Click Run.

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

The following table provides details about the point event:

Event	Route ID	From Date	To Date	Measure	Location Error	Subtype	MAOP Unit of Measure	System Type
Event1	Route1	1/1/2000	<Null>	5	No Error	InjectionPoint	Pounds/Square Inch	Distribution

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

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 point event is created using route and measure 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 the measure of a point event is updated, the RefOffset value updates to reflect the 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:

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:

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

Event ID	RefMethod	RefLocation	RefOffset
Event1	PipeSeriesNetwork	Route1	5

The following table provides details about the event record after adding a point event at measure 5. The parent LRS Network is used as the RefMethod value, and the route is used as the RefLocation value:

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.