numpy.atleast_3d

numpy.atleast_3d(arys1, arys2, ..., arysN)

Функция atleast_3d() преобразует входные данные в массивы у которых по меньшей мере три измерения.

Параметры:
arys1, arys2, ..., arysN - подобные массивам объекты
Любые объекты которые могут быть преобразованы в массивы NumPy.
Возвращает:
ndarray или список ndarray - массив или список массивов NumPy
Массив или список массивов у которых по меньшей мере три измерения.
Смотрите так же: atleast_1d, atleast_2d

Замечание

Функция действует таким образом, что скалярные данные, одномерные и двумерные последовательности преобразуются в трехмерные массивы, в то время как структура данных с тремя и большим количеством измерений сохраняется, при этом сами многомерные данные так же преобразуются в массивы NumPy. К одномерным массивам оси добавляются слева и справа, к двумерным - справа.


Примеры

>>> import numpy as np
>>> 
>>> np.atleast_3d(1)
array([[[1]]])
>>> 
>>> np.atleast_3d(1, 2, 3)
[array([[[1]]]), array([[[2]]]), array([[[3]]])]
>>> 
>>>
>>> a = np.array([1, 2])
>>> a.shape
(2,)
>>> 
>>> b = np.atleast_3d(a)
>>> b
array([[[1],
        [2]]])
>>> 
>>> b.shape
(1, 2, 1)
>>> 
>>> 
>>> a = np.array([[1, 2]])
>>> a.shape
(1, 2)
>>> 
>>> b = np.atleast_3d(a)
>>> b
array([[[1],
        [2]]])
>>> b.shape
(1, 2, 1)
>>> 
>>> b is a
False
>>> 
>>>
>>> a = np.array([[[1, 2]]])
>>> b = np.atleast_3d(a)
>>> 
>>> b is a
True