Create LRS Event From Existing Dataset (Location Referencing)

Summary

Registers an existing feature class as an LRS event.

Usage

Parameters

LabelExplanationData Type
Parent LRS Network

The network to which the event will be registered.

Feature Layer
Event Feature Class

The event to be registered.

Feature Layer
Event ID Field

The event ID field in the event feature class.

Field
Route ID Field

The route ID field if the feature class is a point event that doesn't span routes or the from route ID field if the feature class is a line event that spans routes.

Field
From Date Field

The from date field in the event feature class.

Field
To Date Field

The to date field in the event feature class.

Field
Loc Error Field

The location error field in the event feature class.

Field
Measure Field

The measure field if the feature class is a point event or the from measure field if the feature class is a line event.

Field
To Measure Field
(Optional)

The to measure field in the event feature class. This parameter is required for line events.

Field
Event Spans Routes
(Optional)

Specifies whether the event records will span routes.

  • Checked—The event records will span routes.
  • Unchecked—The event records will not span routes. This is the default.
Boolean
To Route ID Field
(Optional)

The to route ID field for events that span routes. This parameter is required if the event feature class geometry type is polyline.

Field
Store Route Name
(Optional)

Specifies whether the route name will be stored with the event records.

  • Checked—The route name will be stored with the event records.
  • Unchecked—The route name will not be stored with the event records. This is the default.
Boolean
Route Name Field
(Optional)

The route name field if the feature class is a point event that doesn't span routes or the from route name field if the feature class is a line event that spans routes. This parameter is required if Store Route Name is checked.

Field
To Route Name Field
(Optional)

The to route name field for line events that span routes. This parameter is required if Store Route Name is checked.

Field

Derived Output

LabelExplanationData Type
Output Event Feature Class

The updated event feature layer.

Feature Layer

arcpy.locref.CreateLRSEventFromExistingDataset(parent_network, in_feature_class, event_id_field, route_id_field, from_date_field, to_date_field, loc_error_field, measure_field, {to_measure_field}, {event_spans_routes}, {to_route_id_field}, {store_route_name}, {route_name_field}, {to_route_name_field})
NameExplanationData Type
parent_network

The network to which the event will be registered.

Feature Layer
in_feature_class

The event to be registered.

Feature Layer
event_id_field

The event ID field in the event feature class.

Field
route_id_field

The route ID field if the feature class is a point event or the from route ID field if the feature class is a line event and event_spans_routes is set to SPANS_ROUTES.

Field
from_date_field

The from date field in the event feature class.

Field
to_date_field

The to date field in the event feature class.

Field
loc_error_field

The location error field in the event feature class.

Field
measure_field

The measure field if the feature class is a point event or the from measure field if the feature class is a line event.

Field
to_measure_field
(Optional)

The to measure field in the event feature class. This parameter is required for line events.

Field
event_spans_routes
(Optional)

Specifies whether the event records will span routes.

  • NO_SPANS_ROUTESThe event records will not span routes. This is the default.
  • SPANS_ROUTES The event records will span routes.
Boolean
to_route_id_field
(Optional)

The to route ID field for events that span routes. This parameter is required if the in_feature class parameter geometry type is polyline and event_spans_routes is set to SPANS_ROUTES.

Field
store_route_name
(Optional)

Specifies whether the route name will be stored with the event records.

  • NO_STORE_ROUTE_NAME The route name will not be stored with the event records. This is the default.
  • STORE_ROUTE_NAMEThe route name will be stored with the event records.
Boolean
route_name_field
(Optional)

The route name field if the feature class is a point event that doesn't span routes or the from route name field if the feature class is a line event that spans routes. This parameter is required if store_route_name is set to STORE_ROUTE_NAME.

Field
to_route_name_field
(Optional)

The to route name field for line events that span routes. This parameter is required if store_route_name is set to STORE_ROUTE_NAME.

Field

Derived Output

NameExplanationData Type
out_feature_class

The updated event feature layer.

Feature Layer

Code sample

CreateLRSEventFromExistingDataset example 1 (Python window)

The following script creates an LRS event from an existing dataset using the CreateLRSEventFromExistingDataset function in the Python window.

# Name: CreateLRSNetworkFromExisting_ex5.py
# Description: Create an LRS Event from an existing dataset.
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
parent_network = r"C:\data.gdb\LRS\Network"
in_feature_class = r"C:\data.gdb\LRS\Event"
event_id_field = "EventID"
route_id_field = "FromRouteId"
from_date_field = "FromDate"
to_date_field = "ToDate"
loc_error_field = "LocationError"
measure_field = "FromMeasure"
to_measure_field = "ToMeasure"
event_spans_routes = "SPANS_ROUTES"
to_route_id_field = "ToRouteId"
store_route_name = "STORE_ROUTE_NAME"
route_name_field = "FromRouteName"
to_route_name_field = "ToRouteName"

# Set current workspace
arcpy.env.workspace = "C:\data.gdb"

# Execute the tool
arcpy.locref.CreateLRSEventFromExistingDataset(parent_network, in_feature_class, event_id_field, route_id_field,
                                               from_date_field, to_date_field, loc_error_field, measure_field,
                                               to_measure_field, event_spans_routes, to_route_id_field,
                                               store_route_name, route_name_field, to_route_name_field)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
CreateLRSEventFromExistingDataset example 2 (stand-alone script)

The following script creates an LRS event from an existing dataset using the CreateLRSEventFromExistingDataset function in a stand-alone Python script.

# Name: Create_LRS_Event_From_Existing_Dataset_ex2.py
# Description: Registers an existing feature class as an event.
# Requires: ArcGIS Location Referencing 

# Import arcpy module
import arcpy 

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables 
parent_network = r"C:\data.gdb\LRS\Network"
in_feature_class = r"C:\data.gdb\LRS\Event"
event_id_field = "EventID"
route_id_field = "FromRouteId"
from_date_field = "FromDate"
to_date_field = "ToDate"
loc_error_field = "LocationError"
measure_field = "FromMeasure"
to_measure_field = "ToMeasure"
event_spans_routes = "SPANS_ROUTES"
to_route_id_field = "ToRouteId"
store_route_name = "STORE_ROUTE_NAME"
route_name_field = "FromRouteName"
to_route_name_field = "ToRouteName"


# Execute the tool
arcpy.locref.CreateLRSEventFromExistingDataset(parent_network, in_feature_class, event_id_field, route_id_field,
                                               from_date_field, to_date_field, loc_error_field, measure_field,
                                               to_measure_field, event_spans_routes, to_route_id_field,
                                               store_route_name, route_name_field, to_route_name_field)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)
  • Standard: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)
  • Advanced: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)

Related topics