Replace events

Available with Location Referencing license.

During roadway replacement, events that were part of the replaced roadway 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.

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

Method	Description	Additional feature classes needed in the service	Additional 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 .

   The Replace Events pane appears.

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

   

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

   

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. In the From: Route and Measure section, specify the route by doing either of the following:
   • Type the route ID in the Route ID text box.
   • Click Choose route from map and click the route on the map.
7. In the From: Route and Measure section, provide the measure by doing any of the following:
   • Click 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.

8. Optionally, in the From: Route and Measure section, choose a unit of measurement using the drop-down arrow.
9. In the To: Route and Measure section, specify a route by doing either of the following:

   Note:

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

   • Type the route ID in the Route ID text box.
   • Click Choose route from map and click the To measure location on the map.
10. 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 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.

11. Optionally, in the To: Route and Measure section, choose a unit of measurement using the drop-down arrow.
12. 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 .
    • 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

13. 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 .
    • 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.

14. Click Next.

    Manage Attributes options appear in the Replace Events pane.

    

    Note:

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

15. 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.

16. Provide the replacement values in the attribute fields.
17. 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 Roads and Highways 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 added or edited.

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 Curbs and Lanes events are replaced using updated measures and different dates, the AADT event is retired.

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

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

Route ID	From Date	To Date	From Measure	To Measure
Route1	1/1/2000	<Null>	0	18

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

FromRefMethod	FromRefLocation	FromRefOffset	ToRefMethod	ToRefLocation	ToRefOffset
AllRoutes	Route1	0	AllRoutes	Route1	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 ID	From Route ID	To Route ID	From Date	To Date	From Measure	To 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 Curbs and Lanes as of 1/1/2005, and the AADT event has been retired as of 1/1/2005.

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

FromRefMethod	FromRefLocation	FromRefOffset	ToRefMethod	ToRefLocation	ToRefOffset
AllRoutes	Route1	2.5	AllRoutes	Route1	15.5

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

Curbs

Event ID	From Date	To Date	From Measure	To Measure
Event1	1/1/2000	1/1/2005	0	18
Event1	1/1/2005	<Null>	2.5	15.5

Lanes

Event ID	From Date	To Date	From Measure	To Measure
Event1	1/1/2000	1/1/2005	0	18
Event1	1/1/2005	<Null>	2.5	15.5

AADT

Event ID	From Date	To Date	From Measure	To Measure
Event1	1/1/2000	1/1/2005	0	18

Before replacing line events using coordinates

In the following example, three event layers that already have referents populated using coordinates are replaced on 1/1/2005 using updated coordinates. Curbs and Lanes event records are replaced using updated measures and different dates, and the AADT event is retired.

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

The following table provides details about the route and associated events before event replacement:

Route ID	From Date	To Date	From Measure	To Measure
Route1	1/1/2000	<Null>	0	18

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

FromRefMethod	FromRefLocation	FromRefOffset	ToRefMethod	ToRefLocation	ToRefOffset
X/Y	33.984980, -117.306397, 20	0	X/Y	33.965456, -117.265669, 20	0

After replacing line events using coordinates

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

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

FromRefMethod	FromRefLocation	FromRefOffset	ToRefMethod	ToRefLocation	ToRefOffset
X/Y	33.977588, -117.291149, 20	0	X/Y	33.960388, -117.279564, 20	0

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

Curbs

Event ID	From Date	To Date	From Measure	To Measure
Event1	1/1/2000	1/1/2005	0	18
Event1	1/1/2005	<Null>	2.5	15.5

Lanes

Event ID	From Date	To Date	From Measure	To Measure
Event1	1/1/2000	1/1/2005	0	18
Event1	1/1/2005	<Null>	2.5	15.5

AADT

Event ID	From Date	To Date	From Measure	To Measure
Event1	1/1/2000	1/1/2005	0	18

Before replacing line events using location offset

In the following example, three event layers that already have referents populated using coordinates are replaced on 1/1/2005 using updated location offset. Curbs and Lanes event records are replaced using updated measures and different dates, and the AADT event is retired. The LRS Intersection feature class found on the route is All Routes Intersections and is used as the input intersection layer. Intersection 1 is on route R1 at measure 9.

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

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

Route ID	From Date	To Date	From Measure	To Measure
Route1	1/1/2000	<Null>	0	18

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

FromRefMethod	FromRefLocation	FromRefOffset	ToRefMethod	ToRefLocation	ToRefOffset
All Routes Intersections	Intersection 1	-9	All Routes Intersections	Intersection 1	9

After replacing line events using location offset

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

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

FromRefMethod	FromRefLocation	FromRefOffset	ToRefMethod	ToRefLocation	ToRefOffset
All Routes Intersections	Intersection 1	-6.5	All Routes Intersections	Intersection 1	6.5

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

Curbs

Event ID	From Date	To Date	From Measure	To Measure
Event1	1/1/2000	1/1/2005	0	18
Event1	1/1/2005	<Null>	2.5	15.5

Lanes

Event ID	From Date	To Date	From Measure	To Measure
Event1	1/1/2000	1/1/2005	0	18
Event1	1/1/2005	<Null>	2.5	15.5

AADT

Event ID	From Date	To Date	From Measure	To Measure
Event1	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.