`numpy:squeeze`

Signature

def squeeze ( a , axis = None )

Remove axes of length one from a.

a : array_like: Input data.
axis : None or int or tuple of ints, optional: Selects a subset of the entries of length one in the shape. If an axis is selected with shape entry greater than one, an error is raised.

squeezed : ndarray: The input array, but with all or a subset of the dimensions of length 1 removed. This is always a itself or a view into a. Note that if all axes are squeezed, the result is a 0d array and not a scalar.

: ValueError: If axis is not None, and an axis being squeezed is not of length 1

import numpy as np
x = np.array([[[0], [1], [2]]])
x.shape
np.squeeze(x).shape
np.squeeze(x, axis=0).shape

✓

np.squeeze(x, axis=1).shape

✗

np.squeeze(x, axis=2).shape
x = np.array([[1234]])
x.shape

✓

np.squeeze(x)

✗

np.squeeze(x).shape

✓

np.squeeze(x)[()]