标注 | 说明 | 数据类型 |
源事件图层 | 要转换的输入事件图层。 | Feature Layer |
输入目标路径要素 | 要将输入事件转换到的目标 LRS 网络。 | Feature Layer |
输出事件图层 | 包含转换后事件要素的输出要素类。 | Feature Class |
并发路径匹配 (可选) | 指定此方法,该方法在当目标 LRS 网络中存在并发路径时用于确定使用哪个路径来转换事件。 仅当目标 LRS 网络上的事件转换位置存在并发路径(共享同一位置的路径)时,才应用此参数。
| String |
适用于 Location Referencing 许可。
摘要
可将点或线事件图层的测量值(m 值)从一种线性参考方法 (LRM) 转换为另一种。
该工具的一个用法示例是将事件数据从基于英里的网络转换为基于公里的网络。
除了测量值之外,两个 LRM 之间的事件要素的路径关联也可能不同。 此工具的输出是具有目标 LRS 网络的正确测量值和路径关联的要素类。
使用情况
输入事件图层必须是点或线要素类。
此工具不会修改任一输入,而是会创建一个要素类作为输出。
此工具支持每次使用一种时间表示。 在运行此工具之前,创建基于时间的定义查询,或将基于时间的选项集应用于输入事件图层以及目标 LRS 网络。 如果两个输入层都配置了时间,也可以使用 ArcGIS Pro 中的时间滑块。
此工具支持针对有间距的路径进行事件转换。
如果目标网络是 LRS 线网络,也称之为工程网络,即使输入事件图层的原始网络不支持线的概念,也可以转换输入事件图层。
输出要素类类型(线或点)必须匹配输入事件图层类型。
输入事件图层的容差和分辨率设置应与目标 LRS 网络的设置相匹配。
为了识别在转换过程中出现的匹配条件,在输出要素类中创建了一个名为 Loc_Error 的字段,其中包含 Multi-Match、Partial Match 、No Match 和 No Error 等值。
输出要素类中将包含输入事件图层的属性字段。
如果目标 LRS 网络包含并发路径,请使用并发路径匹配选项。
如果使用路径 ID 匹配路径与并发路径匹配一起使用,则输入事件层必须在 ArcGIS Location Referencing 中注册为 LRS 事件图层。
此工具将在目标 LRS 网络上执行输入事件图层的空间叠加,以沿目标网络生成输入事件的要素。 这些要素将包含路径上该位置的路线 ID 和测量信息。
输入事件图层和目标网络应该只代表一个时间点,才能获得准确的输出。 如果输入事件图层表示多个时间点,请使用时间滑块设置过滤器或对日期列使用定义查询。
可以使用追加事件工具将输出数据添加到新的或现有的 LRS 事件中。 如果输入事件图层包含多个时间表示,并导致使用不同的日期过滤器多次运行此工具,则可以使用追加事件将每个输出分别添加到单个 LRS 事件要素类。
参数
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, {in_concurrent_route_matching})
名称 | 说明 | 数据类型 |
in_source_event | 要转换的输入事件图层。 | Feature Layer |
in_target_route_features | 要将输入事件转换到的目标 LRS 网络。 | Feature Layer |
out_target_event | 包含转换后事件要素的输出要素类。 | Feature Class |
in_concurrent_route_matching (可选) | 指定此方法,该方法在当目标 LRS 网络中存在并发路径时用于确定使用哪个路径来转换事件。 仅当目标 LRS 网络上的事件转换位置存在并发路径(共享同一位置的路径)时,才应用此参数。
| String |
代码示例
以下 Python 窗口脚本演示了如何在 ArcGIS Pro 的即时模式下使用 TranslateEventMeasures 工具。
# Name: TranslateEventMeasures_ex1.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
# Set current workspace
arcpy.env.workspace = r"C:\Data\Outputs.gdb"
# Tool variables
in_source_event = "TestPressureRange"
in_target_route_features = "StationSeriesNetwork"
out_target_event = "Test_Pressure_Range_Station_Series"
in_concurrent_route_matching = "ANY"
# Execute the tool
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)
以下独立脚本演示了如何在 ArcGIS Pro 中使用 TranslateEventMeasures 工具。
# 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:
in_source_event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure"
in_target_route_features = r"C:\Data\Pipeline_Data.gdb\LRS\StationSeries"
out_target_event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure_Transform"
in_concurrent_route_matching = "ANY"
# Process: Translate Event Measures
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)
# Check in license
arcpy.CheckInExtension('LocationReferencing')
以下独立脚本演示了如何在要素服务中使用 TranslateEventMeasures 工具。
# 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.
in_source_event = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/31"
in_target_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/53"
# Set tool variables
out_target_event = r"C:\Data\LocationReferencing.gdb\outputevent"
in_concurrent_route_matching = "ANY"
# Process: Translate Event Measures.
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)
# Check in license
arcpy.CheckInExtension('LocationReferencing')
环境
许可信息
- Basic: 需要 ArcGIS Location Referencing(ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways)
- Standard: 需要 ArcGIS Location Referencing(ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways)
- Advanced: 需要 ArcGIS Location Referencing(ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways)