numpy.ma.masked_object

ma.masked_object(x, value, copy=True, shrink=True)

遮罩陣列 x 中資料與 value 完全相等之處。

此函數與 masked_values 相似，但僅適用於物件陣列：對於浮點數，請改用 masked_values。

參數：

xarray_like

要遮罩的陣列

valueobject

比較值

copy{True, False}, 選用

是否傳回 x 的副本。

shrink{True, False}, 選用

是否將全為 False 的遮罩摺疊為 nomask

傳回值：

resultMaskedArray

遮罩 x 中等於 value 之處的結果。

另請參閱

masked_where

遮罩符合條件之處。

masked_equal

遮罩等於給定值之處 (整數)。

masked_values

使用浮點等式進行遮罩。

範例

>>> import numpy as np
>>> import numpy.ma as ma
>>> food = np.array(['green_eggs', 'ham'], dtype=object)
>>> # don't eat spoiled food
>>> eat = ma.masked_object(food, 'green_eggs')
>>> eat
masked_array(data=[--, 'ham'],
             mask=[ True, False],
       fill_value='green_eggs',
            dtype=object)
>>> # plain ol` ham is boring
>>> fresh_food = np.array(['cheese', 'ham', 'pineapple'], dtype=object)
>>> eat = ma.masked_object(fresh_food, 'green_eggs')
>>> eat
masked_array(data=['cheese', 'ham', 'pineapple'],
             mask=False,
       fill_value='green_eggs',
            dtype=object)

請注意，如果可能，mask 會設定為 nomask。

>>> eat
masked_array(data=['cheese', 'ham', 'pineapple'],
             mask=False,
       fill_value='green_eggs',
            dtype=object)