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