线 Coverage 到路径 (Coverage)
摘要
通过为输入 coverage 中的每条弧线创建完整弧段来创建路线系统，还可以用来将弧线追加到现有路线系统。
用法
-
从线创建路线系统或者将线追加到路线系统。此工具将“输入”项中拓扑相连且包含唯一值的线进行组合，从而创建路径系统。“输入”项的唯一值始终写入路径属性表 (RAT) 中的“输出”项；这些值在创建路径后有助于识别这些路径。
-
向某个现有路线系统追加路径时，输出路线项必须是该路线系统的路径属性表上某个现有项的名称。此工具将为每个在路径属性表中包含“输入”项等于输出路线项的输入弧向现有路径追加一个弧段，但条件是：这些输入弧已被拓扑相连到追加的路径。所追加路径的原始部分上的“测量项”基于指定给新弧段的测量值和指定的“起始”结点进行更新。对于那些未在输出路线项中找到输入路线项值的组，会创建一个新路径。
-
线 Coverage 到路径基于输入路线项中的唯一值和弧线的拓扑连通性将弧线组合成路径。“线 Coverage 到路径”不能用于将拓扑不相交的多组弧线组合到基于“输入路线项”的同一路径中。
-
如果输入路线项是一个浮点数，则会将其截断为整数以便在新的路线系统中构建路径。
-
如果两个或多个路径的输出路线项值相同并且由于追加弧线而彼此互相连接，则线 coverage 到路径将合并这些路径。
-
如果某个现有路径包含叠置弧段，线 Coverage 到路径将不会向该现有路径追加弧段。而是将输入弧指定给某个新路径。
-
输入路线项中的唯一值将始终写入路径属性表中的输出路线项。使用输出路线项中的值有助于在创建路径后识别这些路径。
-
输入 Coverage 必须包含一个弧属性表，并且必须存在结点号且其状态为最新。同时使用构建和“线”选项可以创建或更新弧属性表。使用重新编号结点可以更新结点号。
-
使用从空值创建路线时，请注意：当“输入路线项”为数值时，将“空白”选项视为零 (0.0) 或为空；当“输入路线项”为字符时，将“空白”选项视为空。如果未指定输入路线项，则不考虑从空值创建路线的 BLANK 选项。
语法
| 参数 | 说明 | 数据类型 |
in_cover |
将用于创建路径的 coverage。 | Coverage |
out_route_system |
要创建或追加的路线系统的名称。 | String |
in_route_item (可选) |
弧属性表中用于将弧线结合为单独路径的项的名称。在路径属性表中为该项目内的每个唯一值创建一个新路径。默认设置是为每组拓扑相连的弧线创建一个路径。 | INFO Item |
out_route_item (可选) |
路径属性表（包含“输入路径项”中的唯一值”）中新项目的名称。向某个现有路线系统追加路径时，该参数为路径属性表中用于追加路径的某个现有项目。默认项为“输入路线项”。 | String |
measure_item (可选) |
“输入 Coverage”的弧属性表中的某个项，将累积该项的值以产生测量值。默认项是 LENGTH。 | INFO Item |
coordinate_priority (可选) |
用于在为路径选择起始结点时确定坐标优先级。
| String |
use_blanks (可选) |
指定是否将使用“输入路线项”为空值或 0 的弧线创建路径。
| Boolean |
代码实例
以下独立脚本演示如何为包含路段的线 coverage 创建路线系统。
# Name: ArcRoute_Example.py
# Description: Adds a route system to a streams coverage
# Requirements: ArcInfo Workstation
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inCover = "stream"
outRouteSystem = "nstreams"
inRouteItem = "STREAM_NAME"
coordinatePriority = "LL"
useBlanks = "NO_BLANK"
# Execute ArcRoute
arcpy.ArcRoute_arc(inCover, outRouteSystem, inRouteItem, "", "",
coordinatePriority, useBlanks)