Méthodes mathématiques

A partir du module math, vous avez accès à des méthodes mathématiques utiles. Certaines de ces méthodes sont présentées dans le tableau suivant. Sauf indication contraire, toutes les valeurs sont renvoyées en tant que variables flottantes.

Tableau 1. Méthodes mathématiques
Méthode Utilisation
math.ceil(x) Renvoie la partie entière par excès de x en tant que variable flottante, c'est-à-dire le plus petit entier supérieur ou égal à x.
math.copysign(x, y) Renvoie x avec le signe de y. copysign(1, -0.0) renvoie -1.
math.fabs(x) Renvoie la valeur absolue de x.
math.factorial(x) Renvoie la factorielle de x. Si x est négatif ou n'est pas un entier, une erreur ValueError est renvoyée.
math.floor(x) Renvoie la partie entière par défaut de x en tant que variable flottante, c'est-à-dire le plus grand entier inférieur ou égal à x.
math.frexp(x) Renvoie la mantisse (m) et l'exposant (e) de x en tant que paire (m, e). m est une variable flottante et e est un entier, tel que x == m * 2**e exactement. Si x est égal à zéro, renvoie (0.0, 0), sinon 0.5 <= abs(m) < 1.
math.fsum(iterable) Renvoie une somme de valeurs à virgule flottante précise dans iterable.
math.isinf(x) Vérifie si la variable flottante x est un infinitif positif ou négatif.
math.isnan(x) Vérifie si la variable flottante x n'est pas un nombre, à savoir NaN (not a number).
math.ldexp(x, i) Renvoie x * (2**i). Il s'agit pour l'essentiel de l'inverse de la fonction frexp.
math.modf(x) Renvoie les parties fractionnelle et entière de x. Les deux résultats portent le signe de x et sont des variables flottantes.
math.trunc(x) Renvoie la valeur réelle (Real) x, qui a été tronquée en intégrale (Integral).
math.exp(x) Renvoie e**x.
math.log(x[, base]) Renvoie le logarithme de x à la valeur donnée de base. Si base n'est pas spécifié, le logarithme naturel de x est renvoyé.
math.log1p(x) Renvoie le logarithme naturel de 1+x (base e).
math.log10(x) Renvoie le logarithme de base 10 de x.
math.pow(x, y) Renvoie x élevé à la puissance y. pow(1.0, x) et pow(x, 0.0) renvoient toujours 1, même lorsque x est égal à zéro ou n'est pas un nombre (NaN).
math.sqrt(x) Renvoie la racine carrée de x.

Outre les fonctions mathématiques, il existe certaines méthodes trigonométriques utiles. Ces méthodes sont présentées dans le tableau suivant.

Tableau 2. Méthodes trigonométriques
Méthode Utilisation
math.acos(x) Renvoie le cosinus inverse de x en radians.
math.asin(x) Renvoie le sinus inverse de x en radians.
math.atan(x) Renvoie la tangente inverse de x en radians.
math.atan2(y, x) Renvoie atan(y / x) en radians.
math.cos(x) Renvoie le cosinus de x en radians.
math.hypot(x, y) Renvoie la norme euclidienne sqrt(x*x + y*y). Il s'agit de la longueur du vecteur de l'origine jusqu'au point (x, y).
math.sin(x) Renvoie le sinus de x en radians.
math.tan(x) Renvoie la tangente de x en radians.
math.degrees(x) Convertit l'angle x de radians en degrés.
math.radians(x) Convertit l'angle x de degrés en radians.
math.acosh(x) Renvoie le cosinus hyperbolique inverse de x.
math.asinh(x) Renvoie le sinus hyperbolique inverse de x.
math.atanh(x) Renvoie la tangente hyperbolique inverse de x.
math.cosh(x) Renvoie le cosinus hyperbolique de x.
math.sinh(x) Renvoie le cosinus hyperbolique de x.
math.tanh(x) Renvoie la tangente hyperbolique de x.

Il existe également deux constantes mathématiques. La valeur de math.pi est la constante mathématique pi. La valeur de math.e est la constante mathématique e.