numpy.ma.masked_all#

ma.masked_all(shape, dtype=<class 'float'>)[source]#

所有元素都被掩码的空掩码数组。

返回给定形状和 dtype 的空掩码数组,其中所有数据都被掩码。

参数:
shapeint 或 int 元组

所需 MaskedArray 的形状,例如 (2, 3)2

dtypedtype,可选

输出的数据类型。

返回值:
aMaskedArray

所有数据都被掩码的掩码数组。

参见

masked_all_like

根据现有数组建模的空掩码数组。

备注

与其他掩码数组创建函数(例如 numpy.ma.zerosnumpy.ma.onesnumpy.ma.full)不同,masked_all 不会初始化数组的值,因此可能略快一些。但是,新分配的数组中存储的值是任意的。为了获得可重复的结果,请确保在读取之前设置数组的每个元素。

示例

>>> import numpy as np
>>> np.ma.masked_all((3, 3))
masked_array(
  data=[[--, --, --],
        [--, --, --],
        [--, --, --]],
  mask=[[ True,  True,  True],
        [ True,  True,  True],
        [ True,  True,  True]],
  fill_value=1e+20,
  dtype=float64)

dtype 参数定义底层数据类型。

>>> a = np.ma.masked_all((3, 3))
>>> a.dtype
dtype('float64')
>>> a = np.ma.masked_all((3, 3), dtype=np.int32)
>>> a.dtype
dtype('int32')