Skip To Content

Translate Event Measures

Summary

Translates the measures (m-values) of events from one LRM (Linear Referencing Method) to another. The output is a new feature class.

This tool brings 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 event layers that are registered with an ArcGIS Pipeline Referencing network.

  • Supports temporal segmentation (time slicing). This will occur by default and can be overridden by creating a time-based definition query or applying a selection set to the inputs.

  • This tool can translate events from and to regular networks and networks that support lines, including events that span routes.

  • 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.

  • To identify matching behavior used during the translation, a field called Loc_Error is created containing values such as Multi-Match, Partial Match, No Match, and No Error. Route ID, measure, and date fields from the source event layer are also included and are prefixed with src_.

Syntax

TranslateEventMeasures_locref (in_source_event, in_target_route_features, out_target_event, {in_concurrent_route_matching})
ParameterExplanationData Type
in_source_event

The source event layer to be translated.

Feature Layer
in_target_route_features

The route network to which the source events will be translated.

Feature Layer
out_target_event

The translated event to be created.

Feature Class
in_concurrent_route_matching
(Optional)

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.

  • ANYThe source event is translated against the first of the concurrent routes at the source event location in the target network.
  • ROUTE_IDThe RouteID of the source event is compared to the RouteIDs of concurrent routes at the source event location in the target network. The source event will translate based on RouteIDs matching in the source event and target network. The RouteIDs of the source event and target network must be an exact match for this method to correctly translate the event.
  • ALLThe source event is translated against all the concurrent routes at that location in the target network.
String

Code sample

TranslateEventMeasures example 1 (Python window)

The following Python window script demonstrates how to use the TranslateEventMeasures tool in immediate mode in ArcGIS Pro.

# tool variables
in_source_event = "Test Pressure Range"
in_target_route_features = "Station Series Network"
out_target_event = "Test_Pressure_Range_Station_Series"
in_concurrent_route_matching = "ANY"

# set current workspace
arcpy.env.workspace = "C:/Data/Outputs.gdb"

# execute the tool
arcpy.TranslateEventMeasures_locref(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)
TranslateEventMeasures example 2 (standalone script)

The following standalone script demonstrates how to use the TranslateEventMeasures tool in ArcGIS Pro.

# Name: TranslateEventMeasures_ex2.py
# Description: Translates the measures (m-values) of events from one LRM (Linear Referencing Method) to another. The output is a new event layer feature class.
# Requires: ArcGIS Pipeline Referencing
 
# Import arcpy module
import arcpy
 
# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Event = r"C:\Data\Pipeline_Data.gdb\Pressure"
Network = r"C:\Data\Pipeline_Data.gdb\StationSeries"
Output = r"C:\Data\Pipeline_Data.gdb\Pressure_Transform"
Concurrency = "ANY"

# Process: Translate Event Measures
arcpy.TranslateEventMeasures_locref(Event, Network, Output, Concurrency)

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • ArcGIS Desktop Basic: Requires ArcGIS Pipeline Referencing
  • ArcGIS Desktop Standard: Requires ArcGIS Pipeline Referencing
  • ArcGIS Desktop Advanced: Requires ArcGIS Pipeline Referencing

Related topics