numpy.ma.is_mask#

ma.is_mask(m)[源代码]#

如果 m 是一个有效的、标准的掩码,则返回 True.

此函数不检查输入的内容,只检查类型是否为 MaskType.特别是,如果掩码具有灵活的 dtype,此函数返回 False.

参数:
marray_like

数组以进行测试.

返回:
resultbool

如果 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

具有复杂dtypes的数组不会返回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