Skip To Content

Create and modify LRS Events

Available with Location Referencing license.

With tools provided by ArcGIS Pipeline Referencing, you can create line or point events in a new event feature class for an existing LRS Network; modify an existing event feature class in an existing LRS Network; or load event records from a table, layer, or feature class into an existing event feature class using the following workflows.

Events in the same geodatabase as the LRS are managed as feature classes. The shape of the event features is managed based on the route, measure, and To and From dates.

Create an LRS Event

You can use the Create LRS Event geoprocessing tool to create line or point events for an existing LRS Network. If the event feature class is not modeled in advance, it can be created as an output of this tool while the event is registered in the LRS geodatabase.

For more information about the event feature class and its fields and properties, see Events data model.

To add derived measure fields to the event feature class, run the Enable Derived Measure Fields geoprocessing tool.

To add referent fields to the event feature class, run the Enable Referent Fields geoprocessing tool. This tool enables the referent fields by allowing you to register existing fields as referent fields.

When the Create LRS Event geoprocessing tool finishes running with these options, a feature class is created in the geodatabase and is registered with the LRS.

  1. In ArcGIS Pro, open the Create LRS Event geoprocessing tool.
  2. Click the Browse button next to Parent LRS Network and browse to the LRS network feature class in the geodatabase where the event will be registered.

    The Event ID Field, Route ID Field, From Date Field, To Date Field, Location Error Field, and Measure Field are populated from the chosen Parent LRS Network.

    Note:

    If an LRS Network feature class doesn't exist in your LRS, see Create and modify an LRS Network.

  3. Type the name of the event to be registered in the Event Name text box.

    If the event feature class doesn't exist in the LRS Network, it will be created.

  4. Click the Geometry Type drop-down arrow and choose point or line.
  5. Use the default name or type a name for the event ID event feature class field in the Event ID Field text box.
  6. Use the default name or type a name for the route ID event feature class field in the Route ID Field text box.
  7. Use the default name or type a name for the From date event feature class field in the From Date Field text box.
  8. Use the default name or type a name for the To date event feature class field in the To Date Field text box.
  9. Use the default name or type a name for the location error event feature class field in the Location Error Field text box.
  10. Use the default name or type a name for the measure event feature class field in the Measure text box.

    The Measure Field parameter options depend on the chosen Geometry Type parameter:

    • If you're creating a point event; type the name of the measure field in the event feature class.
    • If you're creating a line event; type the name of the From measure field in the event feature class, and then also specify a To measure field in the To Measure Field text box.

  11. Optionally check the Store Route Name check box to store the route name with the event records.
  12. Optionally check the Event Spans Routes check box to enable spanning routes for this event.
  13. Click Run to run the geoprocessing tool.

The event feature class is mapped to the selected fields.

Create an LRS Event from an existing dataset

You can use the Create LRS Event From Existing Dataset geoprocessing tool to create line or point events for an existing LRS Network using an existing feature class.

For more information about the event feature class and its fields and properties, see Events data model.

  1. In ArcGIS Pro, open the Create LRS Event From Existing Dataset geoprocessing tool.
  2. Click the Browse button next to Parent LRS Network and browse to the LRS network feature class in the geodatabase where the event will be registered.
    Note:

    If an LRS Network feature class doesn't exist in your LRS, see Create and modify an LRS Network.

  3. Type the name of the event to be registered in the Event Name text box.
  4. Choose the event feature class by clicking the Event Feature Class drop-down arrow.

    The remaining fields are populated based on the chosen event feature class.

  5. Use the default name or choose the event ID feature class field in the Event ID Field drop-down list.
  6. Use the default name or choose the route ID feature class field name in the Route ID Field drop-down list.
  7. Use the default name or choose the From date feature class field name in the From Date Field drop-down list.
  8. Use the default name or choose the To date feature class field name in the To Date Field drop-down list.
  9. Use the default name or choose the location feature class field name in the Loc Error Field drop-down list.
  10. Use the default name or choose the measure feature class field name in the Measure drop-down list.

    If you're creating a line event; choose the From measure field in the event feature class by clicking the Measure Field drop-down arrow. The To Measure Field also appears for line events.

  11. For line events only, use the default To measure feature class field or choose it by clicking the To Measure Field drop-down arrow.
  12. Optionally check the Event Spans Routes check box to enable spanning routes for this event.
  13. Optionally check the Store Route Name check box if you'd like to store the route name with the event records.
  14. Click Run to run the geoprocessing tool.

The event feature class is mapped to the selected fields.

Modify an existing LRS Event

You can modify existing LRS Events using the Modify LRS Event geoprocessing tool by remapping one or more LRS Event fields in an LRS Event feature class. This tool can be used to add or remove properties from a line or point event.

Note:

Any new fields that will be used for field mapping should be created in the underlying LRS Event feature class before using this tool and must have the properties outlined in the events data model.

  1. In ArcGIS Pro, open the Modify LRS Event geoprocessing tool.
  2. Choose the LRS Event feature class to modify by clicking the LRS Event Feature Class drop-down arrow.

    The input feature class must represent a Pipeline Referencing LRS Event.

    The remaining fields are populated based on the selected event feature class.

    Tip:

    You can also choose the event feature class by clicking the Browse button Browse.

  3. Choose the replacement field or fields you created in your LRS Event feature class to remap the LRS Event feature class to them.
  4. Click Run to run the geoprocessing tool.

The event feature class is remapped to the selected fields.

Load event data

You can load event records from a table, layer, or feature class into an existing event feature class using the Append Events geoprocessing tool.

  1. In ArcGIS Pro, open the Append Events geoprocessing tool.
  2. Choose the table, layer, or feature class that contains the events to load by clicking the Input Event drop-down arrow.
    Tip:

    You can also choose the input table, layer, or feature class by clicking the Browse button Browse.

  3. Choose the existing event layer or feature class into which the source event records will be loaded.
  4. Choose to add, retire overlaps, retire by event ID, or replace by event ID by clicking the Load Type drop-down arrow in the Field Map section.

    The field map controls how the attribute information in the fields of the Input Event is transferred to the target event. Because the input event data is appended to an existing event that has a predefined schema (field definitions), fields cannot be added or removed from the target dataset. While you can set merge rules for each output field, the tool ignores those rules.

    The load type determines how appended events with measure or temporality overlap with identical Event IDs as target event records are loaded into the event feature class.

    • Add—Appends input event records to the Target Event. No changes are made to target event records.
    • Retire overlaps—Appends input event records to the Target Event and retires any records in the Target Event with measure or temporality overlaps as the appended events. If the appended event eclipses the Target Event, it will be deleted. This option should only be used for linear events.
    • Retire by event ID—Appends input event records to the Target Event and retires any records in the Target Event with the same event ID and temporality overlaps as the appended events. If the appended event eclipses the Target Event with the same event ID, it will be deleted.
    • Replace by event ID—Appends input event records to the Target Event and deletes any records in the Target Event with the same event ID as the appended events.
  5. Click Run to run the geoprocessing tool.

The event features are loaded.