Available with Location Referencing license.
Characteristics of a route pipeline, such as DOT Cass or Test Pressure Range, can be represented as a line event by providing x-, y-, or, optionally, z-coordinate locations as the basis for measure location. The coordinate data is stored as routes and measures.
The coordinates method appears as an optional method in the Add Line Event and Add Multiple Line Events tools. To add line events, choose the coordinates method and provide the x-, y-, and optionally, z-coordinates.
Add a line event by coordinates
To create a single line event by coordinates using 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 with the default Route and Measure value for From Method and To Method.
- Click the From Method drop-down arrow and choose Coordinates.
- Click the To Method drop-down arrow and choose Coordinates.
Using the Coordinates method, the measure location is based on geographic coordinates.
Tip:
You can use a combination of any of the methods to locate the start measure and end measure values. For example, you can use Route and Measure for the start measure value, and use Coordinates to define the end location on the map.
The methods you choose appear in the from and to section labels. For example, From: Route and Measure and To: Coordinates appear if the start method is Route and Measure and the end method is Coordinates.
- Click Next.
The Event Layer and Network options and the From: Coordinates and To: Coordinates sections appear in the Add Line Event pane.
- Click the Event Layer drop-down arrow and choose the event layer where the events will be added.
The parent LRS Network is populated based on the Event Layer value.
- If the parent LRS Network is a line network, specify the name of the line feature by doing one of the following:
- Provide a line name in the Line Name text box.
- Click Choose line from map
, and select the line on the map.
The line is highlighted in light blue.
- Specify the route in the From: Coordinates section by doing one of the following:
- Provide the route name in the Route Name text box.
- Click the Route Name drop-down arrow, and choose the route.
- Click Choose route from map and click the route on the map.
The specified route is highlighted in light blue.
Note:
If a message appears that is related to acquiring locks, the need to reconcile, or not being able to acquire locks, Pipeline Referencing conflict prevention is enabled.
- Optionally, in the From: Coordinates section, provide a geographic coordinate factor value in the GC Factor text box.
- In the From: Coordinates section, click the Spatial Reference drop-down arrow and choose a spatial reference:
- LRS Spatial Reference—The spatial reference of the LRS network
- Web Map Spatial Reference—The spatial reference of the basemap
- GCS_WGS_1984—A geographic spatial reference using degree decimals as units
Note:
Choosing GCS_WGS_1984 provides Longitude, Latitude, and Height options rather than X, Y, and Z options.
- In the From: Coordinates section, provide coordinate values for X, Y, and optionally, Z, for the start location.
A green square is placed at the specified coordinate on the map for the start location.
A green dot appears on the route at the location nearest to the green square. This is the location of the start measure value of the event.
Tip:
Click Choose measure from map
and click the location on the map.The route measure closest to the original coordinates is selected, and its distance from the route is displayed.
- Specify the route in the To: Coordinates section by doing one of the following:
- Click the Route Name drop-down arrow, and choose the route.
- Provide the route name in the Route Name text box.
- Click Choose route from map and click the route on the map.
- In the To: Coordinates section, provide coordinate values for X, Y, and optionally, Z, for the end location.
A red square is placed at the specified coordinate on the map for the end location.
A red dot appears at the measure on the route to which the coordinate values correspond. This is the location of the end measure value for the event.
Tip:
Click Choose measure from map
and click the location on the map.The route measure closest to the original coordinates is selected, and its distance from the route is displayed.
- Optionally, 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.
- Choose a data validation option to prevent erroneous input while characterizing a route with line events as follows:
- 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 retiring overlaps
- 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 merging coincident 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.
- Click Next.
The attributes for the chosen event layer appear under the Manage Attributes section.
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.
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.
A confirmation message appears when the line event is added and appears on the map.
Add multiple line events by coordinates
To create multiple line events using coordinates 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 Coordinates.
- Click the To Method drop-down arrow and choose Coordinates.
Tip:
You can use a combination of any of the methods to locate the start measure and end measure values. For example, you can use Route and Measure to choose the start measure value, and use Coordinates to define the end location on the map.
The methods you choose appear in the from and to section labels. For example, From: Route and Measure and To: Coordinates appear if the chosen start method is Route and Measure and the chosen end method is Coordinates.
- Click Next.
The Network drop-down menu, and the From: Coordinates and To: Coordinates sections appear in the pane.
- Click the Network drop-down arrow and choose a network.
- If the chosen LRS Network is a line network, specify the name of the line feature by doing one of the following:
- Provide a line name in the Line Name text box.
- Click Choose line from map , and click a line on the map.
The line is highlighted in light blue.
- Specify the route in the From: Coordinates section by doing one of the following:
- Click the Route Name drop-down arrow, and choose the route.
- Provide the route name in the Route Name text box.
- Click Choose route from map and click the route on the map.
The line is highlighted in light blue.
Note:
If a message appears that is related to acquiring locks, the need to reconcile, or not being able to acquire locks, conflict prevention is enabled.
- Optionally, in the From: Coordinates section, provide a geographic coordinate factor value in the GC Factor text box.
- In the From: Coordinates section, choose a spatial reference from the Spatial Reference drop-down menu as follows:
- LRS Spatial Reference—The spatial reference of the LRS network
- Web Map Spatial Reference—The spatial reference of the basemap
- GCS_WGS_1984—A geographic spatial reference using degree decimals as units
- In the From: Coordinates section, provide coordinate values for X, Y, and, optionally, Z, for the starting location.
A green square is placed at the specified coordinate on the map for the starting location.
A green dot appears on the route at the location nearest to the green square. This is the location of the start measure value of the event.
Tip:
Click Choose measure from map
, and click the location on the route.The route measure closest to the original coordinates is selected and its distance from the route is displayed.
- Specify the route in the To: Coordinates section by doing one of the following:
- Click the Route Name drop-down arrow, and choose the route.
- provide the route name in the Route Name text box.
- Click Choose route from map and click the route on the map.
- In the To: Coordinates section, provide coordinate values for X, Y, and, optionally, Z, for the ending location.
A red square is placed at the specified coordinate on the map for the ending location.
A red dot appears at the measure on the route to which the coordinate values correspond. This is the location of the end measure value for the event.
Tip:
Click Choose measure from map
, and click the location on the route.The route measure closest to the original coordinates is selected and its distance from the route is displayed.
- 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.
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.
- Optionally, 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.
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 line events as follows:
- 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 have been created.
Learn more about retiring overlaps
- 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 merging coincident 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 have been created.
- Click Next.
The Manage Attributes section appears with the default attribute set in the Attribute Set drop-down list.
The Attribute Set drop-down menu includes other attribute sets if configured.
You can configure attribute sets for yourself and for others in the same feature service.
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.
- Optionally, click the Attribute Set drop-down arrow, and choose an attribute set.
- Provide attribute information for the new events.
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.
A confirmation message appears when the line events are added and appear on the map.
Referent offset when using the coordinates 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 line events are created using the coordinates method in a referent-enabled layer, X/Y is used as the FromRefMethod and ToRefMethod values, geographic coordinates are used as the FromRefLocation and ToRefLocation values, and the FromRefOffset and ToRefOffset fields are populated with 0.
If either measure of a line event is updated, the corresponding offset value updates to reflect the new measure.
The examples below demonstrate the impact of adding line event records that have referent values enabled.
Before adding a line event with referents
The following diagram shows the routes before event creation:
The following table provides details about the routes:
| Route ID | From Measure | To Measure | From Date | To Date |
|---|---|---|---|---|
R1 | 0 | 5 | 1/1/2000 | <Null> |
R2 | 7 | 12 | 1/1/2000 | <Null> |
R3 | 13 | 18 | 1/1/2000 | <Null> |
After adding a line event with referents
The following diagram shows Event1 after event creation:
The following table provides details about the event referent fields in Event1 after event creation:
| FromRefMethod | FromRefLocation | FromRefOffset | ToRefMethod | ToRefLocation | ToRefOffset |
|---|---|---|---|---|---|
X/Y | 33.984980, -117.306397, 20 | 0 | X/Y | 33.965456, -117.265669, 20 | 0 |
The following table provides details about the default event fields after event creation:
| Event ID | FromRouteID | ToRouteID | From Date | To Date | From Measure | To Measure |
|---|---|---|---|---|---|---|
Event1 | R1 | R3 | 1/1/2000 | <Null> | 1.25 | 16.75 |
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 line events with referents
When events are created using the coordinates method in a referent-enabled layer, X/Y is used as the FromRefMethod and ToRefMethod values, the geographic coordinates are used as the FromRefLocation and ToRefLocation values, and the FromRefOffset and ToRefOffset fields are populated with 0.
The following diagram shows Route1 before line event creation:
The following table provides details about the routes:
| Route ID | From Measure | To Measure | From Date | To Date |
|---|---|---|---|---|
R1 | 0 | 5 | 1/1/2000 | <Null> |
R2 | 7 | 12 | 1/1/2000 | <Null> |
R3 | 13 | 18 | 1/1/2000 | <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 Event1 event referent fields after event creation:
| FromRefMethod | FromRefLocation | FromRefOffset | ToRefMethod | ToRefLocation | ToRefOffset |
|---|---|---|---|---|---|
X/Y | 34.071192, -117.191739, 20 | 0 | X/Y | 33.998575, -117.342102, 20 | 0 |
The following tables provide details about the default event fields after event creation:
Consequence Segment
| Event ID | FromRouteID | ToRouteID | From Date | To Date | From Measure | To Measure |
|---|---|---|---|---|---|---|
Event1 | R1 | R3 | 1/1/2000 | <Null> | 1.25 | 16.75 |
DOT Class
| Event ID | FromRouteID | ToRouteID | From Date | To Date | From Measure | To Measure |
|---|---|---|---|---|---|---|
Event1 | R1 | R3 | 1/1/2000 | <Null> | 1.25 | 16.75 |
Excavation Damage
| Event ID | FromRouteID | ToRouteID | From Date | To Date | From Measure | To Measure |
|---|---|---|---|---|---|---|
Event1 | R1 | R3 | 1/1/2000 | <Null> | 1.25 | 16.75 |
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.
Retire overlaps scenario
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 scenario
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.