Spec-Zone.ru › NumPy 1.14

numpy.allclose

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

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

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

Если любой из массивов содержит одно или несколько NaN, возвращается False. Бесконечности (inf) считаются равными, если они находятся в одном месте и имеют одинаковый знак в обоих массивах.

Параметры:

a, b : array_like

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

rtol : float

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

atol : float

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

equal_nan : bool

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

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

Возвращает:

allclose : bool

Возвращает 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.

Примеры

>>> 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

© 2005–2019 NumPy Developers
Licensed under the 3-clause BSD License.
https://docs.scipy.org/doc/numpy-1.14.5/reference/generated/numpy.allclose.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API