转换事件测量值 (位置参考)

适用于 Location Referencing 许可。

摘要

可将点或线事件图层的测量值(m 值)从一种线性参考方法 (LRM) 转换为另一种。

该工具的一个用法示例是将事件数据从基于英里的网络转换为基于公里的网络。

除了测量值之外,两个 LRM 之间的事件要素的路径关联也可能不同。 此工具的输出是具有目标 LRS 网络的正确测量值和路径关联的要素类。

使用情况

  • 输入事件图层必须是点或线要素类。

  • 此工具不会修改任一输入,而是会创建一个要素类作为输出。

  • 此工具支持每次使用一种时间表示。 在运行此工具之前,创建基于时间的定义查询,或将基于时间的选项集应用于输入事件图层以及目标 LRS 网络。 如果两个输入层都配置了时间,也可以使用 ArcGIS Pro 中的时间滑块。

  • 此工具支持针对有间距的路径进行事件转换。

  • 如果目标网络是 LRS 线网络,也称之为工程网络,即使输入事件图层的原始网络不支持线的概念,也可以转换输入事件图层。

  • 输出要素类类型(线或点)必须匹配输入事件图层类型。

  • 输入事件图层的容差和分辨率设置应与目标 LRS 网络的设置相匹配。

  • 为了识别在转换过程中出现的匹配条件,在输出要素类中创建了一个名为 Loc_Error 的字段,其中包含 Multi-MatchPartial MatchNo MatchNo Error 等值。

  • 输出要素类中将包含输入事件图层的属性字段。

  • 如果目标 LRS 网络包含并发路径,请使用并发路径匹配选项。

  • 如果使用路径 ID 匹配路径并发路径匹配一起使用,则输入事件层必须在 ArcGIS Location Referencing 中注册为 LRS 事件图层。

  • 此工具将在目标 LRS 网络上执行输入事件图层的空间叠加,以沿目标网络生成输入事件的要素。 这些要素将包含路径上该位置的路线 ID 和测量信息。

  • 输入事件图层和目标网络应该只代表一个时间点,才能获得准确的输出。 如果输入事件图层表示多个时间点,请使用时间滑块设置过滤器或对日期列使用定义查询。

  • 可以使用追加事件工具将输出数据添加到新的或现有的 LRS 事件中。 如果输入事件图层包含多个时间表示,并导致使用不同的日期过滤器多次运行此工具,则可以使用追加事件将每个输出分别添加到单个 LRS 事件要素类。

参数

标注说明数据类型
源事件图层

要转换的输入事件图层。

Feature Layer
输入目标路径要素

要将输入事件转换到的目标 LRS 网络。

Feature Layer
输出事件图层

包含转换后事件要素的输出要素类。

Feature Class
并发路径匹配
(可选)

指定此方法,该方法在当目标 LRS 网络中存在并发路径时用于确定使用哪个路径来转换事件。 仅当目标 LRS 网络上的事件转换位置存在并发路径(共享同一位置的路径)时,才应用此参数。

  • 任一并发路径如果在目标 LRS 网络中找到两个或多个并发路径,将使用其中的第一个路径对输入事件图层进行转换。
  • 使用路径 ID 匹配路径将源事件的路径 ID 与目标 LRS 网络中并发路径的路径 ID 进行比较。 源事件将根据源事件和目标网络中的路径 ID 的匹配程度进行转换。 输入事件和目标 LRS 网络的路径 ID 必须完全匹配,此方法才能正确转换事件。 此外,输入事件图层必须是已注册的 LRS 事件,才能使用此方法。
  • 所有并发路径将针对目标 LRS 网络中该位置的所有并发路径对输入事件进行转换。
String

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 网络上的事件转换位置存在并发路径(共享同一位置的路径)时,才应用此参数。

  • ANY如果在目标 LRS 网络中找到两个或多个并发路径,将使用其中的第一个路径对输入事件图层进行转换。
  • ROUTE_ID将源事件的路径 ID 与目标 LRS 网络中并发路径的路径 ID 进行比较。 源事件将根据源事件和目标网络中的路径 ID 的匹配程度进行转换。 输入事件和目标 LRS 网络的路径 ID 必须完全匹配,此方法才能正确转换事件。 此外,输入事件图层必须是已注册的 LRS 事件,才能使用此方法。
  • ALL将针对目标 LRS 网络中该位置的所有并发路径对输入事件进行转换。
String

代码示例

TranslateEventMeasures 示例 1(Python 窗口)

以下 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)
TranslateEventMeasures 示例 2(独立脚本)

以下独立脚本演示了如何在 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 示例 3(独立脚本)

以下独立脚本演示了如何在要素服务中使用 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)

相关主题