标注 | 说明 | 数据类型 |
输入线要素 | 将创建路径的要素。 | Feature Layer |
路径标识符字段 | 包含可唯一识别每条路径的值的字段。 此字段可以是数值、文本或 GUID 字段。 | Field |
输出路径要素类 | 将要创建的要素类。 可以是 shapefile 或地理数据库要素类。 | Feature Class |
测量源 | 指定如何累积计算路径测量值。
| String |
测量始于字段 (可选) | 包含测量值的字段。 此字段必须为数值,并且当测量源为来自单个字段的值或来自两个字段的值时必填。 | Field |
测量止于字段 (可选) | 包含测量值的字段。 此字段必须为数值,并且当测量源为来自两个字段的值时必填。 | Field |
坐标优先级 (可选) | 用于为每条输出路径累积测量值的位置。 当测量源为来自两个字段的值时,将忽略此参数。
| String |
测量系数 (可选) | 合并输入线创建路径测量值之前,每条输入线的测量长度乘以的值。 默认值为 1。 | Double |
测量偏移 (可选) | 合并输入线创建路径后,加到路径测量值的值。 默认值为 0。 | Double |
忽略空间间距 (可选) | 指定在计算不相交路径上的测量值时是否忽略空间间距。 此参数适用于测量源是要素长度或值来自单个字段的情况。
| Boolean |
构建索引 (可选) | 指定是否为写入输出路径要素类的路径标识符字段创建属性索引。
| Boolean |
摘要
根据现有的线创建路径。 合并共享通用标识符的输入线要素以创建单个路径。
使用情况
将路径标识符字段参数值中的唯一值写入输出路径要素类。
使用测量系数参数转换路径测量单位。 例如,要将英尺转换为英里,请使用系数 0.00018939394:
在每条路径的起始测量值都需要非零值的应用中使用测量偏移参数值。
当测量源参数指定为来自两个字段的值时,不使用忽略空间间隙参数。 这是因为测量值由测量始于字段和测量止于字段值指定。
在使用要素长度或者来自单个字段测量源选项时,通过将最小外接矩形放置在要通过合并创建一条路径的输入要素周围来确定坐标优先级。
当将测量源参数指定为来自两个字段的值选项时,不需要指定坐标优先级,因为测量方向由测量始于字段和测量止于参数中的值指明。
路径标识符字段上的属性索引可加快动态分段过程的速度。 如果将使用输出路径要素类参数值进行动态分段,建议创建属性索引。
若有任何要素被此工具拒绝,则在临时文件路径下创建一个文本文件以存储有关这些要素的信息,例如 C:\Users\patrickb\AppData\Local\Temp\Create_Output0.txt(其中,Create_Output 是输出路径要素类的名称)。
输出包含 M 值环境设置将被忽略。 输出路径要素类参数值将包含 m 值(测量值)。
参数
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 | 指定如何累积计算路径测量值。
| String |
from_measure_field (可选) | 包含测量值的字段。 此字段必须为数值,并且当测量源是为 ONE_FIELD 或 TWO_FIELDS 时必填。 | Field |
to_measure_field (可选) | 包含测量值的字段。 此字段必须为数值,并且当测量源为 TWO_FIELDS 时必填。 | Field |
coordinate_priority (可选) | 用于为每条输出路径累积测量值的位置。 当测量源为 TWO_FIELDS 时,将忽略此参数。
| String |
measure_factor (可选) | 合并输入线创建路径测量值之前,每条输入线的测量长度乘以的值。 默认值为 1。 | Double |
measure_offset (可选) | 合并输入线创建路径后,加到路径测量值的值。 默认值为 0。 | Double |
ignore_gaps (可选) | 指定在计算不相交路径上的测量值时是否忽略空间间距。 此参数适用于测量源是 LENGTH 或 ONE_FIELD 的情况。
| Boolean |
build_index (可选) | 指定是否为写入输出路径要素类的路径标识符字段创建属性索引。
| Boolean |
代码示例
以下 Python 窗口脚本演示了如何在 Python 窗口中使用 CreateRoutes 函数。
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.CreateRoutes(base_roads.shp, "route1", "newRoutes", "LENGTH", "#", "#",
"LOWER_LEFT", 0.00018939394)
以下 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)
以下 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")
以下 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)
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是