生成路径 (位置参考)

适用于 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

arcpy.locref.GenerateRoutes(in_route_features, {record_calibration_changes})
名称说明数据类型
in_route_features

将为其重新生成路径形状并应用校准更改的 LRS 网络。

Feature Layer
record_calibration_changes
(可选)

指定是否会应用事件行为。

  • RECORD_CALIBRATION_CHANGESLocation 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)

相关主题