Available with Location Referencing license.
Characteristics of a route can be represented as a line event offset from an intersection, an LRS point event, or a non-LRS point feature. 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, point events, or non-LRS point features are in the active map.
Location offset scenarios
In the examples below, the start measure and end 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 start measure is located 2 miles from the intersection on the left and the end 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 end 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 start measure of 2 on Route1 and an end measure of 37 on Route3. Because the start measure is upstream of the intersection, the offset distance is -3 miles, and the offset distance of the end measure is 2 miles. In this case, the first offset refers to the intersection of Route1 and Route11, and the second offset refers to the intersection of Route3 and Route13.
Add a line event by location offset
To create a single line event using location offset with the Add Line Event tool, complete the following steps:
- Open the map in ArcGIS Pro and zoom to the location where you want to add the line event.
- 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.
- Click the From Method drop-down arrow and choose Location Offset.
- 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.
- Click Next.
The Event Layer drop-down menu, the Network drop-down menu, the Location Offset sections, and the Dates section appear in the Add Line Event pane.
- 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.
- In the From: Location Offset section, specify the route by doing one of the following:
- Provide the route ID in the Route ID text box.
- Click Choose route from map
and click the route on the map.
- Click the Point Layer drop-down arrow and choose an 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:
- Provide the point feature's name in the text box.
- Click the Choose location from map tool
and click a point feature on the map.
Note:
- The name of the text box below the Point Layer drop-down menu is based on the point layer's display field. For intersections, the name of the text box will always be IntersectionName.
- If more than one point feature exists at the clicked location, the Select Feature dialog box appears.
- Specify the Offset value for the location by doing one of the following:
- Click the Offset drop-down arrow and 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 start measure value for the event.
Note:
- The offset value is the distance between the chosen point layer and the proposed start measure on the selected route.
- The direction is an optional selection.
- If no direction is selected, a positive offset value places the start measure location along the direction of calibration from the selected point feature.
- If no direction is selected, a negative offset value places the start measure location opposite the direction of calibration from the selected point feature.
- In the To: Location Offset section, specify the route by doing one of following:
- Provide the route ID in the Route ID text box.
- Click Choose route from map and click the 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:
- Provide the point feature's name in the text box.
- Click the Choose location from map tool and click a point feature on the map.
Note:
- The name of the text box below the Point Layer drop-down menu is based on the point layer's display field. For intersections, the name of the text box will always be IntersectionName.
- If more than one point feature exists at the clicked location, the Select Feature dialog box appears.
- Specify the Offset value for the referent offset by doing one of the following:
- Click the Offset drop-down arrow and choose the offset direction, provide a measure, and choose the units.
- Provide 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 end measure value for the events.
Note:
- The offset value is the distance between the chosen point layer and the proposed end measure on the selected route.
- The direction is an optional selection.
- If no direction is selected, a positive offset value places the end measure location along the direction of calibration from the selected point feature.
- If no direction is selected, a negative offset value places the end 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 cannot be before the start date of the selected route.
The start date default value is today's date, but you can specify 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 to use the route end date.
If no end date is provided, the events remain valid from the event start date and into the future.
- 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.
Learn more about the Retire overlaps option
- 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.
Learn more about the Merge coincident events option
- 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.
- Click Next.
Attributes for the chosen event layer appear under Manage Attributes.
Note:
Check the Go to next measure upon run check box to start your next edit at the end measure location of the previous edit. The To Method value and its populated information from the previous edit carry over to the next edit as the From Method value and its populated information.
For example, if you use a From Method value of Location Offset and a To Method value of Coordinates to add a line event, enabling this option will start your next edit with From Method and To Method values of Coordinates with the coordinates information from the previous edit in the From: Coordinates section.
- Provide attribute information for the new event using the Manage Attributes section.
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.
- 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
To create line events using location offset with the Add Multiple Line Events tool, complete the following steps:
- Open the map in ArcGIS Pro and zoom to the location where you want to add the line events.
- 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 for From Method and To Method.
- Click the From Method drop-down arrow and choose Location Offset.
- Click the To Method drop-down arrow and choose Location Offset.
- Click Next.
The Network and Location Offset sections appear in the Add Multiple Line Events pane.
- Click the Network drop-down arrow and choose the parent LRS Network of the line event layer.
- In the From: Location Offset section, specify the route by doing one of the following:
- Provide the route ID in the Route ID text box.
- Click Choose route from map and click the 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:
- Provide the point feature's name in the text box.
- Click the Choose location from map tool and click a point feature on the map.
Note:
- The name of the text box below the Point Layer drop-down menu is based on the point layer's display field. For intersections, the name of the text box will always be IntersectionName.
- If more than one point feature exists at the clicked location, the Select Feature dialog box appears.
- Specify the Offset value for the location by doing one of the following:
- Click the Offset drop-down arrow and 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 start measure value for the event.
Note:
- The offset value is the distance between the chosen point layer and the proposed start measure on the selected route.
- The direction is an optional selection.
- If no direction is selected, a positive offset value places the start measure location along the direction of calibration from the selected point feature.
- If no direction is selected, a negative offset value places the start measure location opposite the direction of calibration from the selected point feature.
- In the To: Location Offset section, specify the route by doing either of the following:
- Provide the route ID in the Route ID text box.
- Click Choose route from map and click 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.
- 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:
- Provide the point feature's name in the text box.
- Click the Choose location from map tool and click a point feature on the map.
Note:
- The name of the text box below the Point Layer drop-down menu is based on the point layer's display field. For intersections, the name of the text box will always be IntersectionName.
- If more than one point feature exists at the clicked location, the Select Feature dialog box appears.
- Specify the Offset value for the referent offset by doing one of the following:
- Click the Offset drop-down arrow and choose the offset direction, provide a measure, and choose the units.
- Provide 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 end measure value for the events.
Note:
- The offset value is the distance between the chosen point layer and the proposed end measure on the selected route.
- The direction is an optional selection.
- If no direction is selected, a positive offset value places the end measure location along the direction of calibration from the selected point feature.
- If no direction is selected, a negative offset value places the end 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 of the events.
Note:
The start date cannot be before the start date of the selected route.
The start date default value is today's date, but you can specify 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 to use the route end date of the event.
The end date is optional. If no end date is provided, the event remains valid from the event start date and into the future.
- 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 are created.
Learn more about the Retire overlaps option
- 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.
Learn more about the Merge coincident events option
- 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.
- 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.
Note:
Enable the Go to next measure upon run option to start your next edit at the end measure location of the previous edit. The end method and its populated information from the previous edit will carry over into the next edit as the start method and its populated information.
For example, if you use a From Method value of Location Offset and a To Method value of Coordinates to add a line event, enabling this option will start your next edit with From Method and To Method values of Coordinates with the coordinates information from the previous edit in the From: Coordinates section.
- Provide attribute information for the events in the Manage Attributes section.
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. - 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 Roads and Highways 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 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 Object ID.
If either measure of a line event is updated, the corresponding offset value updates to reflect the new measure.
Note:
To offset an event from a point feature class that is not part of the LRS (but is 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) to the dReferentMethod domain.
Learn more about the properties of manually added referent and offset fields in an event layer
The examples in the subsections 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 route before event creation:
The following table provides details about the route:
| Route ID | From Date | To Date |
|---|---|---|
Route1 | 1/1/2000 | <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 | -3 | IntersectionLayer | Intersection1 | 17 |
The following table provides details about the default event fields after event creation:
| Event ID | From Date | To Date | From Measure | To Measure |
|---|---|---|---|---|
Event1 | 1/1/2000 | <Null> | 0 | 20 |
You can edit the event using the attribute table so that it uses referents other than the default values. If subsequent route edits occur, the RefMethod and RefLocation values revert to the parent LRS Network and the route, respectively.
Before adding multiple line events with referents
The following diagram shows the route before event creation:
The following table provides details about the route:
| Route ID | From Date | To Date |
|---|---|---|
Route1 | 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 | FromRefOffset | ToRefLocation | ToRefLocation | To RefOffset |
|---|---|---|---|---|---|
Attenuator | 483 | -3 | Attenuator | 483 | 17 |
The following tables provide details about the default event fields after event creation:
Counter Peak Lanes
| Event ID | From Date | To Date | From Measure | To Measure | Counter Peak Lanes |
|---|---|---|---|---|---|
Event1 | 1/1/2000 | <Null> | 0 | 20 | 3 |
Cracking Percent
| Event ID | From Date | To Date | From Measure | To Measure | Cracking Percent |
|---|---|---|---|---|---|
Event1 | 1/1/2000 | <Null> | 0 | 20 | 12 |
Directional Factor
| Event ID | From Date | To Date | From Measure | To Measure | Directional Factor |
|---|---|---|---|---|---|
Event1 | 1/1/2000 | <Null> | 0 | 20 | 100 |
You can edit the event using the attribute table so that it uses referents other than the default values. If subsequent route edits occur, the RefMethod and RefLocation values revert to the parent LRS Network and the route, respectively.
Retire overlaps scenarios
When the Retire overlaps check box is checked, 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.
Merge coincident events scenarios
When the Merge coincident events check box is checked, the new event is merged with the existing event, and the measure range is expanded accordingly. The following conditions must be met:
- All attribute values of the new event are exactly the same as the existing event.
- The new event is adjacent to or overlapping an existing event in terms of its measure values.
- The new and existing events' time slices are coincident or overlapping.