Line Coverage To Route (Coverage)

Summary

Creates a route system by creating whole arc sections for each arc in the input coverage and can also be used to append arcs to an existing route system.

Usage

Syntax

ArcRoute_arc (in_cover, out_route_system, {in_route_item}, {out_route_item}, {measure_item}, {coordinate_priority}, {use_blanks})
ParameterExplanationData Type
in_cover

The coverage from which the routes are to be created.

Coverage
out_route_system

The name of the route system to be created or appended.

String
in_route_item
(Optional)

The name of an item in the arc attribute table used to group arcs into separate routes. A new route is created in the route attribute table for each unique value in this item. The default is to create a route for each topologically connected set of arcs.

ArcInfo Item
out_route_item
(Optional)

The name of the new item in the route attribute table that will contain the unique values in the input route item. When appending routes to an existing route system, it is an existing item in the route attribute table used to append routes. The default item is Input Route Item.

String
measure_item
(Optional)

An item in the arc attribute table of Input Coverage whose value is accumulated to produce the measure values. The default item is LENGTH.

ArcInfo Item
coordinate_priority
(Optional)

Determines coordinate priority when choosing a start node for the route.

  • ULUpper left. This is the default.
  • URUpper right.
  • LLLower left.
  • LRLower right.
String
use_blanks
(Optional)

Specifies whether arcs having a null or 0 value for the input route item will be used to create a route.

  • BLANKArcs having a null or 0 value for the Input Route Item will be used to create routes. This is the default.
  • NOBLANKArcs having a null or 0 value for the Input Route Item will not be used to create routes.
Boolean

Code Sample

ArcRoute example (stand-alone script)

The following stand-alone script demonstrates how to create a route system for a line coverage that contains road segments.

# Name: ArcRoute_Example.py
# Description: Adds a route system to a streams coverage
# Requirements: ArcInfo Workstation
# Author: ESRI

# 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)

Environments

Related Topics

Licensing Information

ArcView: No
ArcEditor: No
ArcInfo: Requires ArcInfo Workstation installed

Published 6/8/2010