Retire routes

Available with Location Referencing license.

During the lifespan of a pipeline, major changes—such as environmental concerns, age, erosion, or repair work—can require retirement of a route segment, an entire route, or multiple adjoining routes that belong to the same line for the specified time frame.

When you specify that a section of a route should be retired, that section is removed from the route for the specified time frame for a particular network. When a route is retired using the Retire tool, the route's To Date field in the LRS Network feature class is populated with the retirement date.

When sections of a route are retired, the centerline features are split to accommodate the precise location of the retire operation. Calibration points are also added to ensure that the remainder of the route is calibrated properly.

Route retirement scenarios

Route retirement scenarios are described below.

Retirement on a route without recalibration

Retirement is from the start of the route to the middle portion of the route.

From Route	RouteX
From Measure	0
To Measure	5
Recalibrate Downstream	No

After retirement, the route is not recalibrated, leaving the downstream measures intact.

The line order remains unchanged, as the retirement is limited to a single route.

Retirement on a route with downstream recalibration

Retirement is from the start of the route to the middle portion of the route. The route is recalibrated downstream and the downstream measures are updated.

From Route	RouteX
From Measure	0
To Measure	5
Recalibrate Downstream	Yes

The start measure of the remaining route is updated to the same value as the start measure of the route before its retirement.

The line order remains unchanged, as the retirement is limited to a single route.

Retirement between routes without downstream recalibration

The retirement takes place between two routes (RouteX and RouteY) that belong to the same line. The route is not recalibrated downstream of the retirement, so the downstream measures remain intact.

RouteX is completely retired, so the line order of the downstream routes is updated.

From Route	RouteX
From Measure	0
To Route	RouteY
To Measure	4
Recalibrate Downstream	No

Retirement between routes with downstream recalibration

The retirement takes place between two routes (RouteX and RouteY) that belong to the same line.

The route is recalibrated downstream of the retirement, so the downstream measures are updated until the end of the target route (RouteY). RouteX is completely retired, so the line order of the downstream routes is updated.

From Route	RouteX
From Measure	0
To Route	RouteY
To Measure	4
Recalibrate Downstream	Yes

Complex route retirement scenarios

Route retirement scenarios for complex routes including loop, lollipop, branch, alpha, and infinity routes are described below.

Retirement on a loop route

In the following example, RouteX has a start measure of 0 and an end measure of 12. Retirement takes place from the middle to the end of a loop route:

From Route	RouteX
From Measure	9
To Measure	12
Recalibrate Downstream	No

After retirement, RouteX becomes a simple route.

Retirement on a lollipop route

Retirement takes place in the middle of the lollipop route. In the following example, RouteX has a start measure of 0 and an end measure of 15:

From Route	RouteX
From Measure	4
To Measure	8
Recalibrate Downstream	No

After retirement, RouteX becomes a branch route.

The line order remains unchanged, as the retirement is limited to a single route.

In the second example, retirement takes place from the middle to the end of the lollipop route.

From Route	RouteX
From Measure	12
To Measure	15
Recalibrate Downstream	No

After retirement, RouteX becomes a loop route.

The line order remains unchanged, as the retirement is limited to a single route.

Retirement on a branch route

In the following example, RouteX has a start measure of 0 and an end measure of 9. Retirement takes place from the beginning to the middle of the branch route:

From Route	RouteX
From Measure	0
To Measure	3
Recalibrate Downstream	No

After retirement, RouteX becomes a simple route.

The line order remains unchanged, as the retirement is limited to a single route.

In the second example, retirement takes place from the middle to the end of the branch route.

From Route	RouteX
From Measure	6
To Measure	9
Recalibrate Downstream	No

After retirement, RouteX becomes a simple route.

The line order remains unchanged, as the retirement is limited to a single route.

Retirement on an alpha route

Retirement takes place from the start to the middle portion of the alpha route. In the following example, RouteX has a start measure of 0 and an end measure of 18:

From Route	RouteX
From Measure	0
To Measure	6
Recalibrate Downstream	No

After retirement, RouteX becomes a simple route.

The line order remains unchanged, as the retirement is limited to a single route.

Retirement on an infinity route

Retirement takes place from the middle to the end of the infinity route. In the following example, RouteX has a start measure of 0 and an end measure of 24:

From Route	RouteX
From Measure	18
To Measure	24
Recalibrate Downstream	No

After retirement, RouteX becomes an alpha route.

The line order remains unchanged, as the retirement is limited to a single route.

Parameters by network type

The following tables list the parameters used in the Retire tool.

Parameters used for Engineering Stationing Networks

Parameter	Description
Network	The network in which the Engineering Stationing routes exist.
Retire Date	The date when the retirement has taken place on the ground.
From Route Name	The route where the retirement starts.
From Measure	The measure on the source route where the retirement starts; shown by the green dot.
Use route start measure	The starting measure of the source route.
To Route Name	The route where the retirement ends. For example, if the retirement takes place on a single route, the source route and target route are the same.
To Measure	The measure on the target route where the retirement ends; shown by the red dot.
Use route end measure	The ending measure of the target route.
Recalibrate route downstream	Remove the length of the retired route from the overall set of measures.

Parameters used for Continuous Measure Networks

Parameter	Description
Network	The network in which the continuous routes exist.
Retire Date	The date when the retirement has taken place on the ground.
Route Name	The route where the retirement takes place.
From Measure	The measure on the source route where the retirement starts; shown by the green dot.
Use route start measure	The starting measure of the source route.
To Measure	The measure on the source route where the retirement ends; shown by the red dot.
Use route end measure	The ending measure of the target route.
Recalibrate route downstream	Remove the length of the retired route from the overall set of measures.

Retire routes

To retire routes, complete the following steps:

Note:

Gap calibration rules are followed when editing routes.

1. Add the centerline and network feature class to a map.

   Alternatively, open a map in which the centerline and network feature class are present.

   Note:

   The information model expects only one centerline at any given location. Ensure that the centerlines used for your edit do not overlap other centerlines in the 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 retire the route.
3. On the Location Referencing tab, in the Routes group, click Retire .

   The Retire Route pane appears.

   

4. Click the Network drop-down arrow and choose the network that contains the route to retire.

   Note:

   To edit using feature services, the LRS Network must be published with the linear referencing and version management capabilities.

5. Click the Retire Date drop-down arrow and choose a retire date.
   • Alternatively, provide the date in the Retire Date text box.
   • Double-click the empty Retire Date text box to populate the current date.
6. Click the Choose route from map button to choose a route to retire for the From Route Name parameter.

   Note:

   After clicking the Choose route from map button or the Choose measure from map button , you can hover over the routes to see the route and measure at the location of the pointer.

   If only one applicable route exists at the edit location, click to select it. If multiple routes are applicable, click to choose one of the applicable routes using the Select Route dialog box.

   You can set map scale options for display of route and measure information on the Options dialog box, on the Location Referencing tab.

7. Provide the start measure in the From Measure text box or click the Choose measure from map button to set the value.

   Tip:

   You can also check the Use route start measure check box to choose the start measure of the route.

   A green dot is placed on the start measure location of the route.

8. Click the Choose route from map button to choose a route to retire for the To Route Name parameter.

   If the retirement is limited to one route, the From Route Name and To Route Name values are the same.

9. Provide the end measure in the To Measure text box or click the Choose measure from map button to set the end measure.

   Tip:

   You can also check the Use route end measure check box to choose the end measure of the route.

   Note:

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

   Optionally, check the Recalibrate route downstream check box to remove the length of the retired route from the overall set of measures.

   If the Recalibrate route downstream check box is unchecked, a measure gap may be created on the route if the retirement is not at the endpoint of the route.

   You can't retire the routes if the From Measure value equals the To Measure value for the same route.

   A red dot is placed on the end measure location of the route.

10. Click Run.

    Note:

    • If the route edit will result in the introduction of one or more physical gaps on the route, a prompt appears to alert you before the tool is run. If you don't plan to create a gapped route, click No.
    • If the route being edited already had one or more physical gaps, and no more physical gaps were introduced by the edit, no prompt appears.
    • You can disable this warning by unchecking Warn before allowing route edits that can create physical gaps on the Location Referencing tab on the Options dialog box.

    The selected section of the route is retired.

    Note:

    As a result of the retire route activity, only routes or sections of a route are retired; centerlines are not retired.

    Note:

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

    Note:

    In a combined Utility Network and Pipeline Referencing deployment, if the centerline is split because of this edit activity, the RouteID, From Measure, and To Measure fields are updated for the split centerlines.