Available with Location Referencing license.
Characteristics of a route can be represented as a point event offset from an intersection, an LRS point event, or a non-LRS point feature.
In the example below, a point event's measure is established using the location offset method. The route has start and end measure values of 0 and 10 miles, respectively. Event1 is located 2 miles from the intersection on the left and 8 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 positive direction and the offset distance in the second case is shown as a negative number.
Add a point event by location offset
To add a point event by location offset, complete the following steps:
- Open the map in ArcGIS Pro and zoom to the location where you want to add the point event.
- On the Location Referencing tab, in the Events group, click Add > Point Event
.The Add Point Event pane appears with a Route and Measure value for Method as the default.
- Click the Method drop-down arrow and choose Location Offset.
- Click Next.
The Event Layer drop-down menu, the Network drop-down menu, the Location Offset section, and the Dates section appear in the pane.
- Click the Event Layer drop-down arrow and choose the event layer where the event will be created.
The Network value is populated based on the Event Layer value.
- Specify the route name by doing one of the following:
- Type the route name in the Route Name text box.
- Click Choose route from map and click a route on the map.
- Click the Point Layer drop-down arrow and choose the intersection, LRS point event, or non-LRS point layer name.
Note:
All the point layers that are published with the feature service are listed. LRS point events from a network other than the one specified under Network will not be listed. The LRS calibration point layer is not supported. - For the text box below the Point Layer drop-down menu, specify the point feature's name by doing one of the following:
- Type the name of the point feature in text box.
- Click Choose location from the map
and click a point feature on the map to populate the text box.
Note:
- The name of the text box below the Point Layer drop-down list is based on the point layer's display field. If a custom display field is set or the set display field does not have a value, the feature cannot be selected.
- If more than one point feature exists at the clicked location, the Select Feature dialog box appears.
- Provide the Offset value for the location by doing one of the following:
- Click the Offset drop-down arrow to choose the offset direction, provide a measure value, and choose the units.
- Provide 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 measure value for the event.
Note:
- The offset value is the distance between the chosen point layer and the proposed measure on the selected route.
- The direction is an optional selection.
- If no direction is selected, a positive offset value places the measure location along the direction of calibration from the selected point feature.
- If no direction is selected, a negative offset value places the measure location opposite the direction of calibration from the selected point feature.
- Specify the date that defines the start date of the event 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 to use the route start date.
The start date default value is the current date, but you can choose a different date.
- Specify the date that defines the end date of the event by doing one of the following:
- Provide the end date in the End Date text box.
- Click the Calendar and choose the end date.
- Check the Route end date check box.
The end date is optional. If no end date is provided, the events remain valid from the event start date and into the future.
- Click Next.
Attributes for the chosen event layer appear under Manage Attributes.
- Provide attribute information 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. - Click Run.
A confirmation message appears once the newly added point event is created. The new point is created and appears on the map.
Add multiple point events by location offset
To add multiple point events by location offset, complete the following steps:
- Open the map in ArcGIS Pro and zoom to the location where you want to add the point events.
- On the Location Referencing tab, in the Events group, click Add > Multiple Point Events
.The Add Multiple Point Events pane appears with a Route and Measure value for Method as the default.
- Click the Method drop-down arrow and choose Location Offset.
- Click Next.
The Network drop-down menu, the Location Offset section, and the Dates section appear in the pane.
- Click the Network drop-down arrow and choose an LRS Network.
- Specify the route name by doing one of the following:
- Provide the route name in the Route Name text box.
- Click Choose route from map and click a route on the map.
- Click the Point Layer drop-down arrow and choose the intersection, LRS point event, or non-LRS point event layer name.
Note:
All the point layers that are published with feature service are listed. LRS point events from a network other than the one specified under Network are not listed. The LRS calibration point layer is not supported.
- For the text box below the Point Layer drop-down menu, specify the point feature's name by doing one of the following:
- Provide the name of the point feature in the text box.
- Click Choose location from map and click a point feature on the map to populate the text box.
Note:
- The name of the text box below the Point Layer drop-down menu is dependent on the point layer's display field. If a custom display field is set or the display field set does not have a value, the feature cannot be selected.
- If more than one point feature exists at the clicked location, the Select Feature dialog box appears.
- Specify the Offset direction for the location by doing one of the following:
- Click the Offset drop-down arrow, choose the offset direction, provide the measure value, and choose the units.
- Provide 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 measure value for the event.
Note:
- The offset value is the distance between the chosen point layer and the proposed measure on the selected route.
- The direction is an optional selection.
- If no direction is selected, a positive offset value places the measure location along the direction of calibration from the selected point feature.
- If no direction is selected, a negative offset value places the measure location opposite the direction of calibration from the selected point feature.
- Specify the date that defines the start date of the events 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 to use the route start date.
Note:
The start date default value is today's date, but you can choose a different date.
- Specify the date that defines the end date of the events 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.
The end date is optional. If no end date is provided, the event remains valid from the event start date and into the future.
- Click Next.
The Manage Attributes section appears.
The Attribute Set drop-down menu includes other attribute sets if configured for the LRS Network.
- Optionally, choose an attribute from the Attribute Set drop-down menu.
Note:
You can uncheck the check box next to individual event layers to exclude them from event creation. - Provide attribute information for the events in the attribute set.
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. - Click Run.
A confirmation message appears once the new point events are created and appear on the map.
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 point events are created using the location offset method in a referent-enabled layer, the point layer's name is used as the RefMethod value. The RefLocation value is IntersectionID if the point layer used is an intersection; otherwise, the value is ObjectID.
Note:
If you want to offset an event from a point feature class that is not part of the LRS (but present in the feature service) and you want to capture the non-LRS point feature used in the Referent fields, you must manually add that feature class's code and description (name) into the dReferentMethod domain.
Learn more about the properties of manually added referent and offset fields in an event layer
The examples below demonstrate the impact of adding point events to a layer that has referent fields enabled.
Before adding a point event with referents
In the following diagram, Route1 has measures from 0 to 10 and no associated event:
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 6:
The following table provides details about the referent-enabled fields after event creation:
| RefMethod | RefLocation | RefOffset |
|---|---|---|
IntersectionLayer | Intersection1 | 3 |
The following table provides details about the default event attributes after event creation:
| Event ID | Route ID | From Date | To Date | Measure |
|---|---|---|---|---|
Event1 | Route1 | 1/1/2000 | <Null> | 6 |
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.
Before adding multiple point events with referents
The following diagram shows Route1 before events are created:
The following table provides details about the route:
| Route ID | From Date | To Date |
|---|---|---|
Route1 | 1/1/2000 | <Null> |
After adding multiple point events with referents
The following diagram shows multiple point events that have been added to point event layers that have referents enabled:
The following table provides details about the event referent fields after event creation:
| RefMethod | RefLocation | RefOffset |
|---|---|---|
InspectionNote | 152 | 3 |
The following tables provides details about the default event fields after event creation:
Anomaly
| Event ID | From Date | To Date | Route ID | Measure |
|---|---|---|---|---|
Event1 | 1/1/2000 | <Null> | Route1 | 6 |
DocumentPoint
| Event ID | From Date | To Date | Route ID | Measure |
|---|---|---|---|---|
Event1 | 1/1/2000 | <Null> | Route1 | 6 |
Elevation
| Event ID | From Date | To Date | Route ID | Measure |
|---|---|---|---|---|
Event1 | 1/1/2000 | <Null> | Route1 | 6 |
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.