创建 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 网络名称参数定义的名称相同。

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

参数

标注说明数据类型
输入位置

将包含新 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 线网络必须与 line_network_name 值位于同一地理数据库工作空间中。 只能在将 derive_from_line_network 参数设置为 DERIVE 时,才能使用此参数。

String
include_fields_to_support_lines
(可选)

指定是否将添加支持线的字段。

  • INCLUDE输出将是 LRS 线网络,并且输出要素类将包括支持线的字段。 还必须提供 line_id_fieldline_name_fieldline_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测量单位为国际英尺。
  • 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

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

# 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 = "C:\UPDM_Data\LRS.gdb"

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

# Check in license
arcpy.CheckInExtension('LocationReferencing')
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
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

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

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

# Check in license
arcpy.CheckInExtension('LocationReferencing')
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
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

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

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

# Check in license
arcpy.CheckInExtension('LocationReferencing')
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
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

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

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

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

相关主题