生成校准点 (位置参考)

适用于 Location Referencing 许可。

摘要

为所提供的任何路径形状生成校准点,包括自闭合、自相交和分支路径等复杂形状。

使用情况

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

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

  • 输入折线要素参数值是生成校准点的基础。

  • 校准点要素类参数值必须在 LRS 中注册。

  • LRS 网络参数值必须向 LRS 注册。

  • 不支持将派生 LRS 网络作为 LRS 网络参数值。

  • 计算中心线的几何长度时会考虑 Z 值。

  • 使用校准方法参数的几何长度属性字段选项生成校准点时,将遵循间隙校准规则。

    了解有关ArcGIS Roads and Highways 中校准具有物理间隙的路径ArcGIS Pipeline Referencing 中校准具有物理间隙的路径的更多信息。

  • 如果校准方法参数设置为路径上的 M,则将使用输入路径的起始顶点和结束顶点处的 m 值来创建开始和结束校准点。

  • 如果校准方法参数设置为属性字段,则将执行以下操作:

    • 属性字段选项将用于评估具有双精度字段类型的字段以进行校准。
    • 将使用测量始于字段参数值提供路径的测量始于值,将使用测量止于字段参数值提供路径的测量止于值。
  • 输入折线要素参数值可以是不具有线性参考功能的要素服务图层。 如果校准点要素类参数值是要素服务图层,则它必须启用线性参考功能。

参数

标注说明数据类型
输入折线要素

将用作计算校准点测量值的源的要素。

Feature Layer
路径 ID 字段

包含可唯一识别每条路径的值的字段。 字段类型必须与校准点要素类中的 Route ID 字段匹配。

Field
开始日期字段

包含路径的开始日期值的字段。

Field
结束日期字段

包含路径的结束日期值的字段。

Field
校正点要素类

要添加新要素的现有校准点要素类。

Feature Layer
LRS 网络

需要在校准点要素类中生成测量值的 LRS 网络。

String
校准方向
(可选)

指定创建校准点时在路径上增加校准的方向。

  • 数字化方向单个折线要素的数字化方向决定了路径的校准方向。 这是默认设置。
  • 测量方向单个折线要素的 m 值增加方向决定了路径的校准方向。如果单个折线要素不包括 m 值,则将使用数字化方向。
String
校准方法
(可选)

指定在创建校准点时用于确定路径上的测量值的方法。

  • 几何长度输入路径要素的几何长度将用作校准方法。 这是默认设置。
  • 路径上的 M输入路径要素上的测量值将用作校准方法。
  • 属性字段存储在输入路径要素属性字段中的测量值将用作校准方法。
String
测量始于字段
(可选)

包含所选路径的测量始于值的字段。

当将校准方法参数设置为属性字段时,此参数处于活动状态。

Field
测量止于字段
(可选)

包含所选路径的测量止于值的字段。

当将校准方法参数设置为属性字段时,此参数处于活动状态。

Field

派生输出

标注说明数据类型
已更新校正点要素类

已更新的校准要素。

Feature Layer
输出详细信息文件

详细说明工具所做更改的文本文件。

Text File

arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, {calibration_direction}, {calibration_method}, {from_measure_field}, {to_measure_field})
名称说明数据类型
in_polyline_features

将用作计算校准点测量值的源的要素。

Feature Layer
route_id_field

包含可唯一识别每条路径的值的字段。 字段类型必须与校准点要素类中的 Route ID 字段匹配。

Field
from_date_field

包含路径的开始日期值的字段。

Field
to_date_field

包含路径的结束日期值的字段。

Field
in_calibration_point_feature_class

要添加新要素的现有校准点要素类。

Feature Layer
lrs_network

需要在校准点要素类中生成测量值的 LRS 网络。

String
calibration_direction
(可选)

指定创建校准点时在路径上增加校准的方向。

  • DIGITIZED_DIRECTION单个折线要素的数字化方向决定了路径的校准方向。 这是默认设置。
  • MEASURE_DIRECTION单个折线要素的 m 值增加方向决定了路径的校准方向。如果单个折线要素不包括 m 值,则将使用数字化方向。
String
calibration_method
(可选)

指定在创建校准点时用于确定路径上的测量值的方法。

  • GEOMETRY_LENGTH输入路径要素的几何长度将用作校准方法。 这是默认设置。
  • M_ON_ROUTE输入路径要素上的测量值将用作校准方法。
  • ATTRIBUTE_FIELDS存储在输入路径要素属性字段中的测量值将用作校准方法。
String
from_measure_field
(可选)

包含所选路径的测量始于值的字段。

当将 calibration_method 参数设置为 ATTRIBUTE_FIELDS 时,此参数处于启用状态。

Field
to_measure_field
(可选)

包含所选路径的测量止于值的字段。

当将 calibration_method 参数设置为 ATTRIBUTE_FIELDS 时,此参数处于启用状态。

Field

派生输出

名称说明数据类型
out_calibration_point_feature_class

已更新的校准要素。

Feature Layer
out_details_file

详细说明工具所做更改的文本文件。

Text File

代码示例

GenerateCalibrationPoints 示例 1(Python 窗口)

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

# Name: GenerateCalibrationPoints_ex1.py
# Description: Build calibration point features when an LRS already exists in the geodatabase in Python window.
# Requires: ArcGIS Location Referencing

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

# Generate Calibration Points tool variables:
in_polyline_features = "SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = "Calibration_Point"
lrs_network = "NonLineNetwork"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Execute Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, calibration_direction, calibration_method)
GenerateCalibrationPoints 示例 2(独立脚本)

以下独立脚本演示了如何使用 GenerateCalibrationPoints 函数。

# Name: GenerateCalibrationPoints_ex2.py
# Description: Build calibration point features when an LRS already exists in the geodatabase in a stand-alone script.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Generate Calibration Points tool variables:
in_polyline_features = r"C:\Data\SourceData.gdb\LRS\SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = r"C:\\Data\UPDM.gdb\LRS\Calibration_Point"
lrs_network = "EngineeringNetwork"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Process: Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, calibration_direction, calibration_method)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
GenerateCalibrationPoints 示例 3(独立脚本)

以下独立脚本演示了如何使用 GenerateCalibrationPoints 函数将校准点构建到现有要素服务中。

# Name: GenerateCalibrationPoints_ex3.py
# Description: Build calibration point features in an existing feature service in a stand-alone script.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

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

# Generate Calibration Points tool variables:
in_polyline_features = r"C:\Data\SourceData.gdb\LRS\SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Map the LRS Network and Calibration Point feature class from the feature service. Here, 5 corresponds to the LRS Network and 1 corresponds to the Calibration Point feature class.
lrs_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/5"
in_calibration_point_feature_class = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Process: Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, calibration_direction, calibration_method)
                                                         
## 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)

相关主题