返回顶部

创建路径 (线性参考)

在本主题中

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

摘要

根据现有的线创建路径。 合并共享通用标识符的输入线要素以创建单个路径。

使用情况

  • 将路径标识符字段参数值中的唯一值写入输出路径要素类。

  • 使用创建要素图层或创建查询表工具可减少将用于创建路径的线数。

  • 如果将输出路径要素类参数值写入地理数据库，则需设置适当的 M 容差、M 分辨率和 M 域环境。

  • 使用测量系数参数转换路径测量单位。 例如，要将英尺转换为英里，请使用系数 0.00018939394：

  • 在每条路径的起始测量值都需要非零值的应用中使用测量偏移参数值。

  • 当测量源参数指定为来自两个字段的值时，不使用忽略空间间隙参数。 这是因为测量值由测量始于字段和测量止于字段值指定。

  • 在使用要素长度或者来自单个字段测量源选项时，通过将最小外接矩形放置在要通过合并创建一条路径的输入要素周围来确定坐标优先级。

  • 当将测量源参数指定为来自两个字段的值选项时，不需要指定坐标优先级，因为测量方向由测量始于字段和测量止于参数中的值指明。

  • 路径标识符字段上的属性索引可加快动态分段过程的速度。 如果将使用输出路径要素类参数值进行动态分段，建议创建属性索引。

  • 若有任何要素被此工具拒绝，则在临时文件路径下创建一个文本文件以存储有关这些要素的信息，例如 C:\Users\patrickb\AppData\Local\Temp\Create_Output0.txt（其中，Create_Output 是输出路径要素类的名称）。

  • 输出包含 M 值环境设置将被忽略。 输出路径要素类参数值将包含 m 值（测量值）。

参数

对话框Python

标注说明数据类型
输入线要素

将创建路径的要素。

Feature Layer
路径标识符字段

包含可唯一识别每条路径的值的字段。 此字段可以是数值、文本或 GUID 字段。

Field
输出路径要素类

将要创建的要素类。 可以是 shapefile 或地理数据库要素类。

Feature Class
测量源

指定如何累积计算路径测量值。

  • 要素的长度—使用输入要素的几何长度累积测量值。 这是默认设置。
  • 值来自单个字段—使用单个字段中存储的值累积测量值。
  • 值来自两个字段—使用“测量始于字段”和“测量止于字段”中存储的值累积计算测量值。
String
测量始于字段
(可选)

包含测量值的字段。 此字段必须为数值，并且当测量源为来自单个字段的值或来自两个字段的值时必填。

Field
测量止于字段
(可选)

包含测量值的字段。 此字段必须为数值，并且当测量源为来自两个字段的值时必填。

Field
坐标优先级
(可选)

用于为每条输出路径累积测量值的位置。 当测量源为来自两个字段的值时，将忽略此参数。

  • 左上角—从最接近最小外接矩形左上角的点累积测量值。 这是默认设置。
  • 左下角—从最接近最小外接矩形左下角的点累积测量值。
  • 右上角—从最接近最小外接矩形右上角的点累积测量值。
  • 右下角—从最接近最小外接矩形右下角的点累积测量值。
String
测量系数
(可选)

合并输入线创建路径测量值之前，每条输入线的测量长度乘以的值。 默认值为 1。

Double
测量偏移
(可选)

合并输入线创建路径后，加到路径测量值的值。 默认值为 0。

Double
忽略空间间距
(可选)

指定在计算不相交路径上的测量值时是否忽略空间间距。 此参数适用于测量源是要素长度或值来自单个字段的情况。

  • 选中 - 忽略空间间距。 不相交路径的测量值将是连续的。 这是默认设置。
  • 未选中 - 不会忽略空间间距。 不相交路径的测量值将有间距。 间距距离通过不相交部分端点之间的直线距离进行计算。
Boolean
构建索引
(可选)

指定是否为写入输出路径要素类的路径标识符字段创建属性索引。

  • 选中 - 将创建属性索引。 这是默认设置。
  • 未选中 - 不会创建属性索引。
Boolean

arcpy.lr.CreateRoutes(in_line_features, route_id_field, out_feature_class, measure_source, {from_measure_field}, {to_measure_field}, {coordinate_priority}, {measure_factor}, {measure_offset}, {ignore_gaps}, {build_index})
名称说明数据类型
in_line_features

将创建路径的要素。

Feature Layer
route_id_field

包含可唯一识别每条路径的值的字段。 此字段可以是数值、文本或 GUID 字段。

Field
out_feature_class

将要创建的要素类。 可以是 shapefile 或地理数据库要素类。

Feature Class
measure_source

指定如何累积计算路径测量值。

  • LENGTH—使用输入要素的几何长度累积测量值。 这是默认设置。
  • ONE_FIELD—使用单个字段中存储的值累积测量值。
  • TWO_FIELDS—使用“测量始于字段”和“测量止于字段”中存储的值累积计算测量值。
String
from_measure_field
(可选)

包含测量值的字段。 此字段必须为数值，并且当测量源是为 ONE_FIELD 或 TWO_FIELDS 时必填。

Field
to_measure_field
(可选)

包含测量值的字段。 此字段必须为数值，并且当测量源为 TWO_FIELDS 时必填。

Field
coordinate_priority
(可选)

用于为每条输出路径累积测量值的位置。 当测量源为 TWO_FIELDS 时，将忽略此参数。

  • UPPER_LEFT—从最接近最小外接矩形左上角的点累积测量值。 这是默认设置。
  • LOWER_LEFT—从最接近最小外接矩形左下角的点累积测量值。
  • UPPER_RIGHT—从最接近最小外接矩形右上角的点累积测量值。
  • LOWER_RIGHT—从最接近最小外接矩形右下角的点累积测量值。
String
measure_factor
(可选)

合并输入线创建路径测量值之前，每条输入线的测量长度乘以的值。 默认值为 1。

Double
measure_offset
(可选)

合并输入线创建路径后，加到路径测量值的值。 默认值为 0。

Double
ignore_gaps
(可选)

指定在计算不相交路径上的测量值时是否忽略空间间距。 此参数适用于测量源是 LENGTH 或 ONE_FIELD 的情况。

  • IGNORE—忽略空间间距。 不相交路径的测量值将是连续的。 这是默认设置。
  • NO_IGNORE—不会忽略空间间距。 不相交路径的测量值将有间距。 间距距离通过不相交部分端点之间的直线距离进行计算。
Boolean
build_index
(可选)

指定是否为写入输出路径要素类的路径标识符字段创建属性索引。

  • INDEX—将创建属性索引。 这是默认设置。
  • NO_INDEX—不会创建属性索引。
Boolean

代码示例

CreateRoutes 示例 1（Python 窗口）

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


import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.CreateRoutes(base_roads.shp, "route1", "newRoutes", "LENGTH", "#", "#", 
                      "LOWER_LEFT", 0.00018939394)
CreateRoutes 示例 2（独立脚本）

以下 Python 脚本演示了如何在独立 Python 脚本中将 CreateRoutes 函数与 shapefile 数据结合使用。

# Name CreateRoutes_Example2.py
# Description: Create routes from lines. The lines are in a shapefile workspace.
# The LENGTH option will be used to set the measures, and a measure factor
# will be used to convert measure units from feet to miles.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data"

# Set local variables
in_lines = "base_roads.shp"
rid = "route1" 
out_routes = "create_output1" 

# Run CreateRoutes
arcpy.lr.CreateRoutes(in_lines, rid, out_routes, "LENGTH", "#", "#", 
                      "LOWER_LEFT", 0.00018939394)
CreateRoutes 示例 3（独立脚本）

以下 Python 脚本演示了如何在独立 Python 脚本中将 CreateRoutes 函数与文件地理数据库数据结合使用。

# Name CreateRoutes_Example3.py
# Description: Create routes from lines. The lines are in a file geodatabase.
# The ONE_FIELD option will be used to set the measures.

# Import system modules 
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"

# Set local variables
in_lines = "roads/base_roads"  # base_roads exists in the roads feature dataset
rid = "route1"
m_fld = "len_mile"
out_routes = "roads/create_output2"  # write result to the roads feature dataset

# Run CreateRoutes
arcpy.lr.CreateRoutes(in_lines, rid, out_routes, "ONE_FIELD", m_fld, "#", 
                      "LOWER_LEFT")
CreateRoutes 示例 4（独立脚本）

以下 Python 脚本演示了如何在独立 Python 脚本中将 CreateRoutes 函数与企业级地理数据库数据结合使用。

# Name CreateRoutes_Example4.py
# Description:  Create routes from lines. The lines are in an enterprise 
# geodatabase. The TWO_FIELD option will be used to set the measures.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"

# Set local variables
# base_roads is a stand-alone feature class
in_lines = arcpy.ValidateTableName("base_roads", wkspc)
rid = "route1"
fr_fld = "begmp1"
to_fld = "endmp1" 
out_routes = "create_output3"  # write the result to a stand-alone feature class

# Run CreateRoutes
arcpy.lr.CreateRoutes(in_lines, rid, out_routes, "TWO_FIELDS", fr_fld, to_fld)

环境

当前工作空间, M 分辨率, M 容差, 输出配置关键字, 输出 M 值域, 输出 XY 值域, 输出 Z 值域, 输出坐标系, 范围, 输出包含 Z 值, 临时工作空间

许可信息

  • Basic: 是
  • Standard: 是
  • Advanced: 是

相关主题

  • 线性参考工具箱概述
  • 查找地理处理工具

有关此主题的反馈?

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