numpy.ma.atleast_3d

numpy.ma.atleast_3d(*arys) =

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

Параметры:	arys1, arys2, ... : array_like Одна или несколько последовательностей array-like. Входные данные, которые не являются массивами, преобразуются в массивы. Массивы, которые уже имеют три или более измерений, сохраняются.
Возвращаемые значения:	res1, res2, ... : ndarray Массив или кортеж массивов, каждый с a.ndim >= 3. Копии избегаются, где это возможно, и возвращаются представления с тремя или более измерениями. Например, одномерный массив формы (N,) становится представлением формы (1, N, 1), а двумерный массив формы (M, N) становится представлением формы (M, N, 1).

Примечания

Функция применяется как к данным (_data), так и к маске (_mask), если таковые имеются.

Примеры

>>> 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
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)