Python numpy ma.atleast_3d用法及代碼示例

本文簡要介紹 python 語言中 numpy.ma.atleast_3d 的用法。

用法:

ma.atleast_3d(*args, **kwargs) = <numpy.ma.extras._fromnxfunction_allargs object>

將輸入視為至少具有三個維度的數組。

參數：

arys1, arys2, …： 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.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)