创建 LRS (位置参考)

摘要

用于在指定工作空间中创建 ArcGIS Location Referencing 线性参考系统 (LRS) 和最小方案项目。

使用情况

• 创建的最小方案项目为中心线、中心线序列、校准点和红线要素类。

• LRS、中心线、校准点、红线以及中心线序列的名称必须唯一并且不能已存在于地理数据库中。

• 空间参考、容差和分辨率输入将应用于所有输出要素类。

• 如果输入位置为要素数据集，则要素数据集必须与工具输入的空间参考、容差和分辨率相匹配。

• x,y 和 z 容差必须至少为 x,y 和 z 分辨率的两倍。

参数

对话框

标注	说明	数据类型
输入位置	将在其中创建 LRS 和最小方案项目的文件地理数据库或企业级地理数据库。	Workspace; Feature Dataset
LRS 名称	输出 LRS 的名称。	String
中心线要素类名称	输出中心线要素类的名称。	String
校准点要素类名称	输出校准点要素类的名称。	String
红线要素类名称	输出红线要素类的名称。	String
中心线序列表名称	输出中心线序列表的名称。	String
空间参考	输出要素类的空间参考。 当使用 Python 脚本时，可以指定空间参考的熟知 ID (WKID)。	Spatial Reference
XY 容差 (可选)	输出要素类的 x,y 容差。	Linear Unit
Z 容差 (可选)	输出要素类的 z 容差。	Linear Unit
XY 分辨率 (可选)	输出要素类的 x,y 分辨率。	Linear Unit
Z 分辨率 (可选)	输出要素类的 z 分辨率。	Linear Unit

派生输出

标注	说明	数据类型
更新的输入位置	更新的 LRS 工作空间。	Workspace; Feature Dataset
输出中心线要素类	更新的中心线要素类。	Feature Class
输出校准点要素类	更新的校准点要素类。	Feature Class
输出红线要素类	更新的红线要素类。	Feature Class
输出中心线序列表	更新的中心线序列表。	Table

Python

arcpy.locref.CreateLRS(in_workspace, lrs_name, centerline_feature_class_name, calibration_point_feature_class_name, redline_feature_class_name, centerline_sequence_table_name, spatial_reference, {xy_tolerance}, {z_tolerance}, {xy_resolution}, {z_resolution})

名称	说明	数据类型
in_workspace	将在其中创建 LRS 和最小方案项目的文件地理数据库或企业级地理数据库。	Workspace; Feature Dataset
lrs_name	输出 LRS 的名称。	String
centerline_feature_class_name	输出中心线要素类的名称。	String
calibration_point_feature_class_name	输出校准点要素类的名称。	String
redline_feature_class_name	输出红线要素类的名称。	String
centerline_sequence_table_name	输出中心线序列表的名称。	String
spatial_reference	输出要素类的空间参考。 当使用 Python 脚本时，可以指定空间参考的熟知 ID (WKID)。	Spatial Reference
xy_tolerance (可选)	输出要素类的 x,y 容差。	Linear Unit
z_tolerance (可选)	输出要素类的 z 容差。	Linear Unit
xy_resolution (可选)	输出要素类的 x,y 分辨率。	Linear Unit
z_resolution (可选)	输出要素类的 z 分辨率。	Linear Unit

派生输出

名称	说明	数据类型
out_workspace	更新的 LRS 工作空间。	Workspace; Feature Dataset
out_centerline_feature_class	更新的中心线要素类。	Feature Class
out_calibration_point_feature_class	更新的校准点要素类。	Feature Class
out_redline_feature_class	更新的红线要素类。	Feature Class
out_centerline_sequence_table	更新的中心线序列表。	Table

代码示例

CreateLRS 示例 1（Python 窗口）

在 Python 窗口中使用 CreateLRS 函数。

# Name: Create_LRS_ex1.py
# Description: Create an LRS and minimum schema items (Centerline, Centerline Sequence, Calibration Point, Redline).
# Requires: ArcGIS Location Referencing

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

# Tool variables
in_workspace = r"C:/Data/PipelineData.gdb/"
lrs_name = "LRS"
centerline_feature_class_name = "Centerline"
calibration_point_feature_class_name = "Calibration_Point"
redline_feature_class_name = "Redline"
centerline_sequence_table_name = "Centerline_Sequence"
spatial_reference = "26111"
xy_tolerance = "0.01 Meters"
z_tolerance = "0.01 Meters"
xy_resolution = "0.001 Meters"
z_resolution = "0.001 Meters"

# Set current workspace
arcpy.env.workspace = "C:/Data/PipelineData.gdb"

# execute the tool
arcpy.locref.CreateLRS(in_workspace, lrs_name, centerline_feature_class_name, calibration_point_feature_class_name,
                       redline_feature_class_name, centerline_sequence_table_name, spatial_reference, xy_tolerance,
                       z_tolerance, xy_resolution, z_resolution)

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

CreateLRS 示例 2（独立脚本）

在独立 Python 脚本中使用 CreateLRS 函数。

# Name: Create_LRS_ex2.py
# Description: Create an LRS and minimum schema items (Centerline, Centerline Sequence, Calibration Point, Redline).
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local Variables
in_workspace = r"C:\Data\PipelineData.gdb"
lrs_name = "LRS"
centerline_feature_class_name = "Centerline"
calibration_point_feature_class_name = "CalibrationPoint"
redline_feature_class_name = "Redline"
centerline_sequence_table_name = "CenterlineSequence"
spatial_reference = "NAD83 Albers Equal Area, 48 States, Panhandle, US Foot"
xy_tolerance = "0.001 Feet"
z_tolerance = "0.001 Feet"
xy_resolution = "0.0001 Feet"
z_resolution = "0.0001 Feet"

arcpy.locref.CreateLRS(in_workspace, lrs_name, centerline_feature_class_name, calibration_point_feature_class_name,
                       redline_feature_class_name, centerline_sequence_table_name, spatial_reference, xy_tolerance,
                       z_tolerance, xy_resolution, z_resolution)

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

环境

当前工作空间

许可信息

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