Skip To Content

Realign routes

Available with Location Referencing license.

During the lifespan of a pipeline, route geometry and length may change. Portions of the 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 perform such realignments. The 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 Realign Route tool can be used to realign a single route or to realign several adjoining routes that are part of the same line.

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.

In the following examples, the route has a From measure of 0 and To measure of 10. The line order is 100.

Realign scenarios

  • In the first case, the source measure and target measure of the realigned portion of the route are the measures suggested by Pipeline Referencing. RouteX gets realigned, and the measures downstream of the realignment are updated due to recalibration. The line order remains 100.
  • In the second case, there is no downstream recalibration after the realigned portion of the route. That results in an equation at the end measure of the realigned route. A new route gets created (RouteA) starting from the start of Source Route to the end of the realignment, the To measure location of the realigned route. RouteA gets the line order of 100 and RouteX’s line order changes to 200.
  • In the third case, if the From measure of the realigned route is changed in such a way that it results in an equation (if you don’t use Pipeline Referencing suggested measures) at the From and To measure locations and recalibrating downstream is not 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. 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 in such a way that it results in an equation (if you don’t use Pipeline Referencing suggested measures) 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.

  • In the fourth case, if the From measure of the realigned route is changed in such a way that it results in an equation (if you don’t use Pipeline Referencing suggested measures) and recalibrating downstream is chosen, then a new route is created. 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.

Use the following steps for realigning 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 Select By Rectangle option chosen by default.

  4. Use your mouse to select one or more centerlines by rectangle at the location of the new route.

    You can also opt to 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 interactive selection tools found 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 count of Selected Centerlines 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 count of Chosen Centerlines 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 and drop 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

    Chooses the selected centerlines in the map and displays them in a table by order of selection. Use the move buttons below the table or drag and drop 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 re-select 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. In the Layer Properties dialog box, click the Display tab then 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-clicking the empty Effective Date text box populates 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.

    • 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 tool transitions to the next page that shows the list of routes that are going to 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

  17. 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
    • No new route is created and the upstream of RouteZ is assimilated with the centerline.
      example 2

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.

See the diagram below to understand how the realigned route portions are reassigned to abandoned routes, shown with the _Ab suffix.

Realigned routes reassigned to abandoned routes

Note:

If a message about acquiring locks or reconciling appears, conflict prevention is enabled.

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

Example 1: Realignment in a Utility Network

In example two, 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 three, 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 extend 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 four, 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