numpy.ma.masked_all#

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

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

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

参数:
shapeint 或 int 元组

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

dtype数据类型,可选

输出的数据类型。

返回:
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')