Retire routes

Available with Location Referencing license.

During the lifespan of a pipeline, the routes may change as portions of the routes are removed while others are added. Major changes, such as environmental concerns, age, erosion, or repair work, may require retirement of a portion of a route, retirement of a complete route, or retirement of multiple adjoining routes that belong to the same line for the specified time frame.

When you specify that a portion of a route should be retired, that portion is removed from the route for the specified time frame for a particular network. When a route is retired by the Retire Route tool, the To Date field of the route in the LRS Network feature class is populated with the retirement date. When portions 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 continues to calibrate properly.

Note:

• You can fully or partially retire multiple adjoining routes that belong to the same line.
• You have the option to recalibrate the measures downstream if the source route selected in the Retire Route pane is the same as the target route selected in the Retire Route pane.
• You have the option to recalibrate the measures downstream if the source route selected in the Retire Route pane is not the same as the target route selected in the Retire Route pane, but the recalibration is limited to the end of the target route selected in the Retire Route pane.
• The line order of the downstream routes in the same line as the retired routes will be updated as a result of the retirement.

Route retirement scenarios

The following are examples of route retirement scenarios:

Retirement on a route without recalibration

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

The route is not recalibrated downstream of the retirement, leaving the downstream measures intact. The Line Order field in the network table remains unchanged as the retirement is limited to a single route.

Example 1: Routes and measures

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

Retirement on a route with downstream recalibration

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

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.

Example 2: Routes and measures

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

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 gets completely retired, so the line order of the next routes downstream that are not completely retired are updated.

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

Example 3: Routes and measures

From Route	Route X
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.

Example 4: Routes and measures

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

Parameters by network type

The following tables list the parameters used in the Retire Route 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 will be 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	Choose this option if you want to remove the length of the retired route from your 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	Choose this option if you want to remove the length of the retired route from your overall set of measures.

Retire routes

Use the following steps for retiring 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 retire the route.
3. Click the Retire button on the Location Referencing tab.

   The Retire Route pane appears.

   

4. Choose the Network in which the retirement will take place.

   Note:

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

5. Choose a retire date for the retirement by clicking the Retire Date drop-down arrow.
   • Alternatively, type the date in the Retire Date text box.
   • Double-clicking the empty Retire Date text box will populate today's date.
6. Click the Choose route from map button to choose a route to retire for the From Route Name parameter.
7. Type 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 your retirement is limited to just one route, then the From Route Name and To Route Name will be the same.

9. Type the end measure in the To Measure text box or click the Choose measure from map button to set the end measure. 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.

   Check the Recalibrate route downstream check box if you want to remove the length of the retired route from your overall set of measures.

   If the Recalibrate route downstream check box is unchecked, the modified route gets its start measure from the end measure of the retired portion. The start measure of the modified route remains unchanged. This could create a measure gap on the route if the retirement is not at the endpoint of the route.

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

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

10. Click Run.

    The selected portion of the route is retired.

    Note:

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

    Note:

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