This is a pre-release version (2.5.0.dev0+git20251130.2de293a). Go to latest (2.4.4)
{ } Raw JSON

bundles / numpy 2.5.0.dev0+git20251130.2de293a / numpy / expand_dims

_ArrayFunctionDispatcher

numpy:expand_dims

source: /dev/numpy/build-install/usr/lib/python3.14/site-packages/numpy/lib/_shape_base_impl.py :515

Signature

def   expand_dims ( a axis )

Summary

Expand the shape of an array.

Extended Summary

Insert a new axis that will appear at the axis position in the expanded array shape.

Parameters

a : array_like

Input array.

axis : int or tuple of ints

Position in the expanded axes where the new axis (or axes) is placed.

Returns

result : ndarray

View of a with the number of dimensions increased.

Examples

import numpy as np
x = np.array([1, 2])
x.shape
The following is equivalent to ``x[np.newaxis, :]`` or ``x[np.newaxis]``:
y = np.expand_dims(x, axis=0)
y
y.shape
The following is equivalent to ``x[:, np.newaxis]``:
y = np.expand_dims(x, axis=1)
y
y.shape
``axis`` may also be a tuple:
y = np.expand_dims(x, axis=(0, 1))
y
y = np.expand_dims(x, axis=(2, 0))
y
Note that some examples may use ``None`` instead of ``np.newaxis``. These are the same objects:
np.newaxis is None

See also

atleast_1d
atleast_2d
atleast_3d
reshape

Insert, remove, and combine dimensions, and resize existing ones

squeeze

The inverse operation, removing singleton dimensions

Aliases

  • numpy.expand_dims