Replace events

Available with Location Referencing license.

During pipe replacement, events that were part of the replaced pipe can be updated using an event replacement configuration that groups event layers so that multiple events can be retired or replaced by new events in a single editing operation.

You must create an event replacement configuration using the Configure Replace Events dialog box before using the Replace Events pane.

Event replacement scenario

In the following example, the events in the three sections of the Configure Replace Events dialog box are exclusive. When events are replaced using a saved configuration, the following occurs:

  • Events in the Event Layers list are left as is.
  • Events in the Retire Events list are retired using the date provided in the Replace Events pane. Retirement is valid for both point and line events.
  • Events in the Retire and Replace Events list are retired and re-created using the dates provided in the Replace Events pane. Only line events can be retired and replaced.

Tip:

This example configuration is used in the event replacement steps below.

Configure Event Replacement dialog box

All the line events that are configured in the Retire and Replace Events list of the Configure Replace Events dialog box appear in Manage Attributes when the configuration is chosen using the Replace Events pane.

Event replacement methods

The following table provides more details on the methods used to replace events in the procedure below:

Methods for locating the measures

MethodDescriptionAdditional feature classes needed in the serviceAdditional information

Route and measure

The measure is located based on the measure values from the chosen route.

None

Add line events by route and measure

Coordinates

The measure is located by x,y- and z-coordinates.

None

Add line events by coordinates

Location Offset

The measure is located as an offset distance from a location.

LRS Intersection

Add line events by location offset

Event replacement

Complete the following steps to replace events using an event replacement configuration:

  1. Open the map in ArcGIS Pro and zoom to the location where you want to replace events.
  2. On the Location Referencing tab, in the Events group, click Replace Replace.

    The Replace Events pane appears.

    Route and Measure is the default setting in the From Method and To Method drop-down lists.

    Replace Events pane
  3. Choose the methods to locate the events to replace from the From Method and To Method drop-down lists.
    Note:

    You can use a combination of any of the event replacement methods to locate the from measure and to measure. For example, you can use Route and measure to choose the from measure value, and use Coordinates to define the to measure value along the route on the map.

  4. Click Next.

    The Network drop-down list, the From method and To method sections, and the Dates section appear in the pane.

    Note:

    The methods you've chosen appear in the From and To section labels. For example, From: Route and Measure and To: Coordinates appear if the chosen From method is Route and Measure and the chosen To method is Coordinates.

    If Coordinates was chosen as a method, choose a spatial reference and provide the measure values as coordinates using any of the provided tools.

    If Location Offset was chosen as a method, choose a LRS Intersection feature class associated with the input network and provide the measure values as an offset from a location using any of the provided tools.

    Replace Events pane using route and measure
  5. Click the Network drop-down arrow and choose the network to use as the source linear referencing method (LRM) for event replacement.
    Note:

    The network must be an LRS Network published as a feature service layer.

  6. Choose the name of the line where the events are located in the Line Name text box.

    Click the Choose line from map tool Choose line from map and click the line on the map.

  7. In the From: Route and Measure section, in the Route Name text box, choose the route where the replacement’s From measure is located by doing either of the following:
    • Type the route's name.
    • Click Choose route from map Choose route from map and click the route on the map.
  8. In the From: Route and Measure section, provide the measure by doing any of the following:
    • Click Choose measure from map Choose measure from map and click the From measure location on the map.
    • Type the From measure in the Measure text box.
    • Check the Use route start measure check box to use the route's start measure as the From measure for the event replacement.

    A green dot appears at the selected location on the map.

  9. Optionally, in the From: Route and Measure section, choose a unit of measurement using the drop-down arrow.
  10. In the To: Route and Measure section, in the Route Name text box, do one of the following:
    Note:

    If there is only one route, the text box in this section is inactive.

    • Type the route's name.
    • Click Choose route from map Choose route from map and click the To measure location on the map.
  11. In the To: Route and Measure section, do one of the following to specify the To measure for the event replacement along the route:
    • Click Choose measure from map Choose measure from map and click the From measure location on the map.
    • Type the To measure in the Measure text box.
    • Check the Use route end measure check box to use the route's end measure as the To measure for the event replacement.

    A red dot appears at the selected location on the map.

    Note:

    The events located between the specified From and To measures are updated as follows:

    • The events in the Retire Events list are retired.
    • The events in the Retire and Replace Events list are retired and replaced by new events.

  12. Optionally, in the To: Route and Measure section, choose a unit of measurement using the drop-down arrow.
  13. Specify the date to define the start date of the events that are replaced by doing one of the following.
    • Choose the start date using the Calendar Calendar.
    • Type the date in the Start Date text box.
    • Check the Route start date check box to use the route start date.
    Note:

    The start date is used as follows:

    • Retirement Date—For events in the Retire Events list
    • Retirement Date—For events in the Retire and Replace Events list
    • Start Date—For the replacement events in the Retire and Replace Events list

  14. Optionally, specify the date to define the end date of the events that are replaced by doing one of the following:
    • Choose the end date using the Calendar Calendar.
    • Type the date in the End Date text box.
    • Check the Route end date check box to use the route end date.
    Note:

    The end date is used as the end date for the replacement events in the Retire and Replace list.

  15. Click Next.

    Manage Attributes options appear in the Replace Events pane.

    Event Replacement attributes
    Note:

    If no events are configured to retire or retire and replace, a message appears indicating so.

  16. Click the Replace Events drop-down arrow and choose an event replacement configuration.

    The editable custom attributes for each of the configured event layers are listed. Events configured to retire are not listed since they are not replaced.

    Tip:

    If you don't want to retire an event, update the configuration so that it is left as is. To leave an event as is, it must not appear in either the Retire Events list or Retire and Replace Events list before event replacement is run.

  17. Provide the replacement values in the attribute fields.
  18. Click Run to complete the event replacement for the specified route or route segment.
    • The events in the Retire Events list are retired.
    • The events in the Retire and Replace Events list are retired, re-created, and displayed on the map.

Referent offset when using event replacement

The Pipeline Referencing events data model supports the configuration of referent event fields and their enablement using the Enable Referent Fields tool. Once referent fields are configured and enabled in a layer, referent locations are populated and persisted in that layer when events are replaced.

When line events are replaced using the Route and Measure method, the parent LRS Network is used as the FromRefMethod and ToRefMethod values, the route is used as the FromRefLocation and ToRefLocation values, and the FromRefOffset and ToRefOffset fields are populated using the route measures.

When line events are replaced using the Coordinates method, X/Y is used as the FromRefMethod and ToRefMethod values, geographic coordinates are used as the FromRefLocation and ToRefLocation values, and the FromRefOffset and ToRefOffset fields are populated with 0.

When line events are replaced using the Location Offset method, the LRS Intersection feature class used as the offset location is used as the FromRefMethod and ToRefMethod values, the LRS Intersection feature is used as the FromRefLocation and ToRefLocation, and the FromRefOffset and ToRefOffset fields are populated using the input offset measure values.

The examples below demonstrate replacing line events that have referent values enabled.

Before replacing line events by route and measure

In the following example, three existing events have referents populated using route and measure. The Consequence Segment and Could Affect Segment events are replaced using updated measures and different dates, and the Pipe Exposure event is retired.

The following diagram shows the routes and associated line events before event replacement:

Before event replacement

The following table provides details about the routes before event replacement:

Route IDFrom DateTo DateFrom MeasureTo Measure

R1

1/1/2000

<Null>

0

5

R2

1/1/2000

<Null>

7

12

R3

1/1/2000

<Null>

13

18

The following table provides details about the event referent fields in the layers before event creation:

FromRefMethodFromRefLocationFromRefOffsetToRefMethodToRefLocationToRefOffset

PipeSeriesNetwork

R1

0

PipeSeriesNetwork

R3

18

The following table shows the default event fields before event replacement. Each of the line event layers has the same dates and measures.

Event IDFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo Measure

Event1

R1

R3

1/1/2000

<Null>

0

18

After replacing line events using route and measure

The following diagram shows the route and associated line events after event replacement:

The from and to measures have been replaced in Consequence Segment and Could Affect Segment as of 1/1/2005, and the Pipe Exposure event has been retired as of 1/1/2005.

After event replacement

The following table provides details about the event referent fields after event replacement:

FromRefMethodFromRefLocationFromRefOffsetToRefMethodToRefLocationToRefOffset

PipeSeriesNetwork

R1

2.5

PipeSeriesNetwork

R3

15.5

The following tables provide details about the default event fields after event replacement:

Consequence Segment

Event IDFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo Measure

Event1

R1

R3

1/1/2000

1/1/2005

0

18

Event1

R1

R3

1/1/2005

<Null>

2.5

15.5

Could Affect Segment

Event IDFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo Measure

Event1

R1

R3

1/1/2000

1/1/2005

0

18

Event1

R1

R3

1/1/2005

<Null>

2.5

15.5

Pipe Exposure

Event IDFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo Measure

Event1

R1

R3

1/1/2000

1/1/2005

0

18

Before replacing line events using coordinates

In the following example, three event layers that have referents populated using coordinates are replaced on 1/1/2005 using updated coordinates. The Consequence Segment and Could Affect Segment event records are replaced using updated measures and different dates, and the Pipe Exposure event is retired.

The following diagram shows the routes and associated line events before event replacement:

Before event replacement

The following table provides details about the routes before event replacement:

Route IDFrom DateTo DateFrom MeasureTo Measure

R1

1/1/2000

<Null>

0

5

R2

1/1/2000

<Null>

7

12

R3

1/1/2000

<Null>

13

18

The following table provides details about the event referent fields in the layers before event creation:

FromRefMethodFromRefLocationFromRefOffsetToRefMethodToRefLocationToRefOffset

X/Y

34.05606109331983, -117.19578130763459, 20

0

X/Y

33.94694081814758, -116.92950950082293, 20

0

After replacing line events using coordinates

The following diagram shows the routes and associated line events after event replacement:

After event replacement

The following table provides details about the event referent fields after event replacement:

FromRefMethodFromRefLocationFromRefOffsetToRefMethodToRefLocationToRefOffset

X/Y

34.04389662595838, -117.1549007152566, 20

0

X/Y

33.97512741401155, -116.99147959082242

0

The following tables provide details about the default event fields after event replacement:

Consequence Segment

Event IDFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo Measure

Event1

R1

R3

1/1/2000

1/1/2005

0

18

Event1

R1

R3

1/1/2005

<Null>

2.5

15.5

Could Affect Segment

Event IDFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo Measure

Event1

R1

R3

1/1/2000

1/1/2005

0

18

Event1

R1

R3

1/1/2005

<Null>

2.5

15.5

Pipe Exposure

Event IDFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo Measure

Event1

R1

R3

1/1/2000

1/1/2005

0

18

Before replacing line events using location offset

In the following example, three event layers that have referents populated using location offset are replaced on 1/1/2005 using updated intersection locations. The Consequence Segment and Could Affect Segment are replaced using updated measures and different dates, and the Pipe Exposure event is retired. The LRS intersection feature class found on the route is Pipe Series Network Intersections and is used as the input intersection layer. Intersection 1 is on route R1 at measure 4 and intersection 2 is on route R3 at measure 14.

The following diagram shows the routes and associated line events before replacement:

Before event replacement

The following table provides details about the routes before event replacement:

Route IDFrom DateTo DateFrom MeasureTo Measure

R1

1/1/2000

<Null>

0

5

R2

1/1/2000

<Null>

7

12

R3

1/1/2000

<Null>

13

18

The following table provides details about the event referent fields in the layers before event creation:

FromRefMethodFromRefLocationFromRefOffsetToRefMethodToRefLocationToRefOffset

Pipe Series Network Intersections

Intersection 1

-4

Pipe Series Network Intersections

Intersection 2

4

After replacing line events using location offset

The following diagram shows the routes and associated line events after event replacement:

After event replacement

The following table provides details about the event referent fields after event replacement:

FromRefMethodFromRefLocationFromRefOffsetToRefMethodToRefLocationToRefOffset

Pipe Series Network Intersections

Intersection 1

-1.5

Pipe Series Network Intersections

Intersection 2

1.5

The following tables provide details about the default event fields after event replacement:

Consequence Segment

Event IDFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo Measure

Event1

R1

R3

1/1/2000

1/1/2005

0

18

Event1

R1

R3

1/1/2005

<Null>

2.5

15.5

Could Affect Segment

Event IDFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo Measure

Event1

R1

R3

1/1/2000

1/1/2005

0

18

Event1

R1

R3

1/1/2005

<Null>

2.5

15.5

Pipe Exposure

Event IDFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo Measure

Event1

R1

R3

1/1/2000

1/1/2005

0

18

Event editing with conflict prevention enabled

You can edit events after acquiring locks for event layers in the Replace Events pane under the following conditions:

  • No one has a lock on the event layers in the Replace Events pane in any version of the feature service for the route on which the events are located.
  • You have an existing event lock on event layers in the Replace Events pane in the same version of the feature service in which you are working.

You can't edit the events in the Replace Events pane under the following conditions:

  • Some or all of the event layers in the Replace Events pane are locked by another person for the route on which the event is located.
  • Some or all of the event layers in the Replace Events pane are locked by you but in a different version.
  • The event is located on a route that is locked by another person.
  • The event is located on a route that is locked by you but in a different version.