com.esri.arcgis.geoprocessing.tools.coveragetools
Class Append

java.lang.Object
  com.esri.arcgis.geoprocessing.AbstractGPTool
      com.esri.arcgis.geoprocessing.tools.coveragetools.Append

All Implemented Interfaces:

GPTool

public class Append

extends AbstractGPTool

The Append tool is contained in the Coverage Tools tool box.
Learn more about how Append works

Software restrictions: ArcInfo only

Illustration:

Usage tips:

• All Input Coverages to be appended must contain the feature class; or set of feature classes and feature attribute tables to be appended. For example, if the NET feature type option is used, all coverages should have line and polygon features, and corresponding AATs and PATs.
• The TOL file with single precision; coverages and the PAR file with double precision; coverages will not be transformed or retained in the Output Coverage files.
• The fuzzy tolerance; of the Output Coverage will default to 0.002 if the width of the BND is between 1 and 100; otherwise, the tolerance is 1/10,000 of the width or height of the BND, whichever is greater.
• The item definitions of the feature attribute tables must be the same and in the same order for all appended coverages (unless the FEATURES_ONLY option is used).
• Using the ROUTE.subclass option is the same as using the ROUTE.subclass and SECTION.subclass options together; that is, both the routes and sections of the specified subclass are appended. If the User-ID of any route is not unique across the coverages being appended, that route will be merged with other routes of the same User-ID. The Output Coverage may, therefore, contain less routes than the total number of routes in the Input Coverages. Append never modifies route measures.
• All polygons in the Input Coverages are appended with the REGION.subclass option, not just those pertaining to the regions being appended. Region subclasses are not maintained with the POLY option; you must also specify REGION.subclass. After combining region subclasses with Append, the new topological relationships between features must be calculated using Build; or Clean; . Another way to combine region subclasses is to use Union; . Union calculates topology when combining region subclasses.
• Annotation; for each coverage is appended to the Output Coverage. As with all other feature classes, all TATs within a subclass must have identical item definitions.
• The projection; file (PRJ) will be copied to the Output Coverage. The first coverage entered will provide the projection information for the Output Coverage.
• The coordinate precision of the Output Coverage is determined by the current processing rule as set by the Derived Precision; environment setting. If the processing rule has not been established, then the processing rule will be HIGHEST. This means that Append will create an Output Coverage in the highest precision of the Input Coverages.
• Projection files will be compared for similarity using the level of comparison specified with the Compare Projections; environment setting.
• The Feature Type parameter's Add Value button is used only in ModelBuilder. In ModelBuilder, where the preceding tool has not been run or its derived data does not exist, the Feature Type parameter may not be populated with values. The Add Value button allows you to add expected value(s) so you can complete the Append dialog and continue to build your model.
• The following environments affect this tool: derivedPrecision; newPrecision; projectCompare; scratchWorkspace; , and workspace;

Field Summary

Fields inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

vals

Constructor Summary

Append()
Creates the Append tool with defaults.

Append(java.lang.Object inCovers, java.lang.Object outCover)
Creates the Append tool with the required parameters.

Method Summary

java.lang.String	getAppendMethod() Returns the Append Method parameter of this tool .
java.lang.Object	getFeatureClasses() Returns the Feature Type parameter of this tool .
java.lang.Object	getInCovers() Returns the Input Coverages parameter of this tool .
java.lang.String	getNumberMethod() Returns the Create Unique IDs parameter of this tool .
java.lang.Object	getOutCover() Returns the Output Coverage parameter of this tool .
java.lang.String	getToolboxAlias() Returns the alias of the tool box containing this tool.
java.lang.String	getToolboxName() Returns the name of the tool box containing this tool.
java.lang.String	getToolName() Returns the name of this tool.
void	setAppendMethod(java.lang.String appendMethod) Sets the Append Method parameter of this tool .
void	setFeatureClasses(java.lang.Object featureClasses) Sets the Feature Type parameter of this tool .
void	setInCovers(java.lang.Object inCovers) Sets the Input Coverages parameter of this tool .
void	setNumberMethod(java.lang.String numberMethod) Sets the Create Unique IDs parameter of this tool .
void	setOutCover(java.lang.Object outCover) Sets the Output Coverage parameter of this tool .

Methods inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

getParameterValues, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Append

public Append()

Creates the Append tool with defaults.

Initializes the array of tool parameters with the default values specified when the tool was created.

Append

public Append(java.lang.Object inCovers,
              java.lang.Object outCover)

Creates the Append tool with the required parameters.

Initializes the array of tool parameters with the values as specified for the required parameters and with the default values for the other parameters.

Parameters:

inCovers - Coverage; Coverage..., the Input Coverages to be appended. There is no limit to the number of coverages that can be entered.

outCover - Coverage, the Output Coverage to be created. The Output Coverage cannot already exist.

Method Detail

getInCovers

public java.lang.Object getInCovers()

Returns the Input Coverages parameter of this tool . This parameter is Coverage; Coverage..., the Input Coverages to be appended. There is no limit to the number of coverages that can be entered. This is a required parameter.

Returns:

the Input Coverages

setInCovers

public void setInCovers(java.lang.Object inCovers)

Sets the Input Coverages parameter of this tool . This parameter is Coverage; Coverage..., the Input Coverages to be appended. There is no limit to the number of coverages that can be entered. This is a required parameter.

Parameters:

inCovers - Coverage; Coverage..., the Input Coverages to be appended. There is no limit to the number of coverages that can be entered.

getOutCover

public java.lang.Object getOutCover()

Returns the Output Coverage parameter of this tool . This parameter is Coverage, the Output Coverage to be created. The Output Coverage cannot already exist. This is a required parameter.

Returns:

the Output Coverage

setOutCover

public void setOutCover(java.lang.Object outCover)

Sets the Output Coverage parameter of this tool . This parameter is Coverage, the Output Coverage to be created. The Output Coverage cannot already exist. This is a required parameter.

Parameters:

outCover - Coverage, the Output Coverage to be created. The Output Coverage cannot already exist.

getAppendMethod

public java.lang.String getAppendMethod()

Returns the Append Method parameter of this tool . This parameter is String, determines whether only coordinates will be appended (FEATURES_ONLY) or whether features will also be appended. This is an optional parameter.

Returns:

the Append Method

setAppendMethod

public void setAppendMethod(java.lang.String appendMethod)

Sets the Append Method parameter of this tool . This parameter is String, determines whether only coordinates will be appended (FEATURES_ONLY) or whether features will also be appended. This is an optional parameter.

Parameters:

appendMethod - String, determines whether only coordinates will be appended (FEATURES_ONLY) or whether features will also be appended.

• FEATURES_ONLY—Location information for all feature classes that are appended. Feature attribute tables are not appended.
• FEATURES_ATTRIBUTES—The features in the specified coverage define the set of features to be appended.

getFeatureClasses

public java.lang.Object getFeatureClasses()

Returns the Feature Type parameter of this tool . This parameter is String, 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. This is an optional parameter.

Returns:

the Feature Type

setFeatureClasses

public void setFeatureClasses(java.lang.Object featureClasses)

Sets the Feature Type parameter of this tool . This parameter is String, 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. This is an optional parameter.

Parameters:

featureClasses - String, 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.

• POLY—Polygon feature coordinates and attributes are appended, including label points.
• LINE—Arc feature coordinates and attributes are appended.
• POINT—Point feature coordinates and attributes are appended.
• NODE—Arc and node feature coordinates and their attributes are appended.
• NET—Arc and polygon feature coordinates and their attributes are appended.
• LINK—Arc and point feature coordinates and their attributes are appended.
• ANNO.subclass—Annotation features and attributes of the subclass are appended.
• SECTION.subclass—Section feature coordinates and attributes of the subclass are appended.
• ROUTE.subclass—Route and section feature coordinates and attributes of the subclass are appended.
• REGION.subclass—Region feature coordinates and attributes of the subclass are appended. Polygon feature coordinates and attributes are also appended.

getNumberMethod

public java.lang.String getNumberMethod()

Returns the Create Unique IDs parameter of this tool . This parameter is String, 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: This is an optional parameter.

Returns:

the Create Unique IDs

setNumberMethod

public void setNumberMethod(java.lang.String numberMethod)

Sets the Create Unique IDs parameter of this tool . This parameter is String, 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: This is an optional parameter.

Parameters:

numberMethod - String, 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:

• NO—Neither Tic-IDs nor feature User-IDs will be modified. This is the default option.
• TICS_ONLY—ID offsets will be calculated for tics.
• FEATURES_ONLY—User-ID offsets will be calculated for the feature class(es) specified by the feature classes argument. Tic-IDs are not modified.
• FEATURES_TICS—ID offsets will be calculated for both tics and features.

getToolName

public java.lang.String getToolName()

Returns the name of this tool.

Returns:

the tool name

getToolboxName

public java.lang.String getToolboxName()

Returns the name of the tool box containing this tool.

Returns:

the tool box name

getToolboxAlias

public java.lang.String getToolboxAlias()

Returns the alias of the tool box containing this tool.

Returns:

the tool box alias