Translates the measures (m-values) of events from one linear referencing method (LRM) to another. The output is a new event layer feature class.
This tool helps bring together event data provided by various business units that may use a different LRM. These LRMs may have different route IDs and m-values that require translation between LRMs.
This tool accepts both feature classes and feature layers but works best with feature layers. To use feature layers, the source event and target LRM Network should be added to the map document in ArcMap.
This tool only supports translating a one-time view of a network when using feature layers.
The output event type (LINE or POINT) must match the source event type. The tolerance and resolution settings for the source event feature class should match those of the target network feature class.
This tool adds a field named Loc_Error to the output file. The Location Error attributes for this field include Multi-Match, Partial Match, No Match, and No Error.
This tool also adds three fields with the prefix src_ to the output file. The first field will contain the source route ID selected in the table properties (such as src_route ID). The second field will contain the source From Measure selected in the table properties (such as src_FromMeasure). The third field will contain the source ToMeasure selected in the table properties (such as src_ToMeasure).
arcpy.locref.TranslateEventsFromLRMToLRM(in_source_event_layer, in_event_table_properties, in_target_network, in_route_id_field, in_concurrent_route_matching, out_target_event_layer)
The source event layer to be translated.
Specifies the route identifier field, the geometry type, and the measures in the input event table.
|Route Measure Event Properties|
The route network to which the source events will be translated.
The field in the target network layer that contains the unique route IDs for each route.
Specifies the route to which the event will be translated when concurrent routes exist in the target network. The selected method is only applied when the location of the event translation in the target network has concurrent routes.
The translated event to be created.
TranslateEventsFromLRMToLRM example 1 (Python window)
Use the TranslateEventsFromLRMToLRM tool in ArcMap.
#tool variables in_source_event_layer = "Pavement Type" in_event_table_properties = "ROUTE_ID LINE FROM_MEASURE TO_MEASURE" in_target_network = "MileMarker" in_route_id_field = "CustomRouteField" out_target_event_layer = "Pavement_Type_MileMarker" # set current workspace arcpy.env.workspace = "C:/Data/NY_Data.gdb" # execute the tool arcpy.TranslateEventsFromLRMToLRM_locref(in_source_event_layer, in_event_table_properties, in_target_network, in_route_id_field, out_target_event_layer)
TranslateEventsFromLRMToLRM example 2 (stand-alone Python script)
Use the TranslateEventsFromLRMToLRM tool in a Python script.
# Name: TranslateEventsFromLRMtoLRM.py # Description: Translate Event from one LRM to another LRM. # Import arcpy module import arcpy # Check out any necessary licenses arcpy.CheckOutExtension("Highways") # Local variables: event = "C:/Data/NY_Data.gdb/LRSE_Pavement_Type" network = "C:/Data/NY_Data.gdb/LRSN_MileMarker" out_event = "C:/Data/NY_Data.gdb/Pavement_Type_MMarker" event_Table_Properties = "ROUTE_ID LINE FROM_MEASURE TO_MEASURE" # Process: Make Feature Layer arcpy.MakeFeatureLayer_management(event, "event_lyr") arcpy.MakeFeatureLayer_management(network, "network_lyr") # Process: Translate Events From LRM To LRM arcpy.TranslateEventsFromLRMToLRM_locref("event_lyr", event_Table_Properties, "network_lyr", "Route_ID", out_event)
- Basic: Requires Roads and Highways
- Standard: Requires Roads and Highways
- Advanced: Requires Roads and Highways