Summary
Translates the measures (m-values) of events from one LRM (Linear Referencing Method) 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 different LRMs. These LRMs may have different Route IDs and m-values that require translation between LRMs.
Usage
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 utilizing feature layers.
The output event type (LINE/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 RouteID selected in the table properties (such as src_RouteID). 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).
Syntax
TranslateEventsFromLRMToLRM_roads (in_source_event_layer, in_event_table_properties, in_target_network, in_route_id_field, in_concurrent_route_matching, out_target_event_layer)
Parameter | Explanation | Data Type |
in_source_event_layer | The source event layer to be translated. | Feature Layer |
in_event_table_properties | Parameter consisting of the route identifier field, the geometry type, and the measures in the input event table.
| Route Measure Event Properties |
in_target_network | The route network to which the source events will be translated. | Feature Layer |
in_route_id_field | The field in the target network layer that contains the unique Route IDs for each route. | String |
in_concurrent_route_matching | The method to determine which route to translate the event onto when concurrent routes exist in the target network. This selected method is only applied when the location of the event translation in the target network has concurrent routes.
| String |
out_target_event_layer | The translated event to be created. | Feature Layer |
Code sample
TranslateEventsFromLRMToLRM example 1 (Python window)
Demonstrates how to use the TranslateEventsFromLRMToLRM tool.
#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_roads("Pavement Type", "ROUTE_ID LINE FROM_MEASURE TO_MEASURE", "MileMarker","CustomRouteField", "Pavment_Type_MileMarker")
TranslateEventsFromLRMToLRM example 2 (stand-alone Python script)
Translates a line event In_Access_Control from one LRM to another.
# Name: TranslateEventsFromLRMtoLRM.py
# Description: Translate Event from one LRM to another LRM.
# Requires: Esri Roads and Highways Solution
# 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_roads("event_lyr", event_Table_Properties, "network_lyr", "Route_ID", out_event)
Environments
Licensing information
- ArcGIS Desktop Basic: Requires Roads and Highways
- ArcGIS Desktop Standard: Requires Roads and Highways
- ArcGIS Desktop Advanced: Requires Roads and Highways