This is an archived version of the course. Please find the latest version of the course on the main webpage.

Chapter 4: Array reshaping

Adding a new axis

face Josiah Wang

Ah, I feel better squeezing that singleton dimension out of my system!

But wait… apparently the singleton dimension could be useful after all!

Mission 6: Put that lonely singleton back into the array

So now I have an (M \times K \times N) array called x.

And an (M \times N) array called y.

I need to add these two arrays, but unfortunately I cannot do so because their dimensions do not match!

>>> import numpy as np
>>> x = np.random.random_sample((10, 8, 5))
>>> y = np.random.random_sample((10, 5))
>>> print(x.shape)
(10, 8, 5)
>>> print(y.shape)
(10, 5)
>>> z = x + y
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ValueError: operands could not be broadcast together with shapes (10,8,5) (10,5)

I think y.reshape(10, 1, 5) can solve this. NumPy can then perform its array broadcasting magic to add x and y. But I find it a hassle having to explicitly specify the sizes of M (10) and N (5) each time. And they can change any time too! y.reshape(-1, 1, -1) will not work because there can at most be only one -1.

Is there an easier way to add a new singleton dimension to y?

This is your final mission to pass your probation. Help me find a better way to solve this issue!

Hint: A little bird told me that the answer can be found on this page in the official documentation

The first possible solution is to use array indexing, specifying the np.newaxis object where you want to add the dimension. The array will be ‘expanded’ at that axis.

Apparently np.newaxis is just an alias for None, which you can also use to achieve the same effect.

>>> expanded_y = y[:, np.newaxis, :]
>>> print(expanded_y.shape)
(10, 1, 5)
>>> z = x + expanded_y

>>> expanded_y = y[:, None, :]
>>> print(expanded_y.shape)
(10, 1, 5)
>>> z = x + expanded_y

Another solution is to use the np.expand_dims() function to achieve the same thing.

>>> expanded_y = np.expand_dims(y, axis=1)
>>> print(expanded_y.shape)
(10, 1, 5)

The np.newaxis approach has an advantage though. You can add expand multiple dimensions simultaneously! You will have to do it multiple times for np.expand_dims().

>>> expanded_y = y[np.newaxis, :, np.newaxis, np.newaxis, :]
>>> print(expanded_y.shape)
(1, 10, 1, 1, 5)

Another practical use is to easily convert a vector (1D array) to a 2D array. For example, you may need to perform matrix multiplication, which you cannot do with a 1D array.

>>> x = np.array([1, 2, 3])
>>> y = np.array([[4, 5, 6]])
>>> print(x.shape)
(3, )
>>> print(y.shape)
(1, 3) 
>>> x_new = x[:, np.newaxis]
>>> print(x_new.shape)
(3, 1)
>>> print(x @ y)
[[ 4  5  6]
 [ 8 10 12]
 [12 15 18]