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, optional Указывается, считаются ли значения с маской в a и b равными (True) или нет (False). По умолчанию они считаются равными. rtol : float, optional Относительная точность. Относительное различие равно rtol * b. По умолчанию равно 1e-5. atol : float, optional Абсолютная точность. Абсолютное различие равно 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 = 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