numpy.ma.MaskedArray.filled#

方法

ma.MaskedArray.filled(fill_value=None)[source]#

返回自身的一个副本,其中掩码值填充为给定值。**但是**,如果没有掩码值需要填充,则将自身作为 ndarray 返回。

参数:
fill_valuearray_like,可选

用于无效条目的值。可以是标量或非标量。如果是非标量,则生成的 ndarray 必须能够广播到输入数组上。默认为 None,在这种情况下,将使用数组的 fill_value 属性。

返回值:
filled_arrayndarray

一个 self 的副本,其中无效条目替换为 fill_value(无论是函数参数还是 self 的属性),或者如果没有任何无效条目需要替换,则返回 self 本身作为 ndarray。

注释

结果**不是** MaskedArray!

示例

>>> import numpy as np
>>> x = np.ma.array([1,2,3,4,5], mask=[0,0,1,0,1], fill_value=-999)
>>> x.filled()
array([   1,    2, -999,    4, -999])
>>> x.filled(fill_value=1000)
array([   1,    2, 1000,    4, 1000])
>>> type(x.filled())
<class 'numpy.ndarray'>

子类化被保留。这意味着如果,例如,掩码数组的数据部分是 recarray,则 filled 返回 recarray

>>> x = np.array([(-1, 2), (-3, 4)], dtype='i8,i8').view(np.recarray)
>>> m = np.ma.array(x, mask=[(True, False), (False, True)])
>>> m.filled()
rec.array([(999999,      2), (    -3, 999999)],
          dtype=[('f0', '<i8'), ('f1', '<i8')])