启用参考字段 (位置参考)

摘要

启用或修改参考字段，这样您可以管理已注册 LRS 事件的参考信息。

了解有关事件参考字段的详细信息

使用情况

• 此工具通过允许您将现有字段注册为参考字段来启用参考字段。

• 如果已启用参考字段，则该工具将默认填充现有字段，以对其进行修改。

• 启用或修改参考字段时，不会验证或更新参考字段中的现有数据。

• 要禁用参考字段，请使用禁用参考字段工具。

参数

对话框

标注	说明	数据类型
事件要素类	将用于 LRS 事件的要素类。	Feature Layer
参考方法字段 (可选)	自参考方法字段。	Field
参考位置字段 (可选)	自参考位置字段。	Field
参考偏移字段 (可选)	自参考偏移字段。	Field
至参考方法字段 (可选)	至参考方法字段。	Field
至参考位置字段 (可选)	至参考位置字段。	Field
至参考偏移字段 (可选)	至参考偏移字段。	Field
偏移单位 (可选)	指定将使用的偏移测量单位。 英里(美制测量)—测量单位为英里。 这是默认设置。 英寸(美制测量)—测量单位为英寸。 英尺(美制测量)—测量单位为英尺。 码(美制测量)—测量单位为码。 海里(美制测量)—测量单位为海里。 英尺(国际)—测量单位将为国际英尺。 法定英里—测量单位将为法定英里。 毫米—测量单位为毫米。 厘米—测量单位为厘米。 米—测量单位将为米。 千米—测量单位将为千米。 分米—测量单位为分米。	String

派生输出

标注	说明	数据类型
输出事件要素类	更新的事件要素图层。	Feature Layer

Python

arcpy.locref.EnableReferentFields(in_feature_class, {from_referent_method_field}, {from_referent_location_field}, {from_referent_offset_field}, {to_referent_method_field}, {to_referent_location_field}, {to_referent_offset_field}, {offset_units})

名称	说明	数据类型
in_feature_class	将用于 LRS 事件的要素类。	Feature Layer
from_referent_method_field (可选)	自参考方法字段。	Field
from_referent_location_field (可选)	自参考位置字段。	Field
from_referent_offset_field (可选)	自参考偏移字段。	Field
to_referent_method_field (可选)	至参考方法字段。	Field
to_referent_location_field (可选)	至参考位置字段。	Field
to_referent_offset_field (可选)	至参考偏移字段。	Field
offset_units (可选)	指定将使用的偏移测量单位。 MILES—测量单位为英里。 这是默认设置。 INCHES—测量单位为英寸。 FEET—测量单位为英尺。 YARDS—测量单位为码。 NAUTICAL_MILES—测量单位为海里。 INTFEET—测量单位将为国际英尺。 INTMILES—测量单位将为法定英里。 MILLIMETERS—测量单位为毫米。 CENTIMETERS—测量单位为厘米。 METERS—测量单位将为米。 KILOMETERS—测量单位将为千米。 DECIMETERS—测量单位为分米。	String

派生输出

名称	说明	数据类型
out_feature_class	更新的事件要素图层。	Feature Layer

代码示例

EnableReferentFields 示例 1（Python 窗口）

以下 Python 脚本演示了如何在即时模式下使用 EnableReferentFields 函数来启用现有 LRS 事件的参考字段。

# Name: Enable_Referent_Fields_ex1.py
# Description: Enable referent fields for an existing LRS Event that already has referent fields configured.
# Requires: ArcGIS Location Referencing

# Local variables:
inputEventFC = r"C:\EnableReferent\Py\EnableReferent.gdb\LRS\Event_Feature_Class"
fromReferentMethodField = "FromRefMethod"
fromReferentLocationField = "FromRefLocation"
fromReferentOffsetField = "FromRefOffset"
toReferentMethodField = "ToRefMethod"
toReferentLocationField = "ToRefLocation"
toReferentOffsetField = "ToRefOffset"
offsetUnit = "FEET"

# Execute the tool
arcpy.locref.EnableReferentFields(inputEventFC, fromReferentMethodField, fromReferentLocationField,
                                  fromReferentOffsetField, toReferentMethodField, toReferentLocationField,
                                  toReferentOffsetField, offsetUnit)

EnableReferentFields 示例 2（独立脚本）

以下独立 Python 脚本演示了如何使用 EnableReferentFields 函数来启用现有 LRS 事件的参考字段。

# Name: Enable_Referent_Fields_ex2.py
# Description: Enables referent fields for an existing LRS Event.
# Requires: ArcGIS Pipeline Referencing

# Import arcpy module
import arcpy

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

# Local variables
inputEventFC = r"C:\EnableReferent\Py\EnableReferent.gdb\LRS\Event_Feature_Class"
fromReferentMethodField = "FromRefMethod"
fromReferentLocationField = "FromRefLocation"
fromReferentOffsetField = "FromRefOffset"
toReferentMethodField = "ToRefMethod"
toReferentLocationField = "ToRefLocation"
toReferentOffsetField = "ToRefOffset"
offsetUnit = "FEET"

# Execute the tool
arcpy.locref.EnableReferentFields(inputEventFC, fromReferentMethodField, fromReferentLocationField,
                                  fromReferentOffsetField, toReferentMethodField, toReferentLocationField,
                                  toReferentOffsetField, offsetUnit)

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

EnableReferentFields 示例 3（独立脚本）

以下独立 Python 脚本演示了如何使用 EnableReferentFields 函数来修改包含已配置参考字段的现有 LRS 事件的参考字段。

# Name: Enable_Referent_Fields_ex3.py
# Description: Modifies  referent fields for an existing LRS Event that already has referent fields configured.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local variables:
inputEventFC = r"C:\EnableReferent\Py\EnableReferent.gdb\LRS\Event_Feature_Class"
toReferentMethodField = "ToRefMethod2"
toReferentLocationField = "ToRefLocation2"
toReferentOffsetField = "ToRefOffset2"

# Execute the tool
arcpy.locref.EnableReferentFields(inputEventFC, '', '', '', toReferentMethodField, toReferentLocationField, toReferentOffsetField, '')

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