基于现有数据集创建 LRS 网络 (位置参考)

适用于 Location Referencing 许可。

摘要

使用现有折线要素类创建 LRS 网络。

使用情况

• 在 ArcGIS Location Referencing 线性参考系统 (LRS) 中创建 LRS 网络。

• 输入要素类必须为空且位于包含 LRS 数据集的要素数据集中。 输入要素类不得已注册到现有 Location Referencing LRS 网络。

• 如果输入工作空间中包含多个 LRS，则所选 LRS 将用于网络注册。

• 输入要素类名称不得超过 26 个字符。

• 输入要素类的 x,y 分辨率和 x,y 容差必须与 Location Referencing LRS 的分辨率和容差设置相匹配。

  了解有关 ArcGIS Pipeline Referencing 中 LRS 的容差和分辨率设置以及 ArcGIS Roads and Highways 中容差和分辨率设置的更多信息。

• 输出 LRS 网络的测量单位和 m 容差将通过输入要素类工作空间内的中心线要素类的空间参考派生。

• 默认情况下，该工具将输出不支持线的 LRS 网络。 要创建支持线的 LRS 网络，请启用包含字段以支持线参数并映射 LRS 线网络所需的其他字段（线 ID、线名称和线顺序）。 要创建 LRS 派生网络，请启用从线网络派生参数，并提供 LRS 派生网络将注册到的 LRS 线网络。

• 此工具不会更改输入要素类，而是将信息添加到内部元数据表中，以将输入要素类注册为 LRS 网络要素类。

• 一个要素类一次只能注册为一个 LRS 网络要素类。 要使用已注册的要素类，请删除该要素类注册到的 LRS 网络。

• 一个输入字段一次只能映射到一个 LRS 网络字段参数。

• 此工具的输出为一个 LRS 网络，该网络将与输入要素类位于同一工作空间中。

• 路径 ID 可以是单个字段，也可以是多个字段的串联。 如果网络使用串联路径 ID，则构成路径 ID 的所有字段都必须存在于网络要素类中。

• 使用企业级地理数据库作为此工具的输入时，当前数据库用户不能为 SDE 或 DBO。

参数

对话框

标注	说明	数据类型
LRS 网络要素类	将注册为 LRS 网络的输入要素类。 要素类的名称不得超过 26 个字符。 要素类必须位于包含有 Pipeline Referencing LRS 的地理数据库中。 此要素类的名称将用作 LRS 网络的名称。	Feature Layer
LRS 名称	要注册的新 LRS 网络的 LRS 名称。 该 LRS 必须与 LRS 网络要素类位于同一地理数据库中。	String
路径 ID 字段	LRS 网络要素类中将映射为 LRS 网络路径 ID 的字段。 该字段必须是字符串或 GUID 字段类型。	Field
“路径名称”字段	LRS 网络要素类中将映射为 LRS 网络路径名称的字符串字段。	Field
开始日期字段	LRS 网络要素类中将映射为 LRS 网络开始日期的日期字段。	Field
结束日期字段	LRS 网络要素类中将映射为 LRS 网络结束日期的日期字段。	Field
从线网络派生 (可选)	指定是否将网络配置为 LRS 派生网络。 选中 - 此工具的输出将为 LRS 派生网络。 还必须提供线网络名称参数。 未选中 - 此工具的输出将不是 LRS 派生网络。 这是默认设置。	Boolean
线网络名称 (可选)	输出 LRS 派生网络将注册到的 LRS 线网络的名称。 该输入 LRS 线网络必须与 LRS 网络要素类位于同一地理数据库工作空间中。 此参数仅在选中从线网络派生参数时使用。	String
包含字段以支持线 (可选)	指定是否将网络配置为支持线。 选中 - 此工具的输出将为 LRS 线网络。 还必须提供线 ID 字段、线名称字段和线顺序字段参数。 未选中 - 此工具的输出将不是 LRS 线网络。 这是默认设置。	Boolean
线 ID 字段 (可选)	LRS 网络要素类中将映射为 LRS 网络线 ID 的字段。 此参数仅在选中包括字段以支持线参数时使用。 必须使用字符串或 GUID 字段类型，并且必须与中心线序列表中路径 ID 字段的字段类型和长度相匹配。 线 ID 字段参数输入的字段类型也必须与路径 ID 字段参数输入的相同。	Field
线名称字段 (可选)	LRS 网络要素类中将映射为 LRS 网络线名称的字符串字段。 此参数仅在选中包括字段以支持线参数时使用。	Field
线顺序字段 (可选)	LRS 网络要素类中将映射为 LRS 网络线顺序的整型字段。 此参数仅在选中包括字段以支持线参数时使用。 该字段必须是长整型字段类型。	Field
路径 ID 字段配置 (可选)	指定 LRS 网络的路径 ID 配置。 自动生成的路径 ID—路径 ID 字段是一个自动生成的 GUID。 路径名称可以配置为 LRS 字段。 这是默认设置。 单字段路径 ID—路径 ID 字段是由用户生成的单个字段。 仅支持非线网络。 多字段路径 ID—路径 ID 字段是由用户生成的字段，由多个字段串联组成。 仅支持非线网络。	String
字段 (可选)	LRS 网络要素类中用于组成路径 ID 的各个字段。 此参数仅在路径 ID 字段配置参数设置为多字段路径 ID 时使用。 字段必须是字符串或整型字段类型。	Field

派生输出

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

Python

arcpy.locref.CreateLRSNetworkFromExistingDataset(in_feature_class, lrs_name, route_id_field, route_name_field, from_date_field, to_date_field, {derive_from_line_network}, {line_network_name}, {include_fields_to_support_lines}, {line_id_field}, {line_name_field}, {line_order_field}, {route_id_configuration}, {individual_route_id_fields})

名称	说明	数据类型
in_feature_class	将注册为 LRS 网络的输入要素类。 要素类的名称不得超过 26 个字符。 要素类必须位于包含有 Pipeline Referencing LRS 的地理数据库中。 此要素类的名称将用作 LRS 网络的名称。	Feature Layer
lrs_name	要注册的新 LRS 网络的 LRS 名称。 该 LRS 必须与 in_feature_class 位于同一地理数据库中。	String
route_id_field	in_feature_class 中将映射为 LRS 网络路径 ID 的字段。 该字段必须是字符串或 GUID 字段类型。	Field
route_name_field	in_feature_class 中将映射为 LRS 网络路径名称的字符串字段。	Field
from_date_field	in_feature_class 中将映射为 LRS 网络开始日期的日期字段。	Field
to_date_field	in_feature_class 中将映射为 LRS 网络结束日期的日期字段。	Field
derive_from_line_network (可选)	指定是否将网络配置为 LRS 派生网络。 DERIVE—此工具的输出将为 LRS 派生网络。 还必须提供 line_network_name 参数。 DO_NOT_DERIVE—此工具的输出将不是 LRS 派生网络。 这是默认设置。	Boolean
line_network_name (可选)	输出 LRS 派生网络将注册到的 LRS 线网络的名称。 该输入 LRS 线网络必须与 in_feature_class 位于同一地理数据库工作空间中。 仅当 derive_from_line_network 参数值为 DERIVE 时，使用此参数。	String
include_fields_to_support_lines (可选)	指定是否将网络配置为支持线。 INCLUDE—此工具的输出将为 LRS 线网络。 同时还必须提供 line_id_field、line_name_field 和 line_order_field 参数。 DO_NOT_INCLUDE—此工具的输出将不是 LRS 线网络。 这是默认设置。	Boolean
line_id_field (可选)	in_feature_class 中将映射为 LRS 网络线 ID 的字段。 仅当 include_fields_to_support_lines 参数值为 INCLUDE 时，使用此参数。 必须使用字符串或 GUID 字段类型，并且必须与中心线序列表中路径 ID 字段的字段类型和长度相匹配。	Field
line_name_field (可选)	in_feature_class 中将映射为 LRS 网络线名称的字符串字段。 仅当 include_fields_to_support_lines 参数值为 INCLUDE 时，使用此参数。	Field
line_order_field (可选)	in_feature_class 中将映射为 LRS 网络线顺序的整型字段。 仅当 include_fields_to_support_lines 参数值为 INCLUDE 时，使用此参数。	Field
route_id_configuration (可选)	指定 LRS 网络的路径 ID 配置。 AUTOGENERATED_ROUTE_ID—路径 ID 字段是一个自动生成的 GUID。 路径名称可以配置为 LRS 字段。 这是默认设置。 SINGLE_FIELD_ROUTE_ID—路径 ID 字段是由用户生成的单个字段。 仅支持非线网络。 MULTI_FIELD_ROUTE_ID—路径 ID 字段是由用户生成的字段，由多个字段串联组成。 仅支持非线网络。	String
individual_route_id_fields [individual_route_id_fields,...] (可选)	in_feature_class 中用于组成路径 ID 的各个字段。 仅当 route_id_configuration 参数值为 MULTI_FIELD_ROUTE_ID 时，使用此参数。 字段必须是字符串或整型字段类型。	Field

派生输出

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

代码示例

CreateLRSNetworkFromExistingDataset 示例 1（Python 窗口）

使用 Python 窗口中的 CreateLRSNetworkFromExistingDataset 工具从现有折线要素类创建 LRS 线网络。

# Name: Create_LRS_Event_From_Existing_Dataset_ex1.py
# Description: Create an LRS Line Network in the Python window.
# Requires: ArcGIS Location Referencing 

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

# Tool variables
in_feature_class = r"C:\UPDM_Data\LRS.gdb\LRS\LRSNetwork"
lrs_name = "LRS"
route_id_field = "RouteId"
route_name_field = "RouteName"
from_date_field = "FromDate"
to_date_field = "ToDate"
derive_from_line_network = "DO_NOT_DERIVE"
line_network_name = ""
include_fields_to_support_lines = "INCLUDE"
line_id_field = "LineId"
line_name_field = "LineName"
line_order_field = "LineOrder"

# Set current workspace
arcpy.env.workspace = "C:\UPDM_Data\LRS.gdb"
 
# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(in_feature_class, lrs_name, route_id_field, route_name_field,
                                                 from_date_field, to_date_field, derive_from_line_network,
                                                 line_network_name, include_fields_to_support_lines, line_id_field,
                                                 line_name_field, line_order_field)
                                                 

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

CreateLRSNetworkFromExistingDataset 示例 2（独立脚本）

使用独立 Python 脚本中的 CreateLRSNetworkFromExistingDataset 工具从现有折线要素类创建 LRS 网络。

# Name: CreateLRSNetworkFromExisting_ex2.py
# Description: Create an LRS Network from an existing polyline feature class.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Input_FC = r"C:\UPDM_Data\LRS.gdb\LRS\LRSNetwork"
LRS_Name = "LRS"
Route_ID = "RouteId"
Route_Name = "RouteName"
From_Date = "FromDate"
To_Date = "ToDate"

# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(Input_FC, LRS_Name, Route_ID, Route_Name, From_Date, To_Date)

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

CreateLRSNetworkFromExistingDataset 示例 3（独立脚本）

使用独立 Python 脚本中的 CreateLRSNetworkFromExistingDataset 工具从现有折线要素类创建 LRS 线网络。

# Name: CreateLRS_Line_NetworkFromExisting_ex3.py
# Description: Create an LRS Line Network from an existing polyline feature class.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Input_FC = r"C:\UPDM_Data\LRS.gdb\LRS\EngineeringNetwork"
LRS_Name = "LRS"
Route_ID = "RouteId"
Route_Name = "RouteName"
From_Date = "FromDate"
To_Date = "ToDate"
Derive = "DO_NOT_DERIVE"
Derive_From = ""
Line_Support = "INCLUDE"
Line_ID = "LineId"
Line_Name = "LineName"
Line_Order = "LineOrder"

# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(Input_FC, LRS_Name, Route_ID, Route_Name, From_Date, To_Date, Derive,
                                                 Derive_From, Line_Support, Line_ID, Line_Name, Line_Order)

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

CreateLRSNetworkFromExistingDataset 示例 4（独立脚本）

使用独立 Python 脚本中的 CreateLRSNetworkFromExistingDataset 工具从现有折线要素类创建 LRS 派生网络。

# Name: CreateLRS_Derived_NetworkFromExisting_ex4.py
# Description: Create an LRS Derived Network from an existing polyline feature class.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Input_FC = r"C:\UPDM_Data\LRS.gdb\LRS\DerivedNetwork"
LRS_Name = "LRS"
Route_ID = "RouteId"
Route_Name = "RouteName"
From_Date = "FromDate"
To_Date = "ToDate"
Derive = "DERIVE"
Derive_From = "EngineeringNetwork"

# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(Input_FC, LRS_Name, Route_ID, Route_Name, From_Date, To_Date, Derive, Derive_From)

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

CreateLRSNetworkFromExistingDataset 示例 5（Python 窗口）

使用 Python 窗口中的 CreateLRSNetworkFromExistingDataset 工具从现有折线要素类创建一个由用户定义的单字段路径 ID。

# Name: CreateLRSNetworkFromExisting_ex5.py
# Description: Create a user-defined, single-field route ID in an LRS Network.
# Requires: ArcGIS Location Referencing

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

# Tool variables
in_feature_class = r"C:\UPDM_Data\LRS.gdb\LRS\LRSNetwork"
lrs_name = "LRS"
route_id_field = "RouteId"
route_name_field = ""
from_date_field = "FromDate"
to_date_field = "ToDate"
derive_from_line_network = ""
line_network_name = ""
include_fields_to_support_lines = ""
line_id_field = ""
line_name_field = ""
line_order_field = ""
route_id_configuration = "SINGLE_FIELD_ROUTE_ID"
individual_route_id_fields = ""

# Set current workspace
arcpy.env.workspace = "C:\UPDM_Data\LRS.gdb"

# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(in_feature_class, lrs_name, route_id_field, route_name_field, from_date_field, to_date_field, derive_from_line_network, line_network_name, include_fields_to_support_lines, line_id_field, line_name_field, line_order_field, route_id_configuration, Individual_route_id_fields)

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

CreateLRSNetworkFromExistingDataset 示例 6（Python 窗口）

使用 Python 窗口中的 CreateLRSNetworkFromExistingDataset 工具从现有折线要素类创建一个由用户定义的多字段路径 ID。

# Name: CreateLRSNetworkFromExisting_ex6.py
# Description: Create a user-defined, single-field route ID in an LRS Network.
# Requires: ArcGIS Location Referencing

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

# Tool variables
in_feature_class = r"C:\UPDM_Data\LRS.gdb\LRS\LRSNetwork"
lrs_name = "LRS"
route_id_field = "RouteId"
route_name_field = ""
from_date_field = "FromDate"
to_date_field = "ToDate"
derive_from_line_network = ""
line_network_name = ""
include_fields_to_support_lines = ""
line_id_field = ""
line_name_field = ""
line_order_field = ""
route_id_configuration = "MULTI_FIELD_ROUTE_ID"
individual_route_id_fields = "Field1;Field2;Field3"

# Set current workspace
arcpy.env.workspace = "C:\UPDM_Data\LRS.gdb"

# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(in_feature_class, lrs_name, route_id_field, route_name_field, from_date_field, to_date_field, derive_from_line_network, line_network_name, include_fields_to_support_lines, line_id_field, line_name_field, line_order_field, route_id_configuration, Individual_route_id_fields)

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

CreateLRSNetworkFromExistingDataset 示例 7（独立脚本）

使用 Python 窗口中的 CreateLRSNetworkFromExistingDataset 工具从现有折线要素类创建一个由用户定义的单字段路径 ID 网络。

# Name: CreateLRSNetworkFromExisting_ex7.py
# Description: Create a user defined, single-field route ID in an LRS Network from an existing polyline feature class.
# Requires: ArcGIS Location Referencing

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

# Local variables:
Input_FC = r"C:\UPDM_Data\LRS.gdb\LRS\LRSNetwork "
LRS_Name = "LRS"
Route_ID = "RouteID"
Route_Name = ""
From_Date = "FromDate"
To_Date = "ToDate"
Derive = ""
Derive_From = ""
Line_Support = ""
Line_ID = ""
Line_Name = ""
Line_Order = ""
route_id_configuration = "SINGLE_FIELD_ROUTE_ID"
individual_route_id_fields = ""

# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(Input_FC, LRS_Name, Route_ID, Route_Name, From_Date, To_Date, Derive, Derive_From, Line_Support, Line_ID, Line_Name, Line_Order, route_id_configuration, individual_route_id_fields)

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

CreateLRSNetworkFromExistingDataset 示例 8（独立脚本）

使用 Python 窗口中的 CreateLRSNetworkFromExistingDataset 工具从现有折线要素类创建一个由用户定义的多字段路径 ID 网络。

# Name: CreateLRSNetworkFromExisting_ex8.py
# Description: Create a user defined, multifield route ID network from an existing polyline feature class.
# Requires: Location Referencing

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

# Local variables:
Input_FC = r"C:\UPDM_Data\LRS.gdb\LRS\LRSNetwork"
LRS_Name = "LRS"
Route_ID = "RouteID"
Route_Name = ""
From_Date = "FromDate"
To_Date = "ToDate"
Derive = ""
Derive_From = ""
Line_Support = ""
Line_ID = ""
Line_Name = ""
Line_Order = ""
route_id_configuration = "MULTI_FIELD_ROUTE_ID"
individual_route_id_fields = "Field1;Field2;Field3"

# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(Input_FC, LRS_Name, Route_ID, Route_Name, From_Date, To_Date, Derive, Derive_From, Line_Support, Line_ID, Line_Name, Line_Order, route_id_configuration, individual_route_id_fields)

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

环境

当前工作空间

许可信息

• Basic: 需要 ArcGIS Location Referencing
• Standard: 需要 ArcGIS Location Referencing
• Advanced: 需要 ArcGIS Location Referencing