| Etiqueta | Explicación | Tipo de datos |
Source Event Layer | The input event layer to be translated. | Feature Layer |
Input Target Route Features | The target LRS Network against which the input events will be translated. | Feature Layer |
Output Event Layer | The output feature class that will contain the translated event features. | Feature Class |
Concurrent Route Matching
(Opcional) | Specifies the method used to determine which route to translate the event against when concurrent routes exist in the target LRS Network. This parameter is only applied when the location of the event translation on the target LRS Network has concurrent routes (routes that share a location).
| String |
Disponible con licencia de Location Referencing.
Resumen
Translates the measures (m-values) of a point or line event layer from one linear referencing method (LRM) to another.
A use case for this tool would be to translate event data from a mile-based network to a kilometer-based network.
In addition to measures, the route associations of the event features may also be different between the two LRMs. The output of this tool is a feature class with the correct measures and route associations of the target LRS Network.
Uso
The input event layer must be a point or line feature class.
This tool does not modify either input and will create a feature class as an output.
This tool supports one temporal representation at a time. Create a time-based definition query or apply a time-based selection set to the input event layer as well as the target LRS Network before running this tool. The time slider in ArcGIS Pro can also be used if time is configured for both of the input layers.
This tool supports translating events against routes with gaps.
If the target network is an LRS line network, also known as an engineering network, the input event layer can be translated even if the original network of the input event layer does not support the concept of lines.
The output feature class type—line or point—must match the input event layer type.
The tolerance and resolution settings for the input event layer should match those of the target LRS Network.
To identify matching conditions that occur during the translation, a field called Loc_Error is created in the output feature class containing values such as Multi-Match, Partial Match, No Match, and No Error.
The attribute fields of the input event layer are included in the output feature class.
If the target LRS Network contains concurrent routes, use the Concurrent Route Matching option.
If Route with matching Route ID is used with Concurrent Route Matching, the input event layer must be registered as an LRS event layer in ArcGIS Location Referencing.
This tool will perform a spatial overlay of the input event layer onto the target LRS Network to generate features for the input event along the target network. These features will contain the Route ID and measure information of that location on the route.
The input event layer and the target network should only represent a single point in time to obtain an accurate output. If the input event layer represents multiple points in time, set a filter using the time slider or use a definition query on the date columns.
The output data can be added to a new or existing LRS event by using the Append Events tool. If the input event layer contained multiple temporal representations and resulted in running this tool multiple times with different date filters, each of the outputs can be added to a single LRS event feature class using Append Events.
Parámetros
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, {in_concurrent_route_matching})| Nombre | Explicación | Tipo de datos |
in_source_event | The input event layer to be translated. | Feature Layer |
in_target_route_features | The target LRS Network against which the input events will be translated. | Feature Layer |
out_target_event | The output feature class that will contain the translated event features. | Feature Class |
in_concurrent_route_matching (Opcional) | Specifies the method used to determine which route to translate the event against when concurrent routes exist in the target LRS Network. This parameter is only applied when the location of the event translation on the target LRS Network has concurrent routes (routes that share a location).
| String |
Muestra de código
The following Python window script demonstrates how to use the TranslateEventMeasures tool in immediate mode in ArcGIS Pro:
# Name: TranslateEventMeasures_ex2.py
# Description: Translate the measures (m-values) of events from one linear referencing method (LRM) to another. The output is a new event layer feature class.
# Requires: ArcGIS Location Referencing
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
# 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)
# Check in license
arcpy.CheckInExtension('LocationReferencing')The following stand-alone 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 linear referencing method (LRM) to another. The output is a new event layer feature class.
# Requires: ArcGIS Location Referencing
# Import arcpy module
import arcpy
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
# Local variables:
Event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure"
Network = r"C:\Data\Pipeline_Data.gdb\LRS\StationSeries"
Output = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure_Transform"
Concurrency = "ANY"
# Process: Translate Event Measures
arcpy.TranslateEventMeasures_locref(Event, Network, Output, Concurrency)
# Check in license
arcpy.CheckInExtension('LocationReferencing')The following stand-alone script demonstrates how to use the TranslateEventMeasures tool in a feature service:
# Name: TranslateEventMeasures_Pro_Ex3.py
# Description: Translate event measures in stand-alone mode using a feature service. It is recommended to work in a version and post to a default version.
# Requires: ArcGIS Location Referencing
# Import arcpy module.
import arcpy
# Check out the license
arcpy.CheckOutExtension("LocationReferencing")
# Input event and target LRS network are in feature service. Signing in portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')
# Map the input event and target LRS network from the feature service. Here, 53 corresponds to the target LRS network and 31 corresponds to source event.
source_event = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/31"
target_route_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/53"
# Set tool variables
output_event = r"C:\Data\LocationReferencing.gdb\outputevent"
concurrency = "ANY"
# Process: Translate Event Measures.
arcpy.TranslateEventMeasures_locref(source_event, target_route_network, output_event, concurrency)
# Check in license
arcpy.CheckInExtension('LocationReferencing')Información de licenciamiento
- Basic: Requiere ArcGIS Location Referencing
- Standard: Requiere ArcGIS Location Referencing
- Advanced: Requiere ArcGIS Location Referencing