线 Coverage 到路径 (Coverage)
摘要
通过为输入 coverage 中的每条弧线创建完整弧段来创建路线系统，还可以用来将弧线追加到现有路线系统。
用法
-
从线创建路线系统或者将线追加到路线系统。此工具将“输入”项中拓扑相连且包含唯一值的线进行组合，从而创建路径系统。“输入”项的唯一值始终写入路径属性表 (RAT) 中的“输出”项；这些值在创建路径后有助于标识这些路径。
-
向某个现有路线系统追加路径时，输出路线项必须是该路线系统的路径属性表上某个现有项的名称。此工具将为每个在路径属性表中包含“输入”项等于“输出路线项”的输入弧向现有路径追加一个弧段，但条件是：这些输入弧已被拓扑相连到追加的路径。所追加路径的原始部分上的“测量项”基于指定给新弧段的测量值和指定的“起始”结点进行更新。对于那些未在“输出路线项”中找到“输入路线项”值的组，会创建一个新路径。
-
“线 Coverage 到路径”基于输入路线项中的唯一值和弧线的拓扑连通性将弧线组合成路径。“线 Coverage 到路径”不能用于将拓扑不相交的多组弧线组合到基于“输入路线项”的同一路径中。
-
如果输入路线项是一个浮点数，则会将其截断为整数以便在新的路线系统中构建路径。
-
如果两个或多个路径的“输出路线项”值相同并且由于追加弧线而彼此互相连接，则“线 coverage 到路径”将合并这些路径。
-
如果某个现有路径包含叠置弧段，“线 Coverage 到路径”将不会向该现有路径追加弧段。而是将输入弧指定给某个新路径。
-
输入路线项中的唯一值将始终写入路径属性表中的输出路线项。使用输出路线项中的值有助于在创建路径后标识这些路径。
-
输入 Coverage 必须包含一个弧属性表，并且必须存在结点号且其状态为最新。同时使用构建和“线”选项可以创建或更新弧属性表。使用重新编号结点可以更新结点号。
-
使用从空值创建路线时，请注意：当“输入路线项”为数值时，将“空白”选项视为零 (0.0) 或为空；当“输入路线项”为字符时，将“空白”选项视为空。如果未指定“输入路线项”，则不考虑“从空值创建路线”的 BLANK 选项。
语法
| 参数 | 说明 | 数据类型 |
in_cover |
将用于创建路径的 coverage。 | Coverage |
out_route_system |
要创建或追加的路线系统的名称。 | String |
in_route_item （可选） |
弧属性表中用于将弧线结合为单独路径的项的名称。在路径属性表中为该项目内的每个唯一值创建一个新路径。默认设置是为每组拓扑相连的弧线创建一个路径。 | ArcInfo Item |
out_route_item （可选） |
路径属性表（包含“输入路径项”中的唯一值”）中新项目的名称。向某个现有路线系统追加路径时，该参数为路径属性表中用于追加路径的某个现有项目。默认项为“输入路线项”。 | String |
measure_item （可选） |
“输入 Coverage”的弧属性表中的某个项，将累积该项的值以产生测量值。默认项是 LENGTH。 | ArcInfo 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)