创建路径 (线性参考工具)

汇总

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

用法

将路径标识符字段参数值中的唯一值写入输出路径要素类参数。
使用创建要素图层或创建查询表工具可减少将用于创建路径的线数。
如果将输出路径要素类参数值写入地理数据库，则需设置适当的 M 容差、M 分辨率和 M 域环境。
当将测量源设置为要素的长度以使用几何长度累积测量时，可以使用 2D 长度和 3D 长度。对于 2D 长度值，请使用要素长度。对于 3D 长度值，请在新字段上创建带有插入或更新触发器的计算属性规则，该规则返回 Length3D ArcGIS Arcade 函数。

了解有关创建和管理属性规则的详细信息
使用测量系数参数转换路径测量单位。例如，要将英尺转换为英里，请使用系数 0.00018939394：
在每条路径的起始测量值都需要非零值的应用中使用测量偏移参数值。
当测量源参数值指定为来自两个字段的值时，不使用忽略空间间隙参数。这是因为测量值基于测量始于字段和测量止于字段参数值。
当测量源参数值指定为要素长度或来自单个字段的值时，可通过将最小外接矩形放置在要通过合并以创建一条路径的输入要素周围来确定坐标优先级参数值。
当测量源参数值指定为来自两个字段的值时，无需指定坐标优先级，因为测量方向由测量始于字段和测量止于字段参数中的值指明。
路径标识符字段上的属性索引可加快动态分段过程的速度。如果将使用输出路径要素类参数值进行动态分段，建议创建属性索引。
若有任何要素被此工具拒绝，则在临时文件路径下创建一个文本文件以存储有关这些要素的信息，例如 C:\Users\patrickb\AppData\Local\Temp\Create_Output0.txt（其中，Create_Output 是输出路径要素类的名称）。
输出包含 M 值环境设置将被忽略。 输出路径要素类参数值将包含 m 值（测量值）。

标注	说明	数据类型
输入线要素	将创建路径的要素。	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 （可选）	包含测量值的字段。当 `measure_source` 参数值为 `ONE_FIELD` 或 `TWO_FIELDS` 时，此参数为必选项。	Field
to_measure_field （可选）	包含测量值的数值字段。当 `measure_source` 参数值为 `TWO_FIELDS` 时，此参数为必需项。	Field
coordinate_priority （可选）	指定用于为每条输出路径累积测量值的位置。当 `measure_source` 参数值为 `TWO_FIELDS` 时，将忽略此参数。 `UPPER_LEFT`—从最接近最小外接矩形左上角的点累积测量值。这是默认设置。 `LOWER_LEFT`—从最接近最小外接矩形左下角的点累积测量值。 `UPPER_RIGHT`—从最接近最小外接矩形右上角的点累积测量值。 `LOWER_RIGHT`—从最接近最小外接矩形右下角的点累积测量值。	String
measure_factor （可选）	合并输入线创建路径测量值之前，每条输入线的测量长度乘以的值。默认值为 1。	Double
measure_offset （可选）	合并输入线创建路径后，加到路径测量值的值。默认值为 0。	Double
ignore_gaps （可选）	指定在计算不相交路径上的测量值时是否忽略空间间距。当 `measure_source` 参数值为 `LENGTH` 或 `ONE_FIELD` 时，此参数适用。 `IGNORE`—忽略空间间距。不相交路径的测量值将是连续的。这是默认设置。 `NO_IGNORE`—不会忽略空间间距。不相交路径的测量值将有间距。间距距离通过不相交部分端点之间的直线距离进行计算。	Boolean
build_index （可选）	指定是否为写入输出路径要素类的路径标识符字段创建属性索引。 `INDEX`—将创建属性索引。这是默认设置。 `NO_INDEX`—不会创建属性索引。	Boolean

代码示例

CreateRoutes 示例 1（Python 窗口）

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

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.CreateRoutes(base_roads.shp, "route1", "newRoutes", "LENGTH", None, None,
                      "LOWER_LEFT", 0.00018939394)

CreateRoutes 示例 2（独立脚本）

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

# 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", None, None,
                      "LOWER_LEFT", 0.00018939394)

CreateRoutes 示例 3（独立脚本）

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

# 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, None,
                      "LOWER_LEFT")

CreateRoutes 示例 4（独立脚本）

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

# Description:  Create routes from lines. The lines are in an enterprise
# geodatabase. The TWO_FIELDS 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 值, 临时工作空间

许可信息

基本: 是
标准: 是
高级: 是

创建路径 (线性参考工具)

汇总

用法

参数

环境

许可信息

相关主题