Summary
The array object can contain points and arrays and is used to construct geometry objects.
Syntax
Array ({items})
Parameter | Explanation | Data Type |
items | Items can include a Point object, another Array object, or any iterable object that returns Point objects. | Object |
Properties
Property | Explanation | Data Type |
count (Read Only) | The element count of the array. | Integer |
Method Overview
Method | Explanation |
add (value) | Adds a Point or Array object to the end of the array. |
append (value) | Appends an object to the array in the last position. |
clone (point_object) | Clone the Point object. |
extend (items) | Extends the array by appending elements. |
getObject (index) | Returns the object at the given index position in the array. The getObject method is equivalent to indexing an object; that is, obj.getObject(0) is equivalent to obj[0]. |
insert (index, value) | Adds an object to the Array object at the specified index. |
next () | Returns the next object at the current index. |
remove (index) | Removes the object at the specified index position from the array. |
removeAll () | Removes all values and creates an empty object. |
replace (index, value) | Replaces the object at the specified index position in the Array object. |
reset () | Sets the current enumeration index (used by the next method) back to the first element. |
Methods
add (value)
Parameter | Explanation | Data Type |
value | Either a Point or Array object can be appended to the array. | Object |
append (value)
Parameter | Explanation | Data Type |
value | Either a Point or Array object can be appended to the array. | Object |
clone (point_object)
Parameter | Explanation | Data Type |
point_object | A Point object. | Point |
extend (items)
Parameter | Explanation | Data Type |
items | Extends the array by adding strings, integers, or lists. | Object |
getObject (index)
Parameter | Explanation | Data Type |
index | The index position of the array. | Integer |
Data Type | Explanation |
Object | The Array or Point object at the index position. |
insert (index, value)
Parameter | Explanation | Data Type |
index | The index position of the Array object. | Integer |
value | The Point or Array object to be inserted. | Object |
next ()
Data Type | Explanation |
Object | The next object at the current index. |
remove (index)
Parameter | Explanation | Data Type |
index | The index position that will be removed. | Integer |
removeAll ()
replace (index, value)
Parameter | Explanation | Data Type |
index | The index position that will be replaced. | Integer |
value | The new Point or Array object to be added to the Array object. | Object |
reset ()
Code sample
Create a polyline feature class from scratch.
import arcpy
# A list of features and coordinate pairs
feature_info = [[[1, 2], [2, 4], [3, 7]],
[[6, 8], [5, 7], [7, 2], [9, 5]]]
# A list that will hold each of the Polyline objects
features = []
for feature in feature_info:
# Create a Polyline object based on the array of points
# Append to the list of Polyline objects
features.append(
arcpy.Polyline(
arcpy.Array([arcpy.Point(*coords) for coords in feature])))
# Persist a copy of the Polyline objects using CopyFeatures
arcpy.CopyFeatures_management(features, "c:/geometry/polylines.shp")