Available with Location Referencing license.
ArcGIS Location Referencing allows you to 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.
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 start and end dates.
Create an LRS Event
You can use the Create LRS Event tool to create line or point events for an existing LRS Network. If the event feature class is not modeled in advance, you can create it as an output of this tool while the event is registered in the LRS geodatabase.
Learn more about the event feature class and its fields and properties
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 tool. This tool enables the referent fields by allowing you to register existing fields as referent fields.
When the Create LRS Event tool is run with these options, a feature class is created in the geodatabase and is registered with the LRS.
- In ArcGIS Pro, open the Create LRS Event tool.
- 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 parameters are populated from the specified Parent LRS Network value.
Note:
If an LRS Network feature class doesn't exist in your LRS, you must create one.
- Provide the name of the event to be registered in the Event Name parameter.
If the event feature class doesn't exist in the LRS Network, it is created.
- Click the Geometry Type drop-down arrow and choose Point or Line.
- Use the default name or provide a name for the event ID event feature class field in the Event ID Field parameter.
- Use the default name or provide a name for the route ID event feature class field in the Route ID Field parameter.
- Use the default name or provide a name for the from date event feature class field in the From Date Field parameter.
- Use the default name or provide a name for the to date event feature class field in the To Date Field parameter.
- Use the default name or provide a name for the location error event feature class field in the Location Error Field parameter.
- Use the default name or provide a name for the measure event feature class field in the Measure Field parameter.
The Measure Field parameter options depend on the specified Geometry Type value:
- If you're creating a point event, provide the name of the measure field in the event feature class.
- If you're creating a line event, provide the name of the from measure field in the event feature class and specify a to measure field in the To Measure Field parameter.
- Optionally, check the Store Route Name parameter to store the route name with the event records.
- Optionally, check the Event Spans Routes parameter to enable spanning routes for this event.
Note:
This parameter is active only if Geometry Type is Line.
- Click Run to run the 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 tool to create line or point events for an LRS Network using an existing feature class.
To add referent fields to the event feature class, run the Enable Referent Fields tool. This tool enables the referent fields by allowing you to register existing fields as referent fields.
Learn more about the event feature class and its fields and properties
- In ArcGIS Pro, open the Create LRS Event From Existing Dataset tool.
- 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, you must create one.
- Provide the name of the event to be registered in the Event Name parameter.
If the event feature class doesn't exist in the LRS Network, it is created.
- Click the Event Feature Class drop-down arrow and choose the event feature class.
The remaining parameters are populated based on the chosen event feature class.
Note:
The event feature class must reside in the same feature dataset that contains the LRS.
- Use the default name or choose the event ID feature class field from the Event ID Field drop-down menu.
- Use the default name or choose the route ID feature class field name from the Route ID Field drop-down menu.
- Use the default name or choose the start date feature class field name from the From Date Field drop-down menu.
- Use the default name or choose the end date feature class field name from the To Date Field drop-down menu.
- Use the default name or choose the location feature class field name from the Loc Error Field drop-down menu.
- Use the default name or choose the measure feature class field name from the Measure Field drop-down menu.
If you're creating a line event; choose the start measure field in the event feature class by clicking the Measure Field drop-down arrow. The To Measure Field parameter is active for line events.
- For line events only, use the default end measure feature class field or choose it from the To Measure Field drop-down menu.
- Optionally, check the Event Spans Routes parameter to enable spanning routes for this event.
Note:
This parameter is active only if Geometry Type is Line.
- Optionally, check the Store Route Name parameter to store the route name with the event records.
- Click Run to run the tool.
The event feature class is mapped to the selected fields.
Modify an LRS Event
You can modify existing LRS events using the Modify LRS Event tool by remapping one or more LRS event fields in an LRS event feature class. You can use this tool 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.
- In ArcGIS Pro, open the Modify LRS Event tool.
- Click the LRS Event Feature Class drop-down arrow and choose the LRS event feature class you want to modify.
The feature class must represent an LRS event.
The remaining parameters are populated based on the selected event feature class.
Tip:
You can also choose the event feature class by clicking the Browse button
. - Choose the replacement field or fields you created in the LRS event feature class.
- Click Run to run the 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 tool.
- In ArcGIS Pro, open the Append Events tool.
- Click the Input Event drop-down arrow and choose the table, layer, or feature class that contains the events you want to load.
Tip:
You can also click the Browse button
next to Input Event to choose the input table, layer, or feature class. - Click the Target Event drop-down arrow and choose the existing event layer or feature class that contains the source event records you want to load.
- Click the Load Type drop-down arrow in the Field Map section and choose a method for loading the events.
- Add—Appends input event records to the Target Event value. No changes are made to target event records.
- Retire overlaps—Appends input event records to the Target Event value and retires any records in the Target Event value with measure or temporality overlaps as the appended events. If the appended event eclipses the Target Event value, it is deleted. This option should only be used for linear events.
- Retire by event ID—Appends input event records to the Target Event value and retires any records in the Target Event value with the same event ID and temporality overlaps as the appended events. If the appended event eclipses the Target Event value with the same event ID, it is deleted.
- Replace by event ID—Appends input event records to the Target Event value and deletes any records in the Target Event value with the same event ID as the appended events.
The Field Map parameter value controls how the attribute information in the fields of the Input Event parameter value 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 deleted from the target dataset. While it is possible to set merge rules for each output field, the tool ignores those rules.
The Load Type parameter value specifies how appended events with measure or temporality overlap with identical Event IDs. Target event records are loaded into the event feature class.
- Click Run to run the tool.
The event features are loaded.