创建路径事件图层 (线性参考)

摘要

使用路径和路径事件创建临时要素图层。

如果使用临时图层（在地图上显示临时图层或由其他地理处理工具使用临时图层），则将执行动态分段。

使用情况

• 输入表可以是 ArcGIS 支持的任何类型的表。

• 在运行此工具之前，先对路径使用创建要素图层工具和/或对事件使用创建表视图工具，以降低要处理的路径和事件数。

• 并不是所有类型的表都有 Object ID 字段。 该工具在使用不含 Object ID 字段的表时，生成的图层将无法选择，也无法供某些地理处理操作有效使用。 在运行此工具之前，您可以使用创建查询表工具添加一个虚拟对象 ID 字段。

参数

对话框

标注	说明	数据类型
输入路径要素	用于定位事件的路径要素。	Feature Layer
路径标识符字段	包含可唯一识别每条路径的值的字段。 此字段可以是数值、文本或 GUID 字段。	Field
输入事件表	将沿路径定位行的表。	Table View
事件表属性	输入事件表中的路径位置字段和事件类型。 路径标识符字段 - 该字段包含指示每个事件所在路径的值。 此字段可以是数值、文本或 GUID 字段。 事件类型 - 输入事件表中的事件类型（Point 或 Line）。 Point - 点事件出现在沿路径的确切点位置处。 只有“测量始于”是必须指定的字段。 Line - 线事件定义路径的一部分。 “测量始于”和“测量止于”都是必须指定的字段。 测量始于字段 - 包含测量值的字段。 此字段必须是数值型字段，并且在事件类型是 Point 或 Line 时必填。 在事件类型值为 Point 时，此参数的标注将变为测量字段。 测量止于字段 - 包含测量值的字段。 此字段必须是数值字段，在事件类型是 Line 时必填。	Route Measure Event Properties
图层名称或表视图	将创建的图层。 此图层存储在内存中，所以不需要路径。	Feature Layer
偏移字段 (可选)	包含将用于使事件从其基础路径偏移的值的字段。 字段必须为数值。	Field
生成用于定位错误的字段 (可选)	指定是否将 LOC_ERROR 字段添加到创建的临时图层。 未选中 - 不会添加用于存储定位错误的字段。 这是默认设置。 选中 - 将添加用于存储定位错误的字段。	Boolean
生成角度字段 (可选)	指定是否将 LOC_ANGLE 字段添加到创建的临时图层。 此参数只有在事件类型为 Point 时才有效。 未选中 - 不会添加用于存储定位角度的字段。 这是默认设置。 选中 - 将添加用于存储定位角度的字段。	Boolean
计算的角度类型 (可选)	指定要计算的定位角的类型。 此参数仅在选中生成角度字段时才有效。 正态—将计算法向角（直角）。 这是默认设置。 正切—将计算正切角。	String
将余角写入角度字段 (可选)	指定是否入定位角的余角。 此参数仅在选中生成角度字段时才有效。 未选中 - 不会写入定位角的余角。 只写入计算的角度。 这是默认设置。 选中 - 将写入定位角的余角。	Boolean
具有正向偏移的事件将被放置在路径的右侧 (可选)	指定将具有正向偏移的路径事件显示在哪一侧。 此参数只有在已指定偏移字段时才有效。 未选中 - 具有正向偏移的事件显示在路径左侧。 路径的这一侧由测量方向而不一定由数字化方向确定。 这是默认设置。 选中 - 具有正向偏移的事件显示在路径右侧。 路径的这一侧由数字化方向确定。	Boolean
点事件将被生成为多点要素 (可选)	指定将点事件视为点要素还是多点要素。 未选中 - 将点事件视为点要素。 这是默认设置。 选中 - 将点事件视为多点要素。	Boolean

Python

arcpy.lr.MakeRouteEventLayer(in_routes, route_id_field, in_table, in_event_properties, out_layer, {offset_field}, {add_error_field}, {add_angle_field}, {angle_type}, {complement_angle}, {offset_direction}, {point_event_type})

名称	说明	数据类型
in_routes	用于定位事件的路径要素。	Feature Layer
route_id_field	包含可唯一识别每条路径的值的字段。 此字段可以是数值、文本或 GUID 字段。	Field
in_table	将沿路径定位行的表。	Table View
in_event_properties	输入事件表中的路径位置字段和事件类型。 路径标识符字段 - 该字段包含指示每个事件所在路径的值。 此字段可以是数值、文本或 GUID 字段。 事件类型 - 输入事件表中的事件类型（POINT 或 LINE）。 POINT - 点事件出现在沿路径的确切点位置处。 只有“测量始于”是必须指定的字段。 LINE - 线事件定义路径的一部分。 “测量始于”和“测量止于”都是必须指定的字段。 测量始于字段 - 包含测量值的字段。 此字段必须是数值字段，在事件类型是 POINT 或 LINE 时必填。 测量止于字段 - 包含测量值的字段。 此字段必须是数值字段，在事件类型是 LINE 时必填。	Route Measure Event Properties
out_layer	将创建的图层。 此图层存储在内存中，所以不需要路径。	Feature Layer
offset_field (可选)	包含将用于使事件从其基础路径偏移的值的字段。 字段必须为数值。	Field
add_error_field (可选)	指定是否将 LOC_ERROR 字段添加到创建的临时图层。 NO_ERROR_FIELD—不会添加用于存储定位错误的字段。 这是默认设置。 ERROR_FIELD—将添加用于存储定位错误的字段。	Boolean
add_angle_field (可选)	指定是否将 LOC_ANGLE 字段添加到创建的临时图层。 此参数只有在事件类型为 Point 时才有效。 NO_ANGLE_FIELD—不会添加用于存储定位角度的字段。 这是默认设置。 ANGLE_FIELD—将添加用于存储定位角度的字段。	Boolean
angle_type (可选)	指定要计算的定位角的类型。 仅当 add_angle_field = "ANGLE_FIELD" 时该参数有效。 NORMAL—将计算法向角（直角）。 这是默认设置。 TANGENT—将计算正切角。	String
complement_angle (可选)	指定是否入定位角的余角。 仅当 add_angle_field = "ANGLE_FIELD" 时该参数有效。 ANGLE—不会写入定位角的余角。 只写入计算的角度。 这是默认设置。 COMPLEMENT—将写入定位角的余角。	Boolean
offset_direction (可选)	指定将具有正向偏移的路径事件显示在哪一侧。 此参数只有在已指定偏移字段时才有效。 LEFT—具有正向偏移的事件显示在路径左侧。 路径的这一侧由测量方向而不一定由数字化方向确定。 这是默认设置。 RIGHT—具有正向偏移的事件显示在路径右侧。 路径的这一侧由数字化方向确定。	Boolean
point_event_type (可选)	指定将点事件视为点要素还是多点要素。 POINT—将点事件视为点要素。 这是默认设置。 MULTIPOINT—将点事件视为多点要素。	Boolean

代码示例

MakeRouteEventLayer 示例 1（Python 窗口）

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.MakeRouteEventLayer("route_hwy.shp", "rkey", "accident.dbf", 
                             "rkey POINT mile", "accident_events", "#", 
                             "ERROR_FIELD", "ANGLE_FIELD")

MakeRouteEventLayer 示例 2（独立脚本）

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

# Name: MakeRouteEventLayer_Example2.py
# Description:  Make a POINT event layer. Routes and events are in a shapefile workspace.
# An error field and an angle field are added to the new layer. The new layer can be used
# by other geoprocessing functions.

# Import system modules
import arcpy

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

# Set local variables
rt = "route_hwy.shp"
rid = "rkey" 
tbl = "accident.dbf"
props = "rkey POINT mile"
lyr = "accident_events" 

# Run MakeRouteEventLayer
arcpy.lr.MakeRouteEventLayer(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD", 
                             "ANGLE_FIELD")

MakeRouteEventLayer 示例 3（独立脚本）

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

# Name: MakeRouteEventLayer_Example3.py
# Description:  Make a LINE event layer. Routes and events are in a file geodatabase.
# An error field is added to the new layer. The new layer can be used by other 
# geoprocessing functions.

# Import system modules 
import arcpy

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

# Set local variables
rt = "roads/hwy"  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "pavecond"
props = "rkey LINE fmp tmp"
lyr = "pave_events" 

# Run MakeRouteEventLayer
arcpy.lr.MakeRouteEventLayer(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD")

MakeRouteEventLayer 示例 4（独立脚本）

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

# Name: MakeRouteEventLayer_Example4.py
# Description: Make a POINT event layer. Routes and events are in an enterprise geodatabase.
# The new layer can be used by other geoprocessing functions.

# Import system modules 
import arcpy

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

# Set local variables
ds = arcpy.ValidateTableName("roads", wkspc)  # the 'roads' feature dataset
fc = arcpy.ValidateTableName("hwy", wkspc)  # the 'hwy' feature class 
rt = ds + "/" + fc  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "accident"
props = "rkey POINT mile"
lyr = "accident_events2" 

# Run MakeRouteEventLayer
arcpy.lr.MakeRouteEventLayer(rt, rid, tbl, props, lyr)

环境

当前工作空间, 输出配置关键字, 临时工作空间

许可信息

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