numpy.ma.expand_dims

numpy.ma.expand_dims(a, axis) [source]

Расширение формы массива.

Вставляет новую ось, которая будет расположена в позиции axis в расширенной форме массива.

Примечание

Прежде чем NumPy 1.13.0, ни axis < -a.ndim - 1 ни axis > a.ndim не генерировали ошибки или не помещали новую ось в соответствующую позицию, как документировано. Сейчас значения этих осей устарели и в будущем будут вызывать исключение AxisError.

Параметры:	a : array_like Входной массив. axis : int Позиция в расширенных осях, где размещается новая ось.
Возвращает:	res : ndarray Вид a с увеличенным на один количеством измерений.

См. также

squeeze

Обратная операция, удаление осей размерности 1

reshape

Вставка, удаление и объединение измерений, и изменение размера существующих

doc.indexing, atleast_1d, atleast_2d, atleast_3d

Примеры

>>> x = np.array([1,2])
>>> x.shape
(2,)

Следующее эквивалентно x[np.newaxis,:] или x[np.newaxis]:

>>> y = np.expand_dims(x, axis=0)
>>> y
array([[1, 2]])
>>> y.shape
(1, 2)

>>> y = np.expand_dims(x, axis=1)  # Equivalent to x[:,np.newaxis]
>>> y
array([[1],
       [2]])
>>> y.shape
(2, 1)

Обратите внимание, что в некоторых примерах может использоваться None вместо np.newaxis. Это те же самые объекты:

>>> np.newaxis is None
True