生成事件 (位置参考工具)

汇总

为注册到 LRS 网络的事件要素重新生成形状。

用法

运行此工具需要 LRS 数据集。
- 了解 ArcGIS Pipeline Referencing 中关于 LRS 数据模型的详细信息
- 了解有关在 ArcGIS Roads and Highways 中创建 LRS 数据集的详细信息
使用需要根据事件的路径和测量值重新生成要素的事件作为输入。
此工具支持冲突预防，并将尝试获取和转移锁。

了解有关 ArcGIS Pipeline Referencing 中的冲突预防或 ArcGIS Roads and Highways 中的冲突预防的详细信息。
为该工具启用冲突预防后，该工具生成的任何事件都将被锁定。
- 在默认版本中工作时，获取的锁会在工具完成后自动释放。
- 在授权版本中工作时，获得的锁将在工具完成后保持为发布状态。锁所有者必须发布或删除该版本才能释放锁。
- 当在授权版本中工作时，如果中断取消工具运行，则将获取锁，并且该锁将在工具完成后保持可释放状态。
当选中绕过路径 ID 和测量值字段为空的事件参数时，支持以下内容：
- 路径 ID 和测量值字段为空的事件要素的形状和属性保持不变。
- 该工具将提供一个文本文件，其中包含被绕过的事件要素。

标注	说明	数据类型
事件图层	将为其重新生成形状的事件。	Feature Layer
绕过路径 ID 和测量值字段为空的事件（可选）	指定是否绕过路径 ID 和测量值字段为空的事件要素。此参数仅在组合的 LRS 和公共设施网络部署中可用。选中—将绕过路径 ID 和测量值字段为空的事件要素。未选中—将不会绕过路径 ID 和测量值字段为空的事件要素。这是默认设置。	Boolean

标注

说明

数据类型

事件图层

将为其重新生成形状的事件。

Feature Layer

绕过路径 ID 和测量值字段为空的事件

（可选）

指定是否绕过路径 ID 和测量值字段为空的事件要素。

此参数仅在组合的 LRS 和公共设施网络部署中可用。

选中—将绕过路径 ID 和测量值字段为空的事件要素。
未选中—将不会绕过路径 ID 和测量值字段为空的事件要素。这是默认设置。

Boolean

派生输出

标注	说明	数据类型
输出事件图层	更新的事件要素图层。注: 此工具的验证结果将写入 ArcGIS Server 目录。默认情况下，此文件会在 10 分钟内自动清除，这可能不足以处理所有验证并将其写入正在运行 ArcGIS Pro 的工作站。对于较大的数据负载，建议您将最大文件期限调整为至少一小时。	Feature Layer
输出结果文件	详细说明工具所做更改的文本文件。	Text File

arcpy.locref.GenerateEvents(in_event_layer, {bypass_events_with_null_lrs_fields})

名称说明数据类型

名称	说明	数据类型
in_event_layer	将为其重新生成形状的事件。	Feature Layer
bypass_events_with_null_lrs_fields （可选）	指定是否绕过路径 ID 和测量值字段为空的事件要素。此参数仅在组合的 LRS 和公共设施网络部署中可用。 `BYPASS_EVENTS_WITH_NULL_LRS_FIELDS`—将绕过路径 ID 和测量值字段为空的事件要素。 `NO_BYPASS_EVENTS_WITH_NULL_LRS_FIELDS`—将不会绕过路径 ID 和测量值字段为空的事件要素。这是默认设置。	Boolean

in_event_layer

将为其重新生成形状的事件。

Feature Layer

bypass_events_with_null_lrs_fields

（可选）

指定是否绕过路径 ID 和测量值字段为空的事件要素。

此参数仅在组合的 LRS 和公共设施网络部署中可用。

BYPASS_EVENTS_WITH_NULL_LRS_FIELDS—将绕过路径 ID 和测量值字段为空的事件要素。
NO_BYPASS_EVENTS_WITH_NULL_LRS_FIELDS—将不会绕过路径 ID 和测量值字段为空的事件要素。这是默认设置。

Boolean

派生输出

名称	说明	数据类型
out_event_layers	更新的事件要素图层。注: 此工具的验证结果将写入 ArcGIS Server 目录。默认情况下，此文件会在 10 分钟内自动清除，这可能不足以处理所有验证并将其写入正在运行 ArcGIS Pro 的工作站。对于较大的数据负载，建议您将最大文件期限调整为至少一小时。	Feature Layer
out_details_file	详细说明工具所做更改的文本文件。	Text File

代码示例

GenerateEvents 示例 1（Python 窗口）

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

arcpy.env.workspace = r"C:\Data\Demo.gdb"

arcpy.locref.GenerateEvents("Event1", "NO_BYPASS_EVENTS_WITH_NULL_LRS_FIELDS")

GenerateEvents 示例 2（独立脚本）

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

# Name: GenerateEvents_Ex2.py
# Description: Re-creates shapes for event features registered with an LRS Network
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Generate Events tool variables
in_event_layer = r"C:\Data\Sample.gdb\LRS\SpeedLimit"

# Do not bypass event features with null route ID and measure fields
bypass_events_with_null_lrs_fields = "NO_BYPASS_EVENTS_WITH_NULL_LRS_FIELDS"

# Run the tool
arcpy.locref.GenerateEvents(in_event_layer, bypass_events_with_null_lrs_fields)

GenerateEvents 示例 3（独立脚本）

以下 Python 脚本演示了如何在要素服务的独立 Python 脚本中使用 GenerateEvents 函数。

# Name: GenerateEvents_Ex3.py
# Description: Generate events in stand-alone mode using a feature service. It is recommended to work in a version and post it into the default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Input event is in feature service. Portal signin is required to access the feature service
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the input event from the feature service. Here, 3 corresponds to the input event
in_event_layer = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/3"

# Do not bypass event features with null route ID and measure fields
bypass_events_with_null_lrs_fields = "NO_BYPASS_EVENTS_WITH_NULL_LRS_FIELDS"

# Run the tool
arcpy.locref.GenerateEvents(in_event_layer, bypass_events_with_null_lrs_fields)

环境

当前工作空间

许可信息

基本: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
标准: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
高级: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）

生成事件 (位置参考工具)

汇总

用法

参数

派生输出

注:

环境

许可信息

相关主题