转换路径事件 (线性参考)

摘要

将事件测量值从一种路径参考转换到另一种路径参考,并将其写入新事件表。

使用情况

  • 转换事件允许您将一种路径参考的事件与具有不同路径标识符和/或测量值的另一种路径参考的事件结合使用。

  • 任何与目标路径相交的完整或部分事件均写入新的事件表。

  • 在源路径与目标路径精确重叠时可取得最佳结果。

    警告:

    如果使用较大的拓扑容差参数值以克服源路径与目标路径之间的偏差,则可能产生意想不到的结果。

  • 事件类型线)必须匹配输入事件类型。

  • 在使用此工具之前先使用创建表视图工具有效降低要处理的事件数。

  • 可使用创建路径事件图层工具将输出表显示在地图中。

参数

标注说明数据类型
输入事件表

输入事件表。

Table View
事件表属性

输入事件表中由路径位置字段和事件类型组成的参数。

  • 路径标识符字段 - 该字段包含指示每个事件所在路径的值。 字段可以是数值或字符。
  • 事件类型 - 输入事件表中的事件类型(POINTLINE)。
    • POINT - 点事件出现在沿路径的确切点位置处。 只有“测量始于”是必须指定的字段。
    • LINE - 线事件定义路径的一部分。 “测量始于”和“测量止于”都是必须指定的字段。
  • 测量始于字段 - 包含测量值的字段。 此字段必须是数值型字段,并且在事件类型是 POINTLINE 时必填。 请注意,在事件类型POINT 时,此参数的标注将变为测量字段
  • 测量止于字段 - 包含测量值的字段。 此字段必须是数值字段,在事件类型是 LINE 时必填。
Route Measure Event Properties
源路径要素

输入路径要素。

Feature Layer
源路径标识符字段

包含可唯一识别每条输入路径的值的字段。

Field
目标路径要素

要将输入事件转换到的路径要素。

Feature Layer
目标路径标识符字段

包含可唯一识别每条目标路径的值的字段。

Field
输出事件表

要创建的表。

Table
输出事件表属性

由将写入输出事件表的路径位置字段和事件类型组成的参数。

  • 路径标识符字段 - 该字段将包含指示每个事件所在路径的值。
  • 事件类型 - 输出事件表中将包含的事件类型(POINTLINE)。
    • POINT - 点事件出现在沿路径的确切点位置处。 仅可指定只有单一测量字段
    • LINE - 线事件定义路径的一部分。 “测量始于”和“测量止于”都是必须指定的字段。
  • 测量始于字段 - 将包含测量值的字段。 此字段在事件类型是 POINTLINE 时必填。 请注意,在事件类型POINT 时,此参数的标注将变为测量字段
  • 测量止于字段 - 将包含测量值的字段。 此字段在事件类型是 LINE 时必填。
Route Measure Event Properties
聚类容差

输入事件与目标路径之间的最大容许距离。

Linear Unit
包括输入的所有字段
(可选)

指定输出事件表参数值是否包含路径位置字段以及输入事件的所有属性。

  • 选中 - 输出事件表参数值包含路径位置字段以及输入事件的所有属性。 这是默认设置。
  • 未选中 - 输出事件表参数值将只包含路径位置字段和输入事件的 ObjectID 字段。
Boolean

arcpy.lr.TransformRouteEvents(in_table, in_event_properties, in_routes, route_id_field, target_routes, target_route_id_field, out_table, out_event_properties, cluster_tolerance, {in_fields})
名称说明数据类型
in_table

输入事件表。

Table View
in_event_properties

输入事件表中由路径位置字段和事件类型组成的参数。

  • 路径标识符字段 - 该字段包含指示每个事件所在路径的值。 字段可以是数值或字符。
  • 事件类型 - 输入事件表中的事件类型(POINTLINE)。
    • POINT - 点事件出现在沿路径的确切点位置处。 只有“测量始于”是必须指定的字段。
    • LINE - 线事件定义路径的一部分。 “测量始于”和“测量止于”都是必须指定的字段。
  • 测量始于字段 - 包含测量值的字段。 此字段必须是数值型字段,并且在事件类型是 POINTLINE 时必填。 请注意,在事件类型POINT 时,此参数的标注将变为测量字段
  • 测量止于字段 - 包含测量值的字段。 此字段必须是数值字段,在事件类型是 LINE 时必填。
Route Measure Event Properties
in_routes

输入路径要素。

Feature Layer
route_id_field

包含可唯一识别每条输入路径的值的字段。

Field
target_routes

要将输入事件转换到的路径要素。

Feature Layer
target_route_id_field

包含可唯一识别每条目标路径的值的字段。

Field
out_table

要创建的表。

Table
out_event_properties

由将写入输出事件表的路径位置字段和事件类型组成的参数。

  • 路径标识符字段 - 该字段将包含指示每个事件所在路径的值。
  • 事件类型 - 输出事件表中将包含的事件类型(POINTLINE)。
    • POINT - 点事件出现在沿路径的确切点位置处。 仅可指定只有单一测量字段
    • LINE - 线事件定义路径的一部分。 “测量始于”和“测量止于”都是必须指定的字段。
  • 测量始于字段 - 将包含测量值的字段。 此字段在事件类型是 POINTLINE 时必填。 请注意,在事件类型POINT 时,此参数的标注将变为测量字段
  • 测量止于字段 - 将包含测量值的字段。 此字段在事件类型是 LINE 时必填。
Route Measure Event Properties
cluster_tolerance

输入事件与目标路径之间的最大容许距离。

Linear Unit
in_fields
(可选)

指定 out_table 参数值是否包含路径位置字段以及输入事件的所有属性。

  • FIELDSout_table 参数值将包含路径位置字段以及输入事件的所有属性。 这是默认设置。
  • NO_FIELDSout_table 参数值将仅包含路径位置字段以及输入事件的 ObjectID 字段。
Boolean

代码示例

TransformRouteEvents 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何使用 TransformRouteEvents 函数:

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.TransformRouteEvents("pavement.dbf", "route1 LINE begin_mp end_mp", 
                              "hwy.shp", "route1", "hwy_new.shp", "route1", 
                              "trans_out1.dbf", "route1 LINE fmp tmp", "0.1 meters")
TransformRouteEvents 示例 2(独立脚本)

以下 Python 脚本演示了如何在独立 Python 脚本中将 TransformRouteEvents 函数与文件地理数据库数据结合使用:

# Name: TransformRouteEvents_Example2.py
# Description: Transform point events (input table is in a file geodatabase)

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"

# Set local variables
in_tbl = "accident"
in_props = "route1 POINT measure"
in_rt = "roads/hwy"               # hwy exists in the roads feature dataset 
in_rid = "route1" 
target_rt = "roads/hwy_new"       # hwy_new exists in the roads feature dataset 
target_rid = "route1" 
out_tbl = "trans_out2"
out_props = "route1 POINT mp"
tol = "0.1 meters"  

# Run TransformRouteEvents
arcpy.lr.TransformRouteEvents(in_tbl, in_props, in_rt, in_rid, target_rt, 
                              target_rid, out_tbl, out_props, tol)
TransformRouteEvents 示例 3(独立脚本)

以下 Python 脚本演示了如何在独立 Python 脚本中将 TransformRouteEvents 函数与企业级地理数据库数据结合使用。

# Name: TransformRouteEvents_Example3.py
# Description: Transform point events (input table is in an enterprise geodatabase)

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"

# Set local variables
in_tbl = arcpy.ValidateTableName("accident", wkspc) 
in_props = "route1 POINT measure"
in_rt = arcpy.ValidateTableName("hwy", wkspc) 
in_rid = "route1" 
target_rt = arcpy.ValidateTableName("hwy_new", wkspc) 
target_rid = "route1" 
out_tbl = "trans_out3"
out_props = "route1 POINT mp"
tol = "0.1 meters"  

# Run TransformRouteEvents
arcpy.lr.TransformRouteEvents(in_tbl, in_props, in_rt, in_rid, target_rt, 
                              target_rid, out_tbl, out_props, tol)

许可信息

  • Basic: 是
  • Standard: 是
  • Advanced: 是

相关主题