numpy.ma.MaskedArray.filled

метод

MaskedArray.filled(self, fill_value=None) [source]

Возвращает копию self, с масками значений, заполненных заданным значением. Однако, если нет значений с маской для заполнения, вместо этого возвращается self как ndarray.

Параметры

fill_valuearray_like, optional

Значение, используемое для недействительных записей. Может быть скалярным или нескалярным. Если нескалярным, результирующий ndarray должен быть совместим с входным массивом. По умолчанию None, в этом случае используется атрибут fill_value массива.

Возвращает

filled_arrayndarray

Копия self с недействительными записями, замененными на fill_value (будь то аргумент функции или атрибут self), или сам self в виде ndarray, если нет недействительных записей для замены.

Примечания

Результат — не MaskedArray!

Примеры

>>> 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')])