numpy.ma.is_mask#

ma.is_mask(m)[source]#

如果 m 是有效的標準遮罩，則傳回 True。

此函數不檢查輸入的內容，僅檢查類型是否為 MaskType。特別是，如果遮罩具有彈性 dtype，此函數會傳回 False。

參數：:

m陣列型物件: 要測試的陣列。

傳回：:

result布林值: 如果 m.dtype.type 是 MaskType，則為 True，否則為 False。

另請參閱

ma.isMaskedArray: 測試輸入是否為 MaskedArray 的實例。

範例

>>> import numpy as np
>>> import numpy.ma as ma
>>> m = ma.masked_equal([0, 1, 0, 2, 3], 0)
>>> m
masked_array(data=[--, 1, --, 2, 3],
             mask=[ True, False,  True, False, False],
       fill_value=0)
>>> ma.is_mask(m)
False
>>> ma.is_mask(m.mask)
True

輸入必須是 ndarray（或具有類似屬性）才能被視為有效的遮罩。

>>> m = [False, True, False]
>>> ma.is_mask(m)
False
>>> m = np.array([False, True, False])
>>> m
array([False,  True, False])
>>> ma.is_mask(m)
True

具有複數 dtype 的陣列不會傳回 True。

>>> dtype = np.dtype({'names':['monty', 'pithon'],
...                   'formats':[bool, bool]})
>>> dtype
dtype([('monty', '|b1'), ('pithon', '|b1')])
>>> m = np.array([(True, False), (False, True), (True, False)],
...              dtype=dtype)
>>> m
array([( True, False), (False,  True), ( True, False)],
      dtype=[('monty', '?'), ('pithon', '?')])
>>> ma.is_mask(m)
False