创建 LRS 网络 (位置参考工具)

汇总

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

用法

输入工作空间必须包含 Location Referencing LRS。
如果输入工作空间包含多个 Location Referencing LRS，请使用下拉菜单来选择网络将注册到的 LRS。输入工作空间中的任何有效 LRS 都可以在 Python 脚本中输入。
LRS 网络名称不得超过 26 个字符，并且不能包含除下划线以外的任何特殊字符。
输出要素类的 x,y 分辨率、x,y 容差和 m 容差必须与 Location Referencing LRS 的分辨率和容差设置相匹配。
输出 LRS 网络的测量单位（m 单位）可以设置为空间参考以外的单位。
此工具的默认输出是不支持线路的 LRS 网络，以及不包含支持线路所需字段的要素类。要创建支持线的 LRS 网络，请选中包含字段以支持线参数并映射 LRS 线网络所需的其他字段。要创建 LRS 派生网络，请选中从线网络派生参数，并提供 LRS 派生网络将注册到的 LRS 线网络。
此工具将向内部元数据表添加信息，以将输出要素类注册为 LRS 网络要素类。
一次只能将一个要素类注册为一个 LRS 网络要素类。如果要素类已注册且该名称必须用作输出要素类名称，请删除要素类注册到的 LRS 网络。
输出要素类中的一个字段只能映射到一个 LRS 网络必填字段。
此工具的输出是一个 LRS 网络以及一个空的折线要素类，用于存储 LRS 网络的路径。
输出 LRS 网络和输出要素类的名称将与 LRS 网络名称参数定义的名称相同。

标注	说明	数据类型
输入位置	将包含新 LRS 网络的输入工作空间。工作空间必须为包含 Location Referencing LRS 的地理数据库。除了顶级地理数据库之外，还支持要素数据集作为有效路径。	Workspace; Feature Dataset
LRS 名称	要注册的新 LRS 网络的 LRS。该 LRS 必须与输入位置参数值位于同一地理数据库中。	String
LRS 网络名称	将创建的 LRS 网络的名称，以及将创建并注册到 LRS 网络的要素类的名称。 LRS 网络名称不得超过 26 个字符，并且不能包含除下划线以外的特殊字符。	String
路径 ID 字段	输出要素类中将映射为 LRS 网络路径 ID 的字段。字段类型派生自中心线序列表的 `RouteId` 字段，必须是字符串或 GUID 类型。	String
路径名称字段	输出要素类中将映射为 LRS 网络路径名称的字符串字段。	String
起始日期字段	输出要素类中的日期字段，将映射为 LRS 网络的开始日期。	String
结束日期字段	输出要素类中的日期字段，将映射为 LRS 网络的“结束日期”。	String
从线网络派生（可选）	指定是否将网络配置为 LRS 派生网络。选中—输出将是 LRS 派生网络和支持 LRS 派生网络的要素类。还必须提供线网络名称参数值。未选中—输出将不是 LRS 派生网络。这是默认设置。	Boolean
线网络名称（可选）	输出 LRS 派生网络将注册到的 LRS 线网络的名称。输入 LRS 线网络必须与输入位置参数值位于同一地理数据库中。此参数仅在选中从线网络派生参数时使用。	String
包含字段以支持线（可选）	指定是否将添加支持线的字段。选中—输出将是 LRS 线网络，并且输出要素类将包括支持线的字段。还必须提供线 ID 字段、线名称字段和线顺序字段参数值。未选中—输出将不是 LRS 线网络。这是默认设置。	Boolean
线路 ID 字段（可选）	输出要素类中将映射为 LRS 网络线 ID 的字段。此参数仅在选中包括字段以支持线参数时使用。字段类型派生自中心线序列表的 `RouteId` 字段，可以是正好 38 个字符的字符串，也可以是 GUID 字段类型。	String
线路名称字段（可选）	输出要素类中将映射为 LRS 网络线名称的字符串字段。此参数仅在选中包括字段以支持线参数时使用。	String
线路顺序字段（可选）	输出要素类中将映射为 LRS 网络线顺序的字段。此参数仅在选中包括字段以支持线参数时使用。该字段必须是长整型字段类型。	String
测量单位（可选）	指定将用于 LRS 网络的测量单位（m 单位）。英里（美制测量）—测量单位为英里。这是默认设置。英寸（美制测量）—测量单位为英寸。英尺（美制测量）—测量单位为英尺。码（美制测量）—测量单位为码。海里（美制测量）—测量单位为海里。英尺（国际）—测量单位将为国际英尺。法定英里—测量单位将为法定英里。毫米—测量单位为毫米。厘米—测量单位为厘米。米—测量单位将为米。千米—测量单位将为千米。分米—测量单位为分米。	String

派生输出

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

arcpy.locref.CreateLRSNetwork(in_path, lrs_name, network_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}, {measure_unit})

名称	说明	数据类型
in_path	将包含新 LRS 网络的输入工作空间。工作空间必须为包含 Location Referencing LRS 的地理数据库。除了顶级地理数据库之外，还支持要素数据集作为有效路径。	Workspace; Feature Dataset
lrs_name	要注册的新 LRS 网络的 LRS。该 LRS 必须与 `in_path` 参数值位于同一地理数据库中。	String
network_name	将创建的 LRS 网络的名称，以及将创建并注册到 LRS 网络的要素类的名称。 LRS 网络名称不得超过 26 个字符，并且不能包含除下划线以外的特殊字符。	String
route_id_field	输出要素类中将映射为 LRS 网络路径 ID 的字段。字段类型派生自中心线序列表的 `RouteId` 字段，必须是字符串或 GUID 类型。	String
route_name_field	输出要素类中将映射为 LRS 网络路径名称的字符串字段。	String
from_date_field	输出要素类中的日期字段，将映射为 LRS 网络的开始日期。	String
to_date_field	输出要素类中的日期字段，将映射为 LRS 网络的“结束日期”。	String
derive_from_line_network （可选）	指定是否将网络配置为 LRS 派生网络。 `DERIVE`—输出将是 LRS 派生网络和支持 LRS 派生网络的要素类。还必须提供 `line_network_name` 参数值。 `DO_NOT_DERIVE`—输出将不是 LRS 派生网络。这是默认设置。	Boolean
line_network_name （可选）	输出 LRS 派生网络将注册到的 LRS 线网络的名称。输入 LRS 线网络必须与 `in_path` 参数值位于同一地理数据库中。只能在将 `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 （可选）	输出要素类中将映射为 LRS 网络线 ID 的字段。只能在将 `include_fields_to_support_lines` 参数设置为 `INCLUDE` 时，才能使用此参数。字段类型派生自中心线序列表的 `RouteId` 字段，可以是正好 38 个字符的字符串，也可以是 GUID 字段类型。	String
line_name_field （可选）	输出要素类中将映射为 LRS 网络线名称的字符串字段。只能在将 `include_fields_to_support_lines` 参数设置为 `INCLUDE` 时，才能使用此参数。	String
line_order_field （可选）	输出要素类中将映射为 LRS 网络线顺序的字段。只能在将 `include_fields_to_support_lines` 参数设置为 `INCLUDE` 时，才能使用此参数。该字段必须是长整型字段类型。	String
measure_unit （可选）	指定将用于 LRS 网络的测量单位（m 单位）。 `MILES`—测量单位为英里。这是默认设置。 `INCHES`—测量单位为英寸。 `FEET`—测量单位为英尺。 `YARDS`—测量单位为码。 `NAUTICAL_MILES`—测量单位为海里。 `INTFEET`—测量单位将为国际英尺。 `INTMILES`—测量单位将为法定英里。 `MILLIMETERS`—测量单位为毫米。 `CENTIMETERS`—测量单位为厘米。 `METERS`—测量单位将为米。 `KILOMETERS`—测量单位将为千米。 `DECIMETERS`—测量单位为分米。	String

派生输出

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

代码示例

CreateLRSNetwork 示例 1（Python 窗口）

在 Python 窗口中使用 CreateLRSNetwork 工具创建 LRS 线网络。

# Name: CreateLRS_Line_Network_ex1.py
# Description: Creates an LRS Line Network with feet as the unit of measure.
# Requires: ArcGIS Location Referencing

# Tool variables
in_path = r"C:\UPDM_Data\LRS.gdb\LRS"
lrs_name = "LRS"
network_name = "LRSNetwork"
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"
measure_unit = "Meters"

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

# Run the tool
arcpy.locref.CreateLRSNetwork(in_path, lrs_name, network_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, measure_unit)

CreateLRSNetwork 示例 2（独立脚本）

使用 CreateLRSNetwork 工具作为独立的 Python 脚本来创建 LRS 网络。

# Name: CreateLRSNetwork_ex2.py
# Description: Creates an LRS Network with miles as the unit of measure.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Run the tool
arcpy.locref.CreateLRSNetwork(Input_Path, LRS_Name, Network_Name, Route_ID, Route_Name, From_Date, To_Date)

CreateLRSNetwork 示例 3（独立脚本）

使用 CreateLRSNetwork 工具作为独立的 Python 脚本来创建 LRS 线网络。

# Name: CreateLRS_Line_Network_ex3.py
# Description: Creates an LRS Line Network with feet as the unit of measure.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Local variables
Input_Path = r"C:\UPDM_Data\LRS.gdb\LRS"
LRS_Name = "LRS"
Network_Name = "EngineeringNetwork"
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"
Unit = "Feet"

# Run the tool
arcpy.locref.CreateLRSNetwork(Input_Path, LRS_Name, Network_Name, Route_ID, Route_Name, From_Date, To_Date, Derive, Derive_From, Line_Support, Line_ID, Line_Name, Line_Order, Unit)

CreateLRSNetwork 示例 4（独立脚本）

使用 CreateLRSNetwork 工具作为独立的 Python 脚本来创建 LRS 派生网络。

# Name: CreateLRS_Derived_Network_ex4.py
# Description: Creates an LRS Derived Network with miles as the unit of measure.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Run the tool
arcpy.locref.CreateLRSNetwork(Input_Path, LRS_Name, Network_Name, Route_ID, Route_Name, From_Date, To_Date, Derive, Derive_From)

环境

当前工作空间

许可信息

基本: 需要 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）

创建 LRS 网络 (位置参考工具)

汇总

用法

参数

派生输出

环境

许可信息

相关主题