numpy.allclose

numpy.allclose(a, b, rtol=1e-05, atol=1e-08, equal_nan=False)[source]

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

Значения погрешности положительны, обычно очень малы. Относительная разность (rtol * abs(b)) и абсолютная разность atol складываются для сравнения с абсолютной разностью между a и b.

NaNs обрабатываются как равные, если они находятся на одном месте и если equal_nan=True. Infs обрабатываются как равные, если они находятся на одном месте и имеют одинаковый знак в обоих массивах.

Параметры

a, barray_like

Входные массивы для сравнения.

rtolfloat

Параметр относительной погрешности (см. Примечания).

atolfloat

Параметр абсолютной погрешности (см. Примечания).

equal_nanbool

Указывает, следует ли сравнивать NaN как равные. Если True, NaN в a будут считаться равными NaN в b в выходном массиве.

Введено в версии 1.10.0.

Возвращает

allclosebool

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

См. также

isclose, all, any, equal

Примечания

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

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

Вышеприведенное уравнение несимметрично относительно a и b, поэтому allclose(a, b) может отличаться от allclose(b, a) в некоторых редких случаях.

Сравнение a и b использует стандартное векторизованное умножение, что означает, что a и b не обязательно должны иметь одинаковую форму, чтобы allclose(a, b) оценивалось как True. То же самое верно для equal, но не для array_equal.

allclose не определено для нечисловых типов данных.

Примеры

>>> np.allclose([1e10,1e-7], [1.00001e10,1e-8])
False
>>> np.allclose([1e10,1e-8], [1.00001e10,1e-9])
True
>>> np.allclose([1e10,1e-8], [1.0001e10,1e-9])
False
>>> np.allclose([1.0, np.nan], [1.0, np.nan])
False
>>> np.allclose([1.0, np.nan], [1.0, np.nan], equal_nan=True)
True