Process route edits

You can use the Process Edits tool Process Edits to run common post route editing tools. The tool only updates events and intersections impacted by LRS route edits, can be run in or outside an edit session, and supports undo and redo operations using the tools in ArcGIS Pro.

For a line network configured with a derived network, the  Process Edits tool runs the following tools in the order listed:

  1. Generate Intersections—Create or update intersections based on edited routes.
  2. Apply Event Behaviors—Apply event behaviors to edited routes.
  3. Generate Routes—Generate the derived network based on edited routes.
  4. Derive Event Measures—Update the derived event measures on events whose parent route or routes have been edited.

For a nonline network or a line network configured without a derived network, the  Process Edits tool runs the following tools in the order listed:

  1. Generate Intersections—Create or update intersections based on edited routes.
  2. Apply Event Behaviors—Apply event behaviors to edited routes.

Edits processed on a line network

When using the Process Edits tool Process Edits on a line network, it runs the Generate Intersections, Apply Event Behaviors, Generate Routes, and Derive Event Measures tools sequentially on all routes in LRS Networks that have unprocessed edits.

Before route edit

In the following scenario, the last route on a line is about to be retired. There is a spanning line event, point event, and intersection along the line. The two event layers are both configured with the Stay Put event behavior for route retirement operations.

The following diagram shows the state of the LRS data before the route retirement:

Line network before retirement

The following table shows the route information before the route retirement:

NetworkLine NameRoute NameFrom DateTo DateFrom MeasureTo Measure

Line Network

Line1

Route1

1/1/2000

<Null>

0

20

Line Network

Line1

Route2

1/1/2000

<Null>

30

50

Line Network

Line1

Route3

1/1/2000

<Null>

70

90

Derived Network

N/A

Line1

1/1/2000

<Null>

0

60

The following table shows the line event information before the route retirement:

Event IDFrom Route NameTo Route NameFrom DateTo DateFrom MeasureTo MeasureDerived Route NameDerived From MeasureDerived To Measure

LineEvent1

Route1

Route3

1/1/2000

<Null>

0

90

Line1

0

60

The following table shows the point event information before the route retirement:

Event IDRoute NameFrom DateTo DateMeasureDerived Route NameDerived Measure

PointEvent1

Route3

1/1/2000

<Null>

75

Line1

45

The following table shows the intersection information before the route retirement:

Intersection NameRoute NameFrom DateTo DateMeasure

Route3, Boundary1

Route3

1/1/2000

<Null>

85

After route edit

Route3 was retired as of 1/1/2010. The line network has been updated; however, the intersection, events, and derived network layers have not been updated.

The following diagram shows the updated routes after retirement:

Line network after retirement

The following table shows the route information after the route retirement:

NetworkLine NameRoute NameFrom DateTo DateFrom MeasureTo Measure

Line Network

Line1

Route1

1/1/2000

<Null>

0

20

Line Network

Line1

Route2

1/1/2000

<Null>

30

50

Line Network

Line1

Route3

1/1/2000

1/1/2010

70

90

Derived Network

N/A

Line1

1/1/2000

<Null>

0

60

Note:

The intersection, events, and derived network were not updated following the route retirement.

After processed edits

The Process Edits tool completes the LRS workflow by running the tools sequentially to make the following updates to the edited route:

  • Update intersections.
  • Apply event behaviors.
  • Generate routes, including the derived network.
  • Update derived event measures.

The following diagram shows the fully updated LRS after running the Process Edits tool:

Line network after processed edits

The derived network regenerated based on the route retirement. The following table shows the updated derived network information after running the Process Edits tool Process Edits:

NetworkLine NameRoute NameFrom DateTo DateFrom MeasureTo Measure

Line Network

Line1

Route1

1/1/2000

<Null>

0

20

Line Network

Line1

Route2

1/1/2000

<Null>

30

50

Line Network

Line1

Route3

1/1/2000

1/1/2010

70

90

Derived Network

N/A

Line1

1/1/2000

1/1/2010

0

60

Derived Network

N/A

Line1

1/1/2010

<Null>

0

40

The line event layer performs the Stay Put event behavior, and the derived measure information is updated based on the updated derived network. The following table shows the updated line event information after running the Process Edits tool Process Edits:

Event IDFrom Route NameTo Route NameFrom DateTo DateFrom MeasureTo MeasureDerived Route NameDerived From MeasureDerived To Measure

LineEvent1

Route1

Route3

1/1/2000

1/1/2010

0

90

Line1

0

60

LineEvent1

Route1

Route2

1/1/2010

<Null>

0

50

Line1

0

40

The point event layer performs the Stay Put event behavior, and the derived measure information is updated based on the updated derived network. The following table shows the point event information after running the Process Edits tool:

Event IDRoute NameFrom DateTo DateMeasureDerived Route NameDerived Measure

PointEvent1

Route3

1/1/2000

1/1/2010

85

Line1

55

The intersections are regenerated, with the intersection retiring due to the route retirement. There are no longer any routes intersecting the boundary polygon along Line1. The following table shows the intersection information after running the Process Edits tool Process Edits:

Intersection NameRoute NameFrom DateTo DateMeasure

Route3, Boundary1

Route3

1/1/2000

1/1/2010

85

Edits processed on a nonline network

When using the Process Edits tool Process Edits on a nonline network, only the Generate Intersections and Apply Event Behaviors geoprocessing tools are run sequentially on all routes in LRS Networks that have unprocessed edits.

Note:

The Generate Routes and Derive Event Measures tools are not run because a nonline network cannot have a configured derived network.

Before route edit

In the following scenario, the second half of Route1 is about to be retired. There is a line event, point event, and intersection along the route. The two event layers are both configured with Stay Put event behavior for route retirement operations.

The following diagram shows the state of the LRS data before the route retirement:

Nonline network before retirement

The following table shows the route information before the route retirement:

Route NameFrom DateTo DateFrom MeasureTo Measure

Route1

1/1/2000

<Null>

0

60

RouteA

1/1/2000

<Null>

0

10

The following table shows the line event information before the route retirement:

Event IDRoute NameFrom DateTo DateFrom MeasureTo Measure

LineEvent1

Route1

1/1/2000

<Null>

0

60

The following table shows the point event information before the route retirement:

Event IDRoute NameFrom DateTo DateMeasure

PointEvent1

Route1

1/1/2000

<Null>

45

The following table shows the intersection information before the route retirement:

Intersection NameRoute NameFrom DateTo DateMeasure

Route1, RouteA

Route1

1/1/2000

<Null>

55

After route edit

The second half of Route1 was retired as of 1/1/2010. The nonline network has been updated; however, the intersection and events were not updated.

The following diagram shows the updated routes after retirement:

Nonline network after retirement

The following table shows the route information after the route retirement:

Route NameFrom DateTo DateFrom MeasureTo Measure

Route1

1/1/2000

1/1/2010

0

60

Route1

1/1/2010

<Null>

0

30

RouteA

1/1/2000

<Null>

0

10

Note:

The intersection and event layers have not updated following the route retirement.

After processed edits

The Process Edits Process Edits tool completes the LRS workflow by running the tools sequentially to make the following updates to the edited route:

  • Intersections are updated.
  • Event behaviors are applied.

The following diagram shows the fully updated LRS after running the Process Edits tool Process Edits:

Nonline network after processed edits

The line event layer performs the Stay Put event behavior. The following table shows the updated line event information after running the Process Edits tool Process Edits:

Event IDRoute NameFrom DateTo DateFrom MeasureTo Measure

LineEvent1

Route1

1/1/2000

1/1/2010

0

60

LineEvent1

Route1

1/1/2010

<Null>

0

30

The point event layer also performs the Stay Put event behavior. The following table shows the updated point event information after running the Process Edits tool Process Edits:

Event IDRoute NameFrom DateTo DateMeasure

PointEvent1

Route1

1/1/2000

1/1/2010

45

The intersection is regenerated, with the intersection retiring due to the route retirement. Route1 no longer intersects RouteA. The following table shows the intersection information after running the Process Edits tool Process Edits:

Intersection NameRoute NameFrom DateTo DateMeasure

Route1, RouteA

Route1

1/1/2000

1/1/2010

55

Process edits

To run the post route editing tools after you finish a route edit, such as realigning or extending routes, complete the following steps:

  1. On the Location Referencing tab, in the Tools group, click Process Edits Process Edits.
  2. A dialog box appears that shows the progress of the tools. If you're not in an edit session, it starts one so that you can undo or redo resulting changes from this process.
  3. Once the tools finish processing, click OK.
  4. If one of the tools in the process fails, the Process Edits tool will undo all previous steps. You can fix the issues, and run the Process Edits tool Process Edits again.

Related topics