Skip main navigation

Creating and accessing NumPy arrays

In this article we show how to create and access NumPy arrays.

NumPy arrays have a fixed number of elements and all the elements have the same datatype, both specified when creating the array.

Even though the number of elements is fixed, the shape of the array can be changed as long as the number of elements remains the same.

Creating arrays

From existing data

NumPy arrays can be created in several different ways. The simplest way is to use the array constructor and provide the data directly as an argument. For example, in order to generate a one-dimensional array containing the numbers 1,2,3,4 one can use:

import numpy
x = numpy.array((1, 2, 3, 4))

This will generate a NumPy array containing four elements of integer type.

Unless explicitly specified, the datatype is automatically set based on the
values used to create the array. In this case they were all integers and thus
integer type was used. If the list would have contained one floating point
number (e.g. [1, 2, 3.1, 4]) then the array created would have used floating
point type for all elements.

The first argument of array() is the data for the array. It can be a single
list (or tuple), or a nested list of uniformly sized lists that mimics a
multi-dimensional array.

The second argument of array() is the datatype to be used for the array. It
can be one of the basic datatypes in Python (int, float etc.) or it can be
one of the more precise datatypes used internally by NumPy (numpy.int8,
numpy.float128 etc.). If the second argument is not given, a datatype that
can represent all the input data is selected automatically.

x = numpy.array((1, 2, 3, 4), float)

# output: [ 1. 2. 3. 4.]
data = [[1, 2, 3], [4, 5, 6]]
y = numpy.array(data, complex)

# output: [[ 1.+0.j 2.+0.j 3.+0.j]
# [ 4.+0.j 5.+0.j 6.+0.j]]

# output: (2, 3)

# output: 6

Using helper functions

NumPy also provides quite a few handy helper functions that can be used to
generate the kinds of number sequences often used or to initialise the array
with in a given way.

Two extremely helpful functions for generating ranges of numbers are called
arange and linspace.

Similar to the regular range() function, numpy.arange() creates an array
containing evenly spaces values within a given interval.

a = numpy.arange(10)

# output: [0 1 2 3 4 5 6 7 8 9]

Optionally, one can also specify start and stop values (instead of just stop)
as well as a step between the values. It is also not limited to integers, but
can handle floating point numbers just as well.

Another common need is to generate a fixed number of evenly spaced values
within an interval, which is exactly what numpy.linspace() does.

b = numpy.linspace(-4.5, 4.5, 5)

# output: [-4.5 -2.25 0. 2.25 4.5]

One can also create an array of a given shape and initialise it to zeros, ones , or arbitrary value using the handy functions zeros, ones, or full.

c = numpy.zeros((4, 6), float)
d = numpy.ones((2, 4))
e = numpy.full((3, 2), 4.2)

# output:
# (4, 6)
# [[ 1. 1. 1. 1.]
# [ 1. 1. 1. 1.]]
# [[4.2 4.2]
# [4.2 4.2]
# [4.2 4.2]]

One can also create a truly empty array by using the function empty. This
will create an array and allocate memory for it, but not assign any values to
it. In practice, this means that the values of an empty array are unspecified
(whatever happened to be in the computer memory allocated to the array). Thus,
if one uses empty, it is crucial to always assign values to all the
elements before trying to use them.

In addition to numbers, NumPy supports also storing non-numerical data, e.g.
strings. For strings, the largest element determines the item size, so in
practice arbitrary strings are not that suitable, but character arrays can be
sometimes useful.

s = numpy.array(['foo', 'foo-bar'])

# output: array(['foo', 'foo-bar'],
# dtype='|U7')

c = numpy.array(dna, dtype='c')

# output:
# array([b'A', b'A', b'A', b'G', b'T', b'C', b'T', b'G', b'A', b'C'],
# dtype='|S1')

Accessing arrays

NumPy arrays can be accessed in a similar way to normal Python lists. Only
key difference stems from the fact that NumPy arrays can be truly
multi-dimensional. This means that instead of a single index value, elements
in a NumPy array can have multiple index values (one for each dimension).

To access a single element in a 2D array, one should use the index value in
each dimension separated by a comma:

data = numpy.array([[1, 2, 3], [4, 5, 6]])
x = data[0,2]
y = data[1,-2]

print(x, y)
# output: 3 5

Slicing syntax can also be used with NumPy arrays to select only some part of
the array.

a = numpy.arange(10)

# output: [2 3 4 5 6 7 8 9]

# output: [0 1 2 3 4 5 6 7 8]

# output: [1 3 5]

Multi-dimensional arrays can be sliced, too, and in multiple dimensions as
well. One can also assign values to only some part of an array using the
slicing syntax.

a = numpy.arange(10)
a[1:3] = -1

b = numpy.zeros((4, 4))
b[1:3, 1:3] = 2.0

# output:
# [ 0 -1 -1 3 4 5 6 7 8 9]
# [[ 0. 0. 0. 0.]
# [ 0. 2. 2. 0.]
# [ 0. 2. 2. 0.]
# [ 0. 0. 0. 0.]]

Views and copies of arrays

Simple assignment creates a new reference to an array, just like for any other
Python object. Thus, if you modify the array using the new reference, the
changes are visible also via any old reference to the same array.

To make a true copy of an array, one should use the copy() method:

a = np.arange(10)
b = a # reference, changing values in b changes a
b = a.copy() # true copy

In contrast, slicing an array will create something called a view to the
array. It is like a window showing only a some part of the full array. Any
modifications to the elements in the view are directly reflected in the
original array. In fact, no real copy is made and as such any manipulation
will just change the original array.

Once again, to make a true copy, one should use the copy() method:

a = np.arange(10)
c = a[1:4] # view, changing c changes elements [1:4] of a
c = a[1:4].copy() # true copy of subarray

In what situations you think it is better to copy and when is a view better? Please comment!

© CC-BY-NC-SA 4.0 by CSC - IT Center for Science Ltd.
This article is from the free online

Python in High Performance Computing

Created by
FutureLearn - Learning For Life

Reach your personal and professional goals

Unlock access to hundreds of expert online courses and degrees from top universities and educators to gain accredited qualifications and professional CV-building certificates.

Join over 18 million learners to launch, switch or build upon your career, all at your own pace, across a wide range of topic areas.

Start Learning now