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

说明

如果以下等式按元素为 True,则 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