融合路径事件 (线性参考)

摘要

用于将冗余信息从事件表中移除,或将包含多个描述性属性的事件表分解为单独的表。

使用情况

  • 输入表可以是 ArcGIS 支持的任何类型的表。 输出表可以是 .dbf 文件或地理数据库表。

  • 如果输入事件表参数值不包含 ObjectID 字段,请在使用此工具添加虚拟 ObjectID 字段之前使用生成查询表工具。

  • 路径标识符字段上的属性索引可加快动态分段过程的速度。 如果将使用输出事件表参数值进行动态分段,建议创建属性索引。

参数

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

该表包含将要进行聚合的行。

Table View
事件表属性

输入事件表中的路径位置字段和事件类型。

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

用于聚合行的字段。

Field
输出事件表

要创建的表。

Table
输出事件表属性

将写入输出事件表的路径位置字段和事件类型。

  • 路径标识符字段 - 该字段将包含指示每个事件所在路径的值。 此字段可以是数值、文本或 GUID 字段。
  • 事件类型 - 输出事件表中将包含的事件类型(PointLine)。
    • Point - 点事件出现在沿路径的确切点位置处。 仅可指定只有单一测量字段
    • Line - 线事件定义路径的一部分。 “测量始于”和“测量止于”都是必须指定的字段。
  • 测量始于字段 - 将包含测量值的字段。 当事件类型是 PointLine 时,此字段为必填字段。 在事件类型值为 Point 时,此参数的标注将变为测量字段
  • 测量止于字段 - 将包含测量值的字段。 当事件类型是 Line 时,此字段为必填字段。
Route Measure Event Properties
仅合并相邻事件
(可选)

指定输入事件的聚合方式。

  • 未选中 - 只要存在测量值重叠就聚合事件。 这是默认设置。
  • 选中 - 仅在一个事件的“测量止于”与下一事件的“测量始于”相匹配时聚合事件。 此选项仅适用于线事件。
Boolean
构建索引
(可选)

指定是否为写入输出事件表的路径标识符字段创建属性索引。

  • 选中 - 将创建属性索引。 这是默认设置。
  • 未选中 - 不会创建属性索引。
Boolean

arcpy.lr.DissolveRouteEvents(in_events, in_event_properties, dissolve_field, out_table, out_event_properties, {dissolve_type}, {build_index})
名称说明数据类型
in_events

该表包含将要进行聚合的行。

Table View
in_event_properties

输入事件表中的路径位置字段和事件类型。

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

用于聚合行的字段。

Field
out_table

要创建的表。

Table
out_event_properties

将写入输出事件表的路径位置字段和事件类型。

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

指定输入事件的聚合方式。

  • DISSOLVE只要存在测量值重叠就聚合事件。 这是默认设置。
  • CONCATENATE仅在一个事件的“测量止于”与下一事件的“测量始于”相匹配时聚合事件。 此选项仅适用于线事件。
Boolean
build_index
(可选)

指定是否为写入输出事件表的路径标识符字段创建属性索引。

  • INDEX将创建属性索引。 这是默认设置。
  • NO_INDEX不会创建属性索引。
Boolean

代码示例

DissolveRouteEvents 示例 1(Python 窗口)

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


import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.DissolveRouteEvents("pavecond.dbf", "rkey LINE fmp tmp", "lanes", 
                             "pave_dissolve1.dbf", "rkey LINE fmp tmp")
DissolveRouteEvents 示例 2(独立脚本)

以下 Python 脚本演示了如何在独立 Python 脚本中使用 DissolveRouteEvents 函数。

# Name: DissolveRouteEvents_Example2.py
# Description: Dissolve line events based on one field (input table is dBASE).

# Import system modules 
import arcpy

# Set workspace
arcpy.env.workspace = "D:/Data/pitt_county"

# Set local variables
in_tbl = "pavecond.dbf"
in_props = "rkey LINE fmp tmp"  # re-used as out event properties
flds = "lanes" 
out_tbl = "pave_dissolve1.dbf"

# Run DissolveRouteEvents
arcpy.lr.DissolveRouteEvents(in_tbl, in_props, flds, out_tbl, in_props)
DissolveRouteEvents 示例 3(独立脚本)

以下 Python 脚本演示了如何在独立 Python 脚本中使用 DissolveRouteEvents 函数。

# Name: DissolveRouteEvents_Example3.py
# Description: Concatenate line events based on two fields (input table is file geodatabase).

# Import system modules
import arcpy

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

# Set local variables
in_tbl = "pavecond"
in_props = "rkey LINE fmp tmp"  # re-used as out event properties
flds = "lanes;curb" 
out_tbl = "pave_dissolve2"

# Run DissolveRouteEvents
arcpy.lr.DissolveRouteEvents(in_tbl, in_props, flds, out_tbl, in_props, 
                             "CONCATENATE")
DissolveRouteEvents 示例 4(独立脚本)

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

# Name: DissolveRouteEvents_Example4.py
# Description: Dissolve line events based on two fields (input table is enterprise geodatabase).

# Import system modules
import arcpy

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

# Set local variables
in_tbl = arcpy.ValidateTableName("pavecond", wkspc) 
in_props = "rkey LINE fmp tmp" 
flds = "lanes;curb" 
out_tbl = "pave_dissolve3"
out_props = "rid LINE f_meas t_meas" 

# Run DissolveRouteEvents
arcpy.lr.DissolveRouteEvents(in_tbl, in_props, flds, out_tbl, out_props, "#", 
                             "NO_INDEX")

许可信息

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

相关主题