Available with Location Referencing license.
During the lifespan of a pipeline, route geometry and length may change. Portions of routes are removed while others are added. Major changes, such as environmental concerns, building a new pumping station, or repair work, may require a change in the shape of the route's geometry and length. ArcGIS Location Referencing uses centerlines to do realignment.
The Realign Route tool can be used to realign a single route or to realign several adjoining routes that are part of the same line.
Centerline features used to realign routes can be existing features in the centerline feature class, be digitized into the centerline feature class (using aerial photography or other basemaps for guidance), be copied and pasted from other feature classes, or be imported from CAD files or other ArcGIS-supported data sources.
The following tables list parameters used in the Realign Route tool.
Parameters used for Engineering Stationing networks
Parameter | Description |
---|---|
Network | The network in which the Engineering Stationing routes exist. |
Effective Date | The date when the realignment has taken place on the ground. |
Source Route: From Route Name | The route where the realignment starts. |
Source Route: From measure | The measure on the source route where the realignment starts; shown by the green dot. |
Source Route: To Route Name | The route where the realignment ends. In the case where the realignment takes place on a single route, the source route and target route are the same. |
Source Route: To measure | The measure on the target route where the realignment ends; shown by the red dot. |
Realigned Route: From measure | The starting measure on the realigned portion. |
Realigned Route: To measure | The ending measure on the realigned portion. |
Realigned Route: Abandon the route(s) | Choose whether to abandon the source routes or to retire them. |
Realigned Route: Recalibrate route downstream | Choose whether the tool recalibrates the route downstream of the realignment measures. |
Parameters used for Continuous Measure networks
Parameter | Description |
---|---|
Network | The network in which the continuous routes exist. |
Effective Date | The date when the realignment has taken place on the ground. |
Source Route: Route Name | The route where the realignment takes place. |
Source Route: From measure | The measure on the source route where the realignment starts; shown by the green dot. |
Source Route: To measure | The measure on the source route where the realignment ends; shown by the red dot. |
Realigned Route: From measure | The starting measure on the realigned portion. |
Realigned Route: To measure | The ending measure on the realigned portion. |
Route realignment scenarios
In the following examples, RouteX has a start measure of 0 and an end measure of 10 before realignment. The line order is 100.
In this example, the source measure and target measure of the realigned portion of the route are the measures suggested by Pipeline Referencing.
Before realignment, the RouteX edit region has a start measure of 2 and an end measure of 6.
Example 1: Source | |
---|---|
From Route | RouteX |
From Measure | 2 |
To Route | RouteX |
To Measure | 6 |
Recalibrate | Yes |
After realignment, RouteX is realigned with updated downstream measures due to recalibration. The line order remains 100.
Example 1: Realigned | |
---|---|
From Measure | 2 |
To Measure | 10 |
Recalibrate | Yes |
In the second example, there is no downstream recalibration after the realigned portion of the route. This will result in an equation at the to measure of the realigned route.
Example 2: Source | |
---|---|
From Route | RouteX |
From Measure | 2 |
To Route | RouteX |
To Measure | 6 |
Recalibrate | No |
After realignment, a new route (RouteA) is created from the start of the source route to the end of the realignment section, which is the to measure location of the realigned route. RouteA gets the line order of 100 and RouteX’s line order changes to 200.
Example 2: Realigned | |
---|---|
From Measure | 2 |
To Measure | 10 |
New Route | RouteA |
Recalibrate | No |
Alternatively, if the to measure of the realigned route is changed before the tool is run, an equation occurs at the from and to measure locations, and two new routes are created.
Note:
An equation can occur if you don't use Pipeline Referencing suggested measures.
Example 3: Source | |
---|---|
From Route | RouteX |
From Measure | 2 |
To Route | RouteX |
To Measure | 6 |
Recalibrate | Yes |
After realignment, the first new route (RouteA) starts and ends at the to and from of the realign portion. The second new route (RouteB) starts from the end of the realign portion and goes until the end of the original route. RouteX’s line order remains 100, RouteA gets a line order of 200, and RouteB gets a line order of 300.
Similarly, if the from measure and to measure of the realigned route are changed so that it results in an equation at the from and to measure locations, and recalibrating downstream is chosen, then two new routes are created. The first new route (RouteA) starts and ends at the start and end of the realign portion. The second new route (RouteB) starts from the end of the realign portion and goes until the end of the original route.
Example 3: Realigned | |
---|---|
From Measure | 3 |
To Measure | 10 |
New Route | RouteA |
New Route | RouteB |
Recalibrate | No |
In the fourth case, if the from measure of the realigned route is changed in such a way that it results in an equation (by not using Pipeline Referencing suggested measures) and recalibrating downstream is chosen, then a new route is created.
Example 4: Source | |
---|---|
From Route | RouteX |
From Measure | 2 |
To Route | RouteX |
To Measure | 6 |
The new route (RouteA) starts at the start of the realign portion and goes until the end of the original route. RouteX’s line order remains 100 and RouteA gets a line order of 200.
Example 4: Realigned | |
---|---|
From Measure | 3 |
To Measure | 12 |
New Route | RouteA |
Recalibrate | Yes |
Reassigning to an abandoned route
The default option in Pipeline Referencing is to reassign any realigned routes to abandoned routes, rather than retire them. The workflow described previously is still applicable regarding the realignment. However, instead of retiring the existing routes as of the effective date of the edit, abandoned routes (new routes in the network) are created to represent assets that are still present, but not in use.
Leave the Reassign to abandoned route(s) check box checked to show the names of any abandoned routes that will be created, as well as the line to which they belong.
You may also enter any required attributes for the abandoned route or routes at this time, or check the Apply values to all routes check box to type the same values for all abandoned routes.
The following diagrams show before and after reassignment to abandoned routes that have the _Ab suffix.
Note:
If a message about acquiring locks or reconciling appears, conflict prevention is enabled.
Complex route realignment scenarios
The following sections provide examples of realignment in complex routes, including loop, lollipop, gapped, branch, and infinity routes.
Realignment on a loop route
In the following example, a route (RouteX) has a start measure of 0 and an end measure of 12 before realignment. The route is realigned from measure 0 to measure 4, which is from the beginning to the middle of the route.
Without downstream recalibration, an equation point is created at measure 4 of RouteX. This results in the creation of a new route (RouteA) with a from measure of 0 and a to measure of 9.5.
RouteA is assigned line order 100 and the RouteX line order changes to 200.
Realignment on a lollipop route
In the following example, a route (RouteX) has a start measure of 0 and an end measure of 15 before realignment. The route is realigned from measure 8 to measure 15.
As realignment is from the middle to the end, downstream recalibration does not apply. RouteX is realigned with a start measure of 0 and an end measure of 17. The realigned section is assigned measures 8 to 17.
Line order remains unchanged.
Realignment on a gapped route
In the following example, a gapped route (RouteX) has a start measure of 0 and an end measure of 4 before realignment. The route is realigned from measure 1 to measure 3.
Without downstream recalibration, an equation point is created at measure 3 on RouteX. This results in the creation of a new route (RouteA) from measure 0 to measure 11.
As a result, RouteA is assigned line order 100 and the RouteX line order changes to 200.
Realignment on an infinity route
In the following example, a route (RouteX) has a start measure of 0 and an end measure of 24 before realignment. The route is realigned from measure 7 to measure 11. In this realignment, the suggested from measure is not used. The from measure 10 for the realignment section is the user input value and the to measure 16 is calculated using the geometrical length of the centerline.
As the suggested measure is not used, an equation point is created at measure 7 of RouteX resulting in a new route (RouteA). Without downstream recalibration, another equation point is created at measure 16 of RouteA. This results in the creation of another new route (RouteB) with a from measure of 11 and a to measure of 24.
The RouteX line order remains 100, while RouteA and RouteB get a line order of 200 and 300, respectively.
Realignment on a branch route
In the following example, a route (RouteX) has a start measure of 0 and an end measure of 9 before realignment. The route is realigned in the middle.
Without downstream recalibration, an equation point is created at measure 3 of RouteX. This results in the creation of a new route (RouteA) with a from measure of 0 and a to measure of 6.
RouteA is assigned the line order 100, while the RouteX line order changes to 200.
Use the following steps for realigning routes:
Note:
Gap calibration rules are followed when editing routes.
- Add the
centerline and network feature class to a map.
You can also open a map in which the centerline and network feature class are already present.
Note:
The information model expects only one centerline at any given location. Make sure that the centerlines used for your edit do not overlap other centerlines in your LRS.
Note:
Traditionally versioned networks must be edited through a direct connection to the geodatabase. Branch-versioned networks, including any network configured with a user-generated route ID, must be edited through a feature service.
- Zoom in to the location where you want to realign the route.
Note:
The centerline feature for realigning the route must exist in the centerline feature class prior to realigning the route.
- On the Location Referencing tab, in the Routes group, click Realign .
The Realign Route pane appears with the Select By Rectangle option selected by default.
- Use your mouse to select one or more centerlines by rectangle at the location of the new route.
You can also click the Select one or more centerlines drop-down arrow to choose one of the remaining selection tools: Select By Polygon , Select By Lasso , Select By Circle , Select By Line , or Select By Trace .
Alternatively, you can use the interactive selection tools on the Map tab on the ArcGIS Pro ribbon:
The selected centerlines are highlighted on the map and the Allow choosing of one or more centerlines button appears in the Realign Route pane. The Selected Centerlines count is shown above the table.
Note:
- The direction of digitization of the centerline, depicted by the direction of the arrowhead on the selected centerline, also determines the direction of increasing measure calibration. You can reverse direction for the chosen centerlines using the Flip the direction of the centerlines button .
- You can keep the centerlines chosen after realigning the route. This option is particularly useful if you are realigning a route in the Engineering Stationing network and want to realign another route for the Continuous network using the same centerlines, or vice versa.
- Click the Allow choosing of one or more centerlines button .
A table appears in the Realign Route pane with each chosen centerline in a numbered row that corresponds to the selection order. Chosen centerlines are numbered on the map and highlighted. The Chosen Centerlines count is shown below the table.
- Optionally, change the centerline selection order table by choosing one or more table rows and using the buttons below the table to reorder the selection. You can also drag rows into the desired order.
Changes in the table selection order are also shown on the map.
Tools available in the centerlines table
Tool Tool name Tool description Allow choosing one or more centerlines
Allows you to choose the centerlines in the map and displays them in a table by order of selection. Use the move buttons below the table or drag rows to reorder the chosen centerlines.
Clear the currently chosen centerlines
Clears the chosen centerlines and keeps the selected centerlines. You can reselect after clicking this button or click the Allow choosing one or more centerlines button a second time.
Move chosen centerlines up
Moves one or more selected centerlines up a row in the table order.
Move chosen centerlines to the top
Moves one or more centerlines to the top of the table order.
Move chosen centerlines down
Moves one or more centerlines down a row in the table order.
Move chosen centerlines to the bottom
Moves one or more centerlines to the bottom of the table order.
Flip the direction of the centerlines
Reverses the direction of the chosen centerlines.
Remove the chosen centerlines
Removes the chosen centerline from the table order but leaves it selected.
Tip:
To change the display field shown in the centerlines table, right-click the centerline feature class in the Contents pane and choose Properties from the context menu. On the Layer Properties dialog box, click the Display tab, and click the Display field drop-down arrow to change its value. In the previous image, the display field is OBJECTID.
- In the Realign Route pane, choose the network in which the realignment will take place.
Note:
To edit using feature services, the LRS Network must be published with the linear referencing and version management capabilities.
- Click the Effective Date drop-down arrow to choose an effective date for the realignment.
- Optionally, type the date in the Effective Date text box.
- Double-click the empty Effective Date text box to populate today's date.
- If the centerline touches the routes, the From Route Name, From Measure, To Route Name, and To Measure parameters in the Source Route section are autopopulated.
If the centerline doesn't touch the route, you can use the pickers to populate the From Route Name, To Route Name, From Measure, and To Measure parameters. Additionally, you can type the measure values.
Note:
You can also check the Reassign to abandoned route(s) box to create routes to represent assets that are present but not in use.
- The From Measure value in the Realigned Route section is automatically populated.
The suggested source measure value is the measure at the location where the start of the centerline touches the source route.
Note:
- Z-values are considered when calculating the geometric length of the centerlines.
- Centerlines and routes support z-values.
- Optionally, you can type a source measure value of your choice.
- If you do not know the source measure, allow Pipeline Referencing to suggest it. Click the Recalculate From Measure button to do so. This value is calculated as the difference between the target measure value and the geometric length of the centerline.
- The target measure value is automatically populated in the Realigned Route section.
The suggested target measure value is the measure at the location where the end of the centerline touches the target route. It is calculated as the geometric length of the centerline plus the target measure.
- Optionally, you can type a target measure value of your choice.
- If you do not know the target measure, allow Pipeline Referencing to suggest it. Click the Recalculate To Measure button to do so. This value is calculated as the sum of the source measure value and the geometric length of the centerline.
- Click Run.
The Realign Route pane transitions to the next page, which shows the list of routes that will be retired due to the realignment.
- Choose one of the following options.
If the realignment will result in the creation of a new route
Click Next.
The next screen allows you to give the new route a name and fill in any attributes you choose.
lf a new route will not be created
Click Run.
The Realign Route pane transitions to the next page, which requires you to provide a name for the new route.
- Provide a name for the new route if one will be created.
- Click Next or Run. Depending on whether you chose to abandon or retire the source routes, the following occurs:
- If you choose to retire, RouteX gets retired with its target date populated with the effective date.
- Since the realignment was effective partially on RouteX, another version of RouteX gets created with its source date populated with the effective date and the target date as <NULL>. The source measure is 0 and target measure is 5. These were the measures that were unaffected by the realignment.
- A new route (RouteA) is created in the realigned portion.
- RouteY gets retired with its target date populated with the effective date.
- RouteZ gets retired with its target date populated with the effective date.
- Since the realignment was effective partially on RouteZ, another version of RouteZ gets created with its source date populated with the effective date and the target date as <NULL>. The source measure is 20 and target measure is 25. These were the measures that were unaffected by the realignment.
The following table shows the measures for the routes after the realignment.
Route name From measure To measure Line order RouteX
0
5
100
RouteA
0
27.45
200
RouteZ
25
30
300
Here are some cases where the direction of the centerline is against the direction of the routes in a line network:
- Although a new route is created using the centerline, downstream calibration is not supported.
- No new route is created and the upstream of RouteZ is assimilated with the centerline.
Note:
For the line network, the measures can be entered as station values in 00+00.00 or 00+00.000 format.
Realign a route in a Utility Network dataset
After configuring a Utility Network with Pipeline Referencing using the Configure Utility Network Feature Class tool, you can realign routes in your dataset's pipeline layer using the previous steps.
The centerlines used to realign a route must have the following:
- The from measure and to measure values must be populated.
- The coincident points of the centerline features must have the same measures.
- At the point where the selected centerline intersects the route, the interpolated measure value or calibration point is compared against the from or to measure stored on the centerline to determine if an equation point exists. If an equation point exists, a new route is created.
In the following examples, a route (RouteX) composed of three centerlines (CL1, CL2, CL3) is realigned using three new centerlines (CL4, CL5, CL6).
In example 1, RouteX is realigned using the from measures 5 to 8 without creating any new routes. Notice that the from measure of CL4 has a measure (5) that matches the calibration point value (5) on RouteX.
The to measure of CL4 matches the from measure of CL5 (6), and the to measure of CL5 (7) matches the from measure of CL6 (7). Finally, the to measure of CL6 matches the calibration value (8) on RouteX, so an equation point is not created.
In example 2, RouteX cannot be realigned using the from measures 5 to 9 because the to measure of CL4 (6) does not match the from measure of CL5 (7).
In example 3, RouteX is realigned using the from measures 5 to 9 and results in the creation of a new route (RouteY) that begins at the from measure of CL4 (6) and extends until the end of the route at measure 10. Notice that the from measure of CL4 has a measure (6) that does not match the calibration point value (5) on RouteX and results in an equation point. The to measure of CL4 matches the from measure of CL5 (7), and the to measure of CL5 matches the from measure of CL6 (8). Finally, the to measure of CL6 matches the calibration value (9) on RouteX, so an equation point is not created.
The result is RouteX from measures of 0 to 5 and a new RouteY with from measures 6 to 10.
In example 4, RouteX is realigned using from measures 5 to 10 and results in the creation of two new routes. A new route (RouteY) begins at the from measure of CL4 (6) and extends until the to measure of CL6 (9). Notice that the from measure of CL4 has a measure (6) that does not match the calibration point value (5) on RouteX and results in an equation point. The to measure of CL4 matches the from measure of CL5 (7), and the to measure of CL5 matches the from measure of CL6 (8). Finally, the to measure of CL6 (9) does not match the calibration value (10) on RouteX, so an equation point is created and results in a new route (RouteZ) with measures of 10 to 12 on RouteX.
The result is RouteX with from measures 0 to 5, a new route (RouteY) with from measures 6 to 9, and a second new route (RouteZ) with from measures 10 to 12.