Realign routes

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

ParameterDescription

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

ParameterDescription

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.

Example 1: Realign with measures suggested by the software

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: Realign route with recalibrated measures based on the suggested measures

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: Realign route with no downstream recalibration

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 route with no downstream recalibration

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: Realign route will result in an equation

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: Realign route with an equation and downstream recalibration results in two new routes

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.

Realign diagram with proposed realign

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 resulting realign route diagram

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.

Realigned routes reassigned to abandoned routes
Realigned routes reassigned to abandoned routes

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.

Example 1: Input for realignment on a loop 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.

Example 1: Output for realignment on a loop route

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.

Example 1: Input for realignment on a lollipop route

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.

Example 1: Output for realignment on a lollipop route

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.

Example 1: Input for realignment on a gapped route

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.

Example 1: Output for realignment on a gapped route

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.

Example 1: Input for realignment on an infinity route

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.

Example 1: Output for realignment on an infinity route

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.

Example 1: Input for realignment on a branch route

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.

Example 1: Output for realignment on a branch route

Use the following steps for realigning routes:

Note:

Gap calibration rules are followed when editing routes.

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

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

  3. On the Location Referencing tab, in the Routes group, click Realign Realign.
    Realign button

    The Realign Route pane appears with the Select By Rectangle option Select By Rectangle selected by default.

  4. 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 Polygon, Select By Lasso Select by Lasso, Select By Circle Select by Circle, Select By Line Select by Line, or Select By Trace 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 Allow choosing one or more centerlines 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 Flip the direction of the centerlines.
    • 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.
  5. Click the Allow choosing of one or more centerlines button Allow choosing one or more centerlines.

    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.

    Realign Route pane
  6. 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

    ToolTool nameTool description
    Allow choosing one or more centerlines

    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

    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

    Move chosen centerlines up

    Moves one or more selected centerlines up a row in the table order.

    Move chosen centerlines to the top

    Move chosen centerlines to the top

    Moves one or more centerlines to the top of the table order.

    Move chosen centerlines down

    Move chosen centerlines down

    Moves one or more centerlines down a row in the table order.

    Move chosen centerlines to the bottom

    Move chosen centerlines to the bottom

    Moves one or more centerlines to the bottom of the table order.

    Flip the direction of the centerlines

    Flip the direction of the centerlines

    Reverses the direction of the chosen centerlines.

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

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

  8. 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.
  9. 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.

    Learn more about reassigning to an abandoned route

  10. Note:

    For the line network, the measures can be entered as station values in 00+00.00 or 00+00.000 format.

  11. 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:
    • 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 Recalculate From Measure to do so. This value is calculated as the difference between the target measure value and the geometric length of the centerline.
  12. 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 Recalculate To Measure to do so. This value is calculated as the sum of the source measure value and the geometric length of the centerline.
  13. 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.

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

  15. Provide a name for the new route if one will be created.
  16. 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 nameFrom measureTo measureLine 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.
      Example 1 input: Centerline in edit region is against the direction of routes in a line network
      Example 1 output: A route is created without downstream calibration on centerlines against the direction of routes in a line network
    • No new route is created and the upstream of RouteZ is assimilated with the centerline.
      Example 2: input: No new route will be created
      Example 2: output: RouteZ is assimilated with the centerline

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.

Example 1: Before realignment in a Utility Network

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.

Example 1: After realignment in a Utility Network

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

Example 2: Realignment in a Utility Network

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.

Example 3: Realignment in a Utility Network

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.

Example 4: Realignment in a Utility Network