Append (Coverage)

Summary

Combines an unlimited number of coverages into a single coverage.

Append checks for the existence of the coverage, verifies that the list of feature attribute table items matches the items in previously entered coverages (unless the FEATURES_ONLY option is used), and calculates Tic-ID and feature User-ID offsets according to the specified offset option.

Learn more about how Append works

Illustration

Appending coverages

Usage

Syntax

Append_arc (in_covers, out_cover, {append_method}, {feature_classes}, {number_method})
ParameterExplanationData Type
in_covers
[in_covers,...]

The input coverages to be appended. There is no limit to the number of coverages that can be entered.

Coverage
out_cover

The output coverage to be created. The output coverage cannot already exist.

Coverage
append_method
(Optional)

Determines whether only coordinates will be appended (FEATURES_ONLY) or if features will also be appended.

  • FEATURES_ONLYLocation information for all feature classes that are appended. Feature attribute tables are not appended.
  • FEATURES_ATTRIBUTESThe features in the specified coverage define the set of features to be appended.
String
feature_classes
(Optional)

The feature class of the input coverage or coverages.

  • POLYPolygon feature coordinates and attributes are appended, including label points.
  • LINEArc feature coordinates and attributes are appended.
  • POINTPoint feature coordinates and attributes are appended.
  • NODEArc and node feature coordinates and their attributes are appended.
  • NETArc and polygon feature coordinates and their attributes are appended.
  • LINKArc and point feature coordinates and their attributes are appended.
  • ANNO.subclassAnnotation features and attributes of the subclass are appended.
  • SECTION.subclassSection feature coordinates and attributes of the subclass are appended.
  • ROUTE.subclassRoute and section feature coordinates and attributes of the subclass are appended.
  • REGION.subclassRegion feature coordinates and attributes of the subclass are appended. Polygon feature coordinates and attributes are also appended.

The Add Value button, which is used only in ModelBuilder, allows you to add expected value(s) so you can complete the dialog and continue to build your model.

String
number_method
(Optional)

Specifies how tics and coverage features will be numbered in the Output Coverage. IDs can be offset to ensure unique ID values for Output Coverage features. The ID offset is equal to 1 plus the highest ID value in the previously appended coverages. Offsets can be calculated for the following types of IDs:

  • NONeither Tic-IDs nor feature User-IDs will be modified. This is the default option.
  • TICS_ONLYID offsets will be calculated for tics.
  • FEATURES_ONLYUser-ID offsets will be calculated for the feature class(es) specified by the feature classes argument. Tic-IDs are not modified.
  • FEATURES_TICSID offsets will be calculated for both tics and features.
String

Code Sample

Buffer example (stand-alone script)

The following stand-alone script demonstrates how to append several coverage into one output coverage.

# Name: Append_Example.py
# Description: Appends several coverages into one output
# Requirements: ArcInfo Workstation
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
inCovers = ["tongzone1", "tongzone2", "tongzone3", "tongzone4"]
outCover = "C:/output/tongass"
appendMethod = "FEATURES_ONLY"
featureClasses = "LINE"
numberMethod = "TICS_ONLY"

# Execute Append
arcpy.Append_arc(inCovers, outCover, appendMethod, featureClasses, 
                 numberMethod)

Environments

Related Topics

Licensing Information

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

Published 6/8/2010