dask.array.ma.masked_values

dask.array.ma.masked_values

dask.array.ma.masked_values(x, value, rtol=1e-05, atol=1e-08, shrink=True)[源代码]

使用浮点数相等进行掩码。

此文档字符串是从 numpy.ma.masked_values 复制的。

Dask 版本可能存在一些不一致性。

返回一个 MaskedArray,其中数组 x 中的数据在 isclose 确定的条件下近似等于 value 时被掩码。masked_values 的默认容差与 isclose 的相同。

对于整数类型,使用精确相等,与 masked_equal 的方式相同。

如果可能,fill_value 设置为 value,掩码设置为 nomask

参数
xarray_like

数组到掩码。

浮动

掩码值。

rtol, atolfloat, 可选

传递给 isclose 的容差参数

复制bool, 可选 (Dask 不支持)

是否返回 x 的副本。

缩小bool, 可选

是否将充满 False 的掩码折叠为 nomask

返回
结果MaskedArray

掩码 x 的结果,其中大约等于 value

参见

masked_where

在满足条件的地方进行掩码处理。

masked_equal

掩码等于给定值的地方(整数)。

示例

>>> import numpy as np  
>>> import numpy.ma as ma  
>>> x = np.array([1, 1.1, 2, 1.1, 3])  
>>> ma.masked_values(x, 1.1)  
masked_array(data=[1.0, --, 2.0, --, 3.0],
             mask=[False,  True, False,  True, False],
       fill_value=1.1)

请注意,如果可能的话,mask 会被设置为 nomask

>>> ma.masked_values(x, 2.1)  
masked_array(data=[1. , 1.1, 2. , 1.1, 3. ],
             mask=False,
       fill_value=2.1)

masked_equal 不同,masked_values 可以执行近似相等性。

>>> ma.masked_values(x, 2.1, atol=1e-1)  
masked_array(data=[1.0, 1.1, --, 1.1, 3.0],
             mask=[False, False,  True, False, False],
       fill_value=2.1)