ArcToolbox banner

Append Polygon

Appends a polygon to an existing ArcGIS polygon feature class.


Command line syntax

ArcGISPolygonsAppendPolygonToFeatureClass2_GeoEco <featureClass> <outerRingPoints;outerRingPoints...> {ringSeparatorPoint} {innerRingPoints;innerRingPoints...} {intAttrsToSet;intAttrsToSet...} {intAttrValues;intAttrValues...} {floatAttrsToSet;floatAttrsToSet...} {floatAttrValues;floatAttrValues...} {stringAttrsToSet;stringAttrsToSet...} {stringAttrValues;stringAttrValues...} {dateAttrsToSet;dateAttrsToSet...} {dateAttrValues;dateAttrValues...}

Parameters
ExpressionExplanation
<featureClass>

Feature class that will receive the polygon.

<outerRingPoints;outerRingPoints...>

List of points defining the polygon's outer rings. The outer rings define the outside edges of the polygon.

For a polygon with only one outer ring (a single-part polygon), you must provide a minimum of three different points. This would form a triangle. To form more complex shapes, provide more points.

For a polygon with two or more outer rings (a multi-part polygon), you must first provide a value for the Ring Separator Point parameter. This is a fake point used to separate rings from each other. Then, for your outer ring points, list the points for the first ring, followed by the separator point, then the points for the second ring, then the separator point, then the points for the third ring, and so on.

For example, if you specified the separator point:

-9999 -9999

You could define a polygon having two parts, a right triangle and a square, like this:

0 0
0 2
2 0
-9999 -9999
5 5
5 7
7 7
7 5

If you are invoking this tool programmatically, you must specify each point as a string, as must be done when invoking an ArcGIS tool that accepts a point as input. For the example above, from Python you would pass the list:

[u'0 0', u'0 2', u'2 0', u'-9999 -9999', u'5 5', u'5 7', u'7 7', u'7 5']
{ringSeparatorPoint}

Fake point used to separate rings in the list of points for the Outer Ring Points and Inner Ring Points parameters. See the documentation for those parameters for more information. You need only provide a Ring Separator Point if you want to provide more than one outer or inner ring. Choose coordinate values that are different than all of the real points that make up the outer and inner rings.

{innerRingPoints;innerRingPoints...}

List of points defining the polygon's inner rings. The inner rings define "holes" in the polygon's outer rings. The inner rings are optional.

The rules for this parameter are similar to the rules for the outer rings parameter, but are more complicated because each outer ring may have zero or more inner rings. As with the outer rings, the Ring Separator Point is used as the boundary between rings. Provide it once to separate two inner rings for the same outer ring. Provide it twice to separate the inner rings for one outer ring from the inner rings for the next outer ring.

For example, if you specified the separator point:

-9999 -9999

For a polygon with one outer ring and one triangular inner ring, you do not need the Ring Separator Point at all:

0 0
0 2
2 0

If you wanted three triangular inner rings for that outer ring, you would list the Ring Separator Point once between each ring:

0 0
0 2
2 0
-9999 -9999
2 2
2 4
4 2
-9999 -9999
4 4
4 6
6 4

If you had two outer rings and wanted two inner rings for the first one and one for the second:

0 0
0 2
2 0
-9999 -9999
2 2
2 4
4 2
-9999 -9999
-9999 -9999
4 4
4 6
6 4

Note how the Ring Separator Point listed twice in a row separates the two inner rings of the first outer ring from the single inner ring of the second outer ring.

If you had three outer rings and only wanted a single inner ring for the third one:

-9999 -9999
-9999 -9999
-9999 -9999
-9999 -9999
0 0
0 2
2 0

In this last example, the first two Ring Separator Points terminate the list of inner rings for the first outer ring, and the second two terminate the list for the second outer ring. Neither of these rings has any inner rings. Then comes the single inner ring for the last outer ring.

If you are invoking this tool programmatically, you must specify each point as a string, as must be done when invoking an ArcGIS tool that accepts a point as input. For the last example above, from Python you would pass the list:

[u'-9999 -9999', u'-9999 -9999', u'-9999 -9999', u'-9999 -9999', u'0 0', u'0 2', u'2 0']
{intAttrsToSet;intAttrsToSet...}

LONG and SHORT integer attributes of the polygon that should be set to the values you specify. This parameter specifies the names of the attributes to set and the Integer Attribute Values parameter specifies their values.

This parameter is optional. If you do not set a particular attribute for the polygon, ArcGIS determines its default value. For shapefiles, it will be 0. For geodatabases, it will be the default value specified by the database schema, or NULL if the field is nullable and no default is specified.

{intAttrValues;intAttrValues...}

Values for the LONG and SHORT integer attributes to set for the polygon. You must provide a value for each attribute you specified for the Integer Attributes to Set parameter.

{floatAttrsToSet;floatAttrsToSet...}

FLOAT and DOUBLE attributes of the polygon that should be set to the values you specify. This parameter specifies the names of the attributes to set and the Floating Point Attribute Values parameter specifies their values.

This parameter is optional. If you do not set a particular attribute for the polygon, ArcGIS determines its default value. For shapefiles, it will be 0. For geodatabases, it will be the default value specified by the database schema, or NULL if the field is nullable and no default is specified.

{floatAttrValues;floatAttrValues...}

Values for the FLOAT and DOUBLE attributes to set for the polygon. You must provide a value for each attribute you specified for the Floating Point Attributes to Set parameter.

{stringAttrsToSet;stringAttrsToSet...}

TEXT attributes of the polygon that should be set to the values you specify. This parameter specifies the names of the attributes to set and the Text Attribute Values parameter specifies their values.

This parameter is optional. If you do not set a particular attribute for the polygon, ArcGIS determines its default value. For shapefiles, it will be a zero-length string. For geodatabases, it will be the default value specified by the database schema, or NULL if the field is nullable and no default is specified.

{stringAttrValues;stringAttrValues...}

Values for the TEXT attributes to set for the polygon. You must provide a value for each attribute you specified for the Text Attributes to Set parameter.

{dateAttrsToSet;dateAttrsToSet...}

DATE attributes of the polygon that should be set to the values you specify. This parameter specifies the names of the attributes to set and the Date Attribute Values parameter specifies their values.

This parameter is optional. If you do not set a particular attribute for the polygon, ArcGIS determines its default value. For shapefiles, it will be NULL. For geodatabases, it will be the default value specified by the database schema, or NULL if the field is nullable and no default is specified.

{dateAttrValues;dateAttrValues...}

Values for the DATE attributes to set for the polygon. You must provide a value for each attribute you specified for the Date Attributes to Set parameter. Your date may include a time if the underlying feature class supports it.

Scripting syntax

ArcGISPolygonsAppendPolygonToFeatureClass2_GeoEco (featureClass, outerRingPoints, ringSeparatorPoint, innerRingPoints, intAttrsToSet, intAttrValues, floatAttrsToSet, floatAttrValues, stringAttrsToSet, stringAttrValues, dateAttrsToSet, dateAttrValues)

Parameters
ExpressionExplanation
Polygon feature class (Required)

Feature class that will receive the polygon.

Outer ring points (Required)

List of points defining the polygon's outer rings. The outer rings define the outside edges of the polygon.

For a polygon with only one outer ring (a single-part polygon), you must provide a minimum of three different points. This would form a triangle. To form more complex shapes, provide more points.

For a polygon with two or more outer rings (a multi-part polygon), you must first provide a value for the Ring Separator Point parameter. This is a fake point used to separate rings from each other. Then, for your outer ring points, list the points for the first ring, followed by the separator point, then the points for the second ring, then the separator point, then the points for the third ring, and so on.

For example, if you specified the separator point:

-9999 -9999

You could define a polygon having two parts, a right triangle and a square, like this:

0 0
0 2
2 0
-9999 -9999
5 5
5 7
7 7
7 5

If you are invoking this tool programmatically, you must specify each point as a string, as must be done when invoking an ArcGIS tool that accepts a point as input. For the example above, from Python you would pass the list:

[u'0 0', u'0 2', u'2 0', u'-9999 -9999', u'5 5', u'5 7', u'7 7', u'7 5']
Ring separator point (Optional)

Fake point used to separate rings in the list of points for the Outer Ring Points and Inner Ring Points parameters. See the documentation for those parameters for more information. You need only provide a Ring Separator Point if you want to provide more than one outer or inner ring. Choose coordinate values that are different than all of the real points that make up the outer and inner rings.

Inner ring points (Optional)

List of points defining the polygon's inner rings. The inner rings define "holes" in the polygon's outer rings. The inner rings are optional.

The rules for this parameter are similar to the rules for the outer rings parameter, but are more complicated because each outer ring may have zero or more inner rings. As with the outer rings, the Ring Separator Point is used as the boundary between rings. Provide it once to separate two inner rings for the same outer ring. Provide it twice to separate the inner rings for one outer ring from the inner rings for the next outer ring.

For example, if you specified the separator point:

-9999 -9999

For a polygon with one outer ring and one triangular inner ring, you do not need the Ring Separator Point at all:

0 0
0 2
2 0

If you wanted three triangular inner rings for that outer ring, you would list the Ring Separator Point once between each ring:

0 0
0 2
2 0
-9999 -9999
2 2
2 4
4 2
-9999 -9999
4 4
4 6
6 4

If you had two outer rings and wanted two inner rings for the first one and one for the second:

0 0
0 2
2 0
-9999 -9999
2 2
2 4
4 2
-9999 -9999
-9999 -9999
4 4
4 6
6 4

Note how the Ring Separator Point listed twice in a row separates the two inner rings of the first outer ring from the single inner ring of the second outer ring.

If you had three outer rings and only wanted a single inner ring for the third one:

-9999 -9999
-9999 -9999
-9999 -9999
-9999 -9999
0 0
0 2
2 0

In this last example, the first two Ring Separator Points terminate the list of inner rings for the first outer ring, and the second two terminate the list for the second outer ring. Neither of these rings has any inner rings. Then comes the single inner ring for the last outer ring.

If you are invoking this tool programmatically, you must specify each point as a string, as must be done when invoking an ArcGIS tool that accepts a point as input. For the last example above, from Python you would pass the list:

[u'-9999 -9999', u'-9999 -9999', u'-9999 -9999', u'-9999 -9999', u'0 0', u'0 2', u'2 0']
Integer attributes to set (Optional)

LONG and SHORT integer attributes of the polygon that should be set to the values you specify. This parameter specifies the names of the attributes to set and the Integer Attribute Values parameter specifies their values.

This parameter is optional. If you do not set a particular attribute for the polygon, ArcGIS determines its default value. For shapefiles, it will be 0. For geodatabases, it will be the default value specified by the database schema, or NULL if the field is nullable and no default is specified.

Integer attribute values (Optional)

Values for the LONG and SHORT integer attributes to set for the polygon. You must provide a value for each attribute you specified for the Integer Attributes to Set parameter.

Floating point attributes to set (Optional)

FLOAT and DOUBLE attributes of the polygon that should be set to the values you specify. This parameter specifies the names of the attributes to set and the Floating Point Attribute Values parameter specifies their values.

This parameter is optional. If you do not set a particular attribute for the polygon, ArcGIS determines its default value. For shapefiles, it will be 0. For geodatabases, it will be the default value specified by the database schema, or NULL if the field is nullable and no default is specified.

Floating point attribute values (Optional)

Values for the FLOAT and DOUBLE attributes to set for the polygon. You must provide a value for each attribute you specified for the Floating Point Attributes to Set parameter.

Text attributes to set (Optional)

TEXT attributes of the polygon that should be set to the values you specify. This parameter specifies the names of the attributes to set and the Text Attribute Values parameter specifies their values.

This parameter is optional. If you do not set a particular attribute for the polygon, ArcGIS determines its default value. For shapefiles, it will be a zero-length string. For geodatabases, it will be the default value specified by the database schema, or NULL if the field is nullable and no default is specified.

Text attribute values (Optional)

Values for the TEXT attributes to set for the polygon. You must provide a value for each attribute you specified for the Text Attributes to Set parameter.

Date attributes to set (Optional)

DATE attributes of the polygon that should be set to the values you specify. This parameter specifies the names of the attributes to set and the Date Attribute Values parameter specifies their values.

This parameter is optional. If you do not set a particular attribute for the polygon, ArcGIS determines its default value. For shapefiles, it will be NULL. For geodatabases, it will be the default value specified by the database schema, or NULL if the field is nullable and no default is specified.

Date attribute values (Optional)

Values for the DATE attributes to set for the polygon. You must provide a value for each attribute you specified for the Date Attributes to Set parameter. Your date may include a time if the underlying feature class supports it.