numpy.ma.allclose

numpy.ma.allclose(a, b, masked_equal=True, rtol=1e-05, atol=1e-08) [source]

Возвращает True, если два массива по элементам равны в пределах заданной погрешности.

Эта функция эквивалентна allclose, за исключением того, что значения с маской обрабатываются как равные (по умолчанию) или неравные, в зависимости от аргумента masked_equal.

Параметры:

a, b : array_like Входные массивы для сравнения. masked_equal : bool, необязательно Определяет, считаются ли значения с маской в a и b равными (True) или нет (False). По умолчанию они считаются равными. rtol : float, необязательно Относительная погрешность. Относительная разница равна rtol * b. Значение по умолчанию — 1e-5. atol : float, необязательно Абсолютная погрешность. Абсолютная разница равна atol. Значение по умолчанию — 1e-8.

Возвращает:

y : bool Возвращает True, если два массива равны в пределах заданной погрешности, иначе False. Если любой из массивов содержит NaN, то возвращается False.

См. также

all, any

numpy.allclose

немаскированный аналог allclose.

Примечания

Если следующее уравнение истинно по элементам, то allclose возвращает True:

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

Возвращает True, если все элементы a и b равны с учётом заданных погрешностей.

Примеры

>>> a = 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 = ma.array([1e10, 1e-8, -42.0], mask=[0, 0, 1])
>>> ma.allclose(a, b)
False

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

Значения с маской напрямую не сравниваются.

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