numpy.ma.masked_all_like#

ma.masked_all_like(arr)[原始碼]#

建立與現有陣列屬性相同的空遮罩陣列。

傳回與陣列 arr 具有相同形狀和 dtype 的空遮罩陣列，其中所有資料都被遮罩。

參數:

arrndarray: 描述所需 MaskedArray 的形狀和 dtype 的陣列。

傳回值:

aMaskedArray: 所有資料都被遮罩的遮罩陣列。

引發:

AttributeError: 如果 arr 沒有 shape 屬性 (即不是 ndarray)

參見

masked_all: 建立所有元素都被遮罩的空遮罩陣列。

註解

與其他遮罩陣列建立函數 (例如 numpy.ma.zeros_like、numpy.ma.ones_like、numpy.ma.full_like) 不同，masked_all_like 不會初始化陣列的值，因此可能稍微快一些。然而，新分配的陣列中儲存的值是任意的。為了獲得可重現的行為，請務必在讀取之前設定陣列的每個元素。

範例

>>> import numpy as np
>>> arr = np.zeros((2, 3), dtype=np.float32)
>>> arr
array([[0., 0., 0.],
       [0., 0., 0.]], dtype=float32)
>>> np.ma.masked_all_like(arr)
masked_array(
  data=[[--, --, --],
        [--, --, --]],
  mask=[[ True,  True,  True],
        [ True,  True,  True]],
  fill_value=np.float64(1e+20),
  dtype=float32)

遮罩陣列的 dtype 與 arr 的 dtype 相符。

>>> arr.dtype
dtype('float32')
>>> np.ma.masked_all_like(arr).dtype
dtype('float32')