生成路径 (位置参考)

适用于 Location Referencing 许可。

摘要

为 LRS 网络中的路径要素重新创建形状并应用校准更改。

此外，该工具可以确定路径上的校准变化，从而处理事件行为。 这些校准更改可能是由于在 ArcGIS Pro 中的位置参考工具外执行了添加、编辑或删除校准点操作。

使用情况

• 根据中心线要素类的路径形状和校准点要素类的测量值，输入需要重新生成要素或需要应用校准更改的 LRS 网络。

• 运行此工具需要 LRS 数据集。

  了解有关在 ArcGIS Pipeline Referencing 中创建 LRS 数据集或在 ArcGIS Roads and Highways 中创建 LRS 数据集的详细信息。

• 如果在 ArcGIS Pro 中的 ArcGIS Location Referencing 工具之外删除校准点或更改其日期，并在选中事件位置更新的记录校准更改参数的情况下运行生成路径，则删除校准点或更改其日期的区域内的所有事件都将移动事件行为，而不会固定不动。

• 如果使用线网络配置派生网络，则在线网络上运行生成路径也将更新派生网络。

• 派生网络中的路径是通过组合父线中的路径形状生成的。

• 为该工具启用冲突预防后，该工具生成的任何事件都将被锁定。

  • 在默认版本中工作时，获取的锁会在工具完成后自动释放。
  • 在子版本中工作时，获得的锁将在工具完成后保持为发布状态。 锁所有者必须发布或删除该版本才能释放锁。
  • 在子版本中工作时，如果中断取消工具，则将获取锁，并且该锁将在工具完成后保持在可释放状态。

• 此工具支持冲突预防，并将尝试获取和转移锁。

  了解有关 ArcGIS Pipeline Referencing 中的冲突预防或 ArcGIS Roads and Highways 中的冲突预防的详细信息。

参数

对话框

标注	说明	数据类型
输入路径要素	将为其重新生成路径形状并应用校准更改的 LRS 网络。	Feature Layer
事件位置更新的记录校准更改 (可选)	指定是否会应用事件行为。 选中 - 在 Location Referencing 工具之外创建、修改或删除的任何校准点都将应用于网络中的路径，并且事件行为将在下次运行应用事件行为时应用。 未选中 - 校准更改将应用于 LRS 网络中的路径，但不会应用任何事件行为。 这是默认设置。	Boolean

派生输出

标注	说明	数据类型
输出路径要素	更新的路径要素图层。	Feature Layer
输出派生路径要素	已生成路径形状并应用校准更改的更新 LRS 网络。	Feature Layer
输出结果文件	详细说明在 LRS 网络要素类中更新的路径的文本文件。	Text File

Python

arcpy.locref.GenerateRoutes(in_route_features, {record_calibration_changes})

名称	说明	数据类型
in_route_features	将为其重新生成路径形状并应用校准更改的 LRS 网络。	Feature Layer
record_calibration_changes (可选)	指定是否会应用事件行为。 RECORD_CALIBRATION_CHANGES—在 Location Referencing 工具之外创建、修改或删除的任何校准点都将应用于网络中的路径，并且事件行为将在下次运行应用事件行为时应用。 NO_RECORD_CALIBRATION_CHANGES—校准更改将应用于 LRS 网络中的路径，但不会应用任何事件行为。 这是默认设置。	Boolean

派生输出

名称	说明	数据类型
out_route_features	更新的路径要素图层。	Feature Layer
out_derived_route_features	已生成路径形状并应用校准更改的更新 LRS 网络。	Feature Layer
out_details_file	详细说明在 LRS 网络要素类中更新的路径的文本文件。	Text File

代码示例

GenerateRoutes 示例 1（Python 窗口）

演示了如何在即时模式下使用 GenerateRoutes 函数。

# Name: GenerateRoutes_ex1.py
# Description: Re-creates shapes and applies calibration changes for route features in an LRS Network.
# Requires: ArcGIS Location Referencing

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
record_calibration_changes = "NO_RECORD_CALIBRATION_CHANGES"

# Set current workspace
arcpy.env.workspace = "C:\Data\PipelineReferencing.gdb"

# Execute the tool
arcpy.locref.GenerateRoutes(in_route_features, record_calibration_changes)
arcpy.CheckInExtension('LocationReferencing')

GenerateRoutes 示例 2（独立脚本）

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

# Name: GenerateRoutes_ex2.py
# Description: Re-creates shapes and applies calibration changes for route features in an LRS Network.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
record_calibration_changes = "RECORD_CALIBRATION_CHANGES"

# Execute the tool
arcpy.locref.GenerateRoutes(in_route_features, record_calibration_changes)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

GenerateRoutes 示例 3（独立脚本）

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

# Name: GenerateRoutes_Pro_Ex3.py.py
# Description: Generate routes 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

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

## Input LRS route network is in feature service.  Signing in portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

## Map the input LRS route network from the feature service. Here, 1 corresponds to the input LRS route network.
in_route = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Process : Generate Routes.
arcpy.locref.GenerateRoutes(in_route)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

环境

当前工作空间, 并行处理因子

特殊情况

并行处理因子

此环境的默认值（如果留空）为 0%。 环境的任何绝对值将始终限制在 0 和该计算机中的逻辑核数之间。

许可信息

• 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）