生成路径 (位置参考)

适用于 Location Referencing 许可。

摘要

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

使用情况

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

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

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

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

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

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

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

旧版本：

建议不要使用事件位置更新的记录校准更改参数，因为该参数已不再受支持且无法使用。 但是为了脚本或模型的向后兼容性，仍会保留此参数。

参数

对话框

标注	说明	数据类型
输入路径要素	将为其重新生成路径形状并应用校准更改的 LRS 网络。	Feature Layer
事件位置更新的记录校准更改 (可选)	旧版本： 现在，已不再支持此参数。 提供的任何值都将被忽略。	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 (可选)	旧版本： 现在，已不再支持此参数。 提供的任何值都将被忽略。	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

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

# Local variables
in_route_features = "LineNetwork"

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

GenerateRoutes 示例 2（独立脚本）

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

# Name: GenerateRoutes_ex2.py
# Description: Re-creates shapes and applies calibration changes for route features in an LRS Network.
# Requires: 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'

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

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

GenerateRoutes 示例 3（独立脚本）

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

# Name: GenerateRoutes_Pro_Ex3.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 into 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_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

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

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