numpy.ma.allclose#

ma.allclose(a, b, masked_equal=True, rtol=1e-05, atol=1e-08)[源代码]#

如果两个数组在容差范围内逐元素相等,则返回 True.

此函数等同于 allclose ,不同之处在于掩码值被视为相等(默认)或不相等,具体取决于 masked_equal 参数.

参数:
a, barray_like

要比较的输入数组.

masked_equalbool, 可选

ab 中的掩码值是否被认为是相等的(True)或不相等的(False).默认情况下,它们被认为是相等的.

rtolfloat, 可选

相对容差.相对差异等于 rtol * b.默认值是 1e-5.

atolfloat, 可选

绝对容差.绝对差异等于 atol.默认值是 1e-8.

返回:
ybool

如果两个数组在给定的容差范围内相等,则返回 True,否则返回 False.如果任一数组包含 NaN,则返回 False.

参见

all, any
numpy.allclose

非掩码的 allclose.

备注

如果以下等式在元素级别上为真,则 allclose 返回 True:

absolute(`a` - `b`) <= (`atol` + `rtol` * absolute(`b`))

如果 ab 的所有元素在给定的容差范围内相等,则返回 True.

示例

>>> import numpy as np
>>> a = np.ma.array([1e10, 1e-7, 42.0], mask=[0, 0, 1])
>>> a
masked_array(data=[10000000000.0, 1e-07, --],
             mask=[False, False,  True],
       fill_value=1e+20)
>>> b = np.ma.array([1e10, 1e-8, -42.0], mask=[0, 0, 1])
>>> np.ma.allclose(a, b)
False
>>> a = np.ma.array([1e10, 1e-8, 42.0], mask=[0, 0, 1])
>>> b = np.ma.array([1.00001e10, 1e-9, -42.0], mask=[0, 0, 1])
>>> np.ma.allclose(a, b)
True
>>> np.ma.allclose(a, b, masked_equal=False)
False

掩码值不会直接进行比较.

>>> a = np.ma.array([1e10, 1e-8, 42.0], mask=[0, 0, 1])
>>> b = np.ma.array([1.00001e10, 1e-9, 42.0], mask=[0, 0, 1])
>>> np.ma.allclose(a, b)
True
>>> np.ma.allclose(a, b, masked_equal=False)
False