numpy.atleast_3d

numpy.atleast_3d(*arys)[source]

Представление входных данных как массивов с как минимум тремя измерениями.

Параметры

arys1, arys2, …array_like

Одна или более последовательностей типа массив. Входные данные, не являющиеся массивами, преобразуются в массивы. Массивы, которые уже имеют три или более измерения, сохраняются.

Возвращает

res1, res2, …ndarray

Массив или список массивов, каждый с как минимум тремя измерениями. Копии избегаются, где это возможно, а представления с тремя или более измерениями возвращаются. Например, одномерный массив с формой (N,) преобразуется в представление с формой (1, N, 1), а двумерный массив с формой (M, N) преобразуется в представление с формой (M, N, 1).

См. также

atleast_1d, atleast_2d

Примеры

>>> np.atleast_3d(3.0)
array([[[3.]]])

>>> x = np.arange(3.0)
>>> np.atleast_3d(x).shape
(1, 3, 1)

>>> x = np.arange(12.0).reshape(4,3)
>>> np.atleast_3d(x).shape
(4, 3, 1)
>>> np.atleast_3d(x).base is x.base  # x is a reshape, so not base itself
True

>>> for arr in np.atleast_3d([1, 2], [[1, 2]], [[[1, 2]]]):
...     print(arr, arr.shape) 
...
[[[1]
  [2]]] (1, 2, 1)
[[[1]
  [2]]] (1, 2, 1)
[[[1 2]]] (1, 1, 2)