numpy.ma.masked_all#

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

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

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

参数:
shape整数或整数的元组

所需的 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')