numpy.ma.MaskedArray.filled

метод

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

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

Параметры:

fill_valuearray_like, необязательно

Значение, используемое для заполнения недопустимых элементов. Может быть скалярным или нескалярным. Если нескалярное, полученный 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')])