生成校准点 (位置参考工具)

汇总

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

用法

运行此工具需要 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"

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

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

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

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

环境

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

特殊情况

并行处理因子: The default value for this environment, if left blank, is 0%. Any absolute value for the environment is always clamped between 0 and the number of logical cores in that machine.

许可信息

基本: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
标准: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
高级: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）

生成校准点 (位置参考工具)

汇总

用法

参数

派生输出

环境

特殊情况

许可信息

相关主题