生成校准点 (位置参考)

适用于 Location Referencing 许可。

摘要

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

使用情况

参数

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

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

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)

相关主题