DESCRIPTION.

Retourne True si deux valeur sont dans un écart donné, sinon False. 

SYNTAXE.

Valeur = math.isclose ( pivot , base , relatif , absolu ) 

Valeur = ⇨ variable qui recevra le résultat [ optionnel ]

math.isclose ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

pivot ⇨ valeur de référence  [ OBLIGATOIRE ]

base ⇨ valeur à comparer [ OBLIGATOIRE ]

relatif ⇨ écart relatif admissible [ optionnel ]

absolu ⇨ écart absolu admissible [ optionnel ]

REMARQUES.

pivot et base doivent être des valeurs numériques de type int ( ) ou un float ( ) quelconques mais valides.

relatif est un argument nommé rel_tol = toterance, où toterance est un float ( ) , toujours supérieur à 0, représentant la fraction, en pourcentage de la plus grande valeur entre pivot et base, qui sera admise pour considérer que les deux valeurs appartiennent au même intervalle. Par exemple, si l'on souhaite savoir si pivot et base ont une différence maximum de 12%, ont indiquera rel_tol = .12. Par défaut, tolérance vaut 1e-09, cela assure que deux valeurs seront du même intervalles à partir de la 9e décimale.

absolu est un argument nommé abs_tol = toterance, où toterance est un float ( ), positif, donnant l'écart minimale qui devra exister entre pivot et base, pour considérer que les deux valeurs appartiennent au même intervalle. Par exemple, si l'on souhaite savoir si pivot et base ont une différence minimal de 4 unités, ont indiquera abs_tol = 4. 

relatif et/ou absolu peuvent être omis, mais si les deux argument sont absent, la méthode math.isclose ( ) utilisera les valeurs par défaut de ces arguments pour retourner un booléen.

La méthode math.isclose ( ) retourne toujours un bool ( ). La valeur retournée par la méthode math.isclose ( ) équivaut à :

abs ( pivot - base ) <= max ( ( rel_tol * max ( abs ( pivot ) , abs ( base ) ) ) , abs_tol ).

La méthode math.isclose ( ) est principalement utilisée pour savoir si deux résultats sont quasi égaux, afin de ne pas tenir compte d'erreur qui pourrait provenir par exemple d'arrondis malheureux.

EXEMPLES.

import math

print ( math.isclose ( 87 , 96 , rel_tol = .08 , abs_tol = 11 ) ) retourne True

print ( math.isclose ( 87 , 96 , rel_tol = .08 ) ) retourne False

print ( math.isclose ( 87 , 96 , abs_tol = 11 ) ) retourne True

print ( math.isclose ( 87 , 96 ) ) retourne False