assert_isapprox

Vérifie que les valeurs calculées et attendues sont approximativement égales.

📝Syntaxe

assert_isapprox(computed, expected)
assert_isapprox(computed, expected, precision)
res = assert_isapprox(computed, expected)
res = assert_isapprox(computed, expected, precision)
[res, msg] = assert_isapprox(computed, expected)
[res, msg] = assert_isapprox(computed, expected, precision)

📥Arguments d'entrée

Paramètre	Description
computed	une valeur numérique : matrice, double creux ou tableau multidimensionnel.
expected	une valeur numérique : matrice, double creux ou tableau multidimensionnel.
precision	une valeur double spécifiant la tolérance relative. La précision par défaut est 0.

📤Arguments de sortie

Paramètre	Description
res	une valeur logique : true si les valeurs sont approximativement égales, false sinon.
msg	une chaîne contenant le message d'erreur. Si res == true, alors msg == ''. Si res == false, alors msg contient le message d'échec de l'assertion.

📄Description

assert_isapprox lève une erreur si la valeur calculée n'est pas approximativement égale à la valeur attendue.

Cette fonction compare deux nombres à virgule flottante avec une tolérance spécifiée, permettant de vérifier que deux nombres sont « approximativement » égaux lorsque l'égalité exacte n'est pas adaptée à cause des limitations de précision des flottants.

La comparaison utilise le calcul de l'erreur relative pour déterminer si les valeurs sont dans la tolérance de précision spécifiée.

Cette fonction est particulièrement utile dans les tests unitaires lors de calculs numériques pouvant comporter de petits arrondis.

💡Exemples

Test d'égalité approximative avec une tolérance de précision suffisante :

assert_isapprox(1.23456, 1.23457, 1e-5)

Test qui échoue lorsque la précision est trop stricte :

try
    assert_isapprox(1.23456, 1.23457, 1e-6)
catch ME
    disp(['Error: ' ME.message])
end

Utilisation des valeurs de retour pour gérer les résultats d'assertion :

[r, msg] = assert_isapprox(1.23456, 1.23457, 1e-6);
assert_isfalse(r);
assert_isequal(msg, _('Assertion failed: expected and computed values are too different.'));

Test avec des matrices :

A = [1.0001, 2.0002; 3.0003, 4.0004];
B = [1.0000, 2.0000; 3.0000, 4.0000];
assert_isapprox(A, B, 1e-3)

🔗Voir aussi

isapprox assert_isequal

Used Functions

isapprox

🕔Historique des versions

Version	Description
1.0.0	version initiale

Modifier cette page sur GitHub