返回顶部

生成 LRS 数据产品 (位置参考)

在本主题中

  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息

适用于 Location Referencing 许可。

摘要

转换 LRS 数据，生成 LRS 网络中选定路径的长度产品。 例如，您可以使用此工具根据县域边界汇总一组路径或线的总里程。

使用情况

  • 使用包含汇总字段和长度字段的 LRS 数据模板。 您可以使用管道或公路和高速公路的定位参考模板。

  • 汇总字段和长度字段必须与 LRS 网络图层位于同一地理数据库中。

  • 模板文件必须为 .json。

  • 输入路径要素参数应为网络要素类。

  • 此工具不会修改输入数据，输出将生成 .csv 文件。

  • 此工具支持选择和定义查询功能。

  • 生效日期参数用于确定网络的时态视图。 仅使用在该日期处于活动状态的路径进行输出计算。

  • 此工具支持单位转换，可以将网络的测量单位转换为其他单位。

  • 如果 .json 文件中未包含汇总字段，边界要素和汇总字段参数才有效。

  • 若网络中存在校准问题或长度为零的路径，选中排除空汇总行参数可将这些路径排除在输出之外。 否则，这些路径将以零长度包含在输出中。

参数

对话框Python

标注说明数据类型
模板

输入 LRS 数据模板用于指定汇总字段和长度字段。

File
输入路径要素

将用于计算长度的 LRS 网络。

Feature Layer
生效日期

定义网络时态视图的日期。

Date
长度单位

指定输出中长度字段的测量单位。

  • 英寸—将以英寸为单位。
  • 英尺—单位将为英尺。
  • 码—单位将为码。
  • 英里—单位将为英里。
  • 海里—单位将为海里。
  • 国际英里—单位将为国际英里。
  • 国际英尺—单位将为国际英尺。
  • 毫米—单位将为毫米。
  • 厘米—单位将为厘米。
  • 米—单位将为米。
  • 千米—单位将为千米。
  • 分米—单位将为分米。
String
边界要素
(可选)

用于汇总数据的边界图层。

Feature Layer
汇总字段
(可选)

提供汇总行名称的边界图层字段。

Field
排除空汇总行
(可选)

指定是否排除空的汇总行。

  • 选中 - 未校准或长度为零的路径将被排除。 这是默认设置。
  • 未选中 - 未校准或长度为零的路径不会被排除，它们将在输出中以 0 里程显示。
Boolean
输出格式
(可选)

指定输出文件格式。

  • CSV—输出文件将为 .csv。 这是默认设置。
String
输出文件
(可选)

计算的长度结果将写入输出 .csv 文件中。

File
输出表
(可选)

包含计算长度的表格。

Table

arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, {boundary_features}, {summary_field}, {exclude_null_summary_rows}, {output_format}, {out_file}, {out_table})
名称说明数据类型
in_template

输入 LRS 数据模板用于指定汇总字段和长度字段。

File
in_route_features

将用于计算长度的 LRS 网络。

Feature Layer
effective_date

定义网络时态视图的日期。

Date
units

指定输出中长度字段的测量单位。

  • INCHES—将以英寸为单位。
  • FEET—单位将为英尺。
  • YARDS—单位将为码。
  • MILES—单位将为英里。
  • NAUTICAL_MILES—单位将为海里。
  • INTMILES—单位将为国际英里。
  • INTFEET—单位将为国际英尺。
  • MILLIMETERS—单位将为毫米。
  • CENTIMETERS—单位将为厘米。
  • METERS—单位将为米。
  • KILOMETERS—单位将为千米。
  • DECIMETERS—单位将为分米。
String
boundary_features
(可选)

用于汇总数据的边界图层。

Feature Layer
summary_field
(可选)

提供汇总行名称的边界图层字段。

Field
exclude_null_summary_rows
(可选)

指定是否排除空的汇总行。

  • EXCLUDE—未校准或长度为零的路径将被排除。 这是默认设置。
  • DO_NOT_EXCLUDE—未校准或长度为零的路径不会被排除，它们将在输出中以 0 里程显示。
Boolean
output_format
(可选)

指定输出文件格式。

  • CSV—输出文件将为 .csv。 这是默认设置。
String
out_file
(可选)

计算的长度结果将写入输出 .csv 文件中。

File
out_table
(可选)

包含计算长度的表格。

Table

代码示例

GenerateLrsDataProduct 示例 1（独立脚本）

以下独立脚本演示了如何使用 GenerateLrsDataProduct 函数作为独立脚本。

# Name: GenerateLrsDataProduct_ex1.py
# Description: Transforms LRS data to create a Length product for the selected routes in an LRS Network in a stand-alone script.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")

# Local tool variables
in_template=r"C:\Data\Template.json"
in_route_features=r"C:\Data\SampleData.gdb\LRS\Network"
effective_date="06/03/2024"
units="METERS"
boundary_features = None
summary_field = None
exclude_null_summary_rows="EXCLUDE"
output_format="CSV"
out_file= r"C:\Data\LP1.csv"
out_table=None

# Run the tool
arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)

# Check in licenses
arcpy.CheckInExtension('LocationReferencing')
GenerateLrsDataProduct 示例 2（Python 窗口）

以下脚本演示了如何在 Python 窗口中使用 GenerateLrsDataProduct 函数。

# Name: GenerateLrsDataProduct_ex2.py
# Description: Transforms LRS data to create a Length product for the selected routes in an LRS Network in the inline Python window in ArcGIS Pro.
# Requirements: ArcGIS Location Referencing

# Local tool variables
in_template=r"C:\Data\Template.json"
in_route_features=r"C:\Data\SampleData.gdb\LRS\Network"
effective_date="06/03/2024"
units="METERS"
boundary_features = None
summary_field = None
exclude_null_summary_rows="DO_NOT_EXCLUDE"
output_format="CSV"
out_file= r"C:\Data\LP2.csv"
out_table=None

# Run the tool
arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)
GenerateLrsDataProduct 示例 3（独立脚本）

以下独立脚本演示了如何在要素服务中使用 GenerateLrsDataProduct 函数。

# Name: GenerateLrsDataProduct_Ex3.py
# Description: Transforms LRS data to create a Length product for the selected routes using a feature service.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

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

# Input event and target LRS network are in feature service.  Signing in portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the LRS network from the feature service. Here, 1 corresponds to the target LRS Network's layer ID.
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Set tool variables
in_template=r"C:\Data\Template.json"
effective_date="06/03/2024"
units="FEET"
boundary_features = None
summary_field = None
exclude_null_summary_rows="EXCLUDE"
output_format="CSV"
out_file= r"C:\Data\LP3.csv"
out_table=None

# Run the tool
arcpy.locref.GenerateLrsDataProduct (in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)

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

相关主题

  • 位置参考工具箱概览
  • 查找地理处理工具

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息