5.1 math --- Fonctions mathématiques

Ce module est toujours disponible. Il procure l'accès aux fonctions mathématiques définies par le C standard.

Ces fonctions ne peuvent pas être utilisées avec les nombres complexes; utilisez les fonctions de même nom du module cmath si vous avez besoin de traiter des nombres complexes. La distinction entre les fonctions qui supportent les nombres complexes et les autres est faite parce que la plupart des utilisateurs ne veulent pas apprendre tout ce qu'il faut savoir en mathématiques pour comprendre les nombres complexes. Recevoir une exception au lieu d'un résultat complexe permet une détection plus en amont des nombres complexes imprévus utilisés comme paramètres, de façon que le programmeur puisse déterminer comment et pourquoi elle a été générée en premier lieu.

Les fonctions suivantes sont fournies par ce module:

acos(x)
Retourne l'arc cosinus de x.

asin(x)
Retourne l'arc sinus de x.

atan(x)
Retourne l'arc tangente de x.

atan2(y, x)
Retourne atan(y / x).

ceil(x)
Retourne le plus petit entier supérieur ou égal au réel x.

cos(x)
Retourne le cosinus de x.

cosh(x)
Retourne le cosinus hyperbolique de x.

exp(x)
Retourne e**x.

fabs(x)
Retourne la valeur absolue du réel x.

floor(x)
Retourne le plus grand entier inférieur au réel x.

fmod(x, y)
Retourne fmod(x, y), tel que défini par la librairie C de la plateforme. Notez que l'expression Python x % y peut ne pas retourner le même résultat.

frexp(x)
Retourne la mantisse et l'exposant de x sous forme de la paire (m, e). m est un flottant et e un entier tels que x == m * 2**e. Si x vaut zéro, retourne (0.0, 0), sinon 0.5 <= abs(m) < 1.

hypot(x, y)
Retourne la distance euclidienne, sqrt(x*x + y*y).

ldexp(x, i)
Retourne x * (2**i).

log(x)
Retourne le logarithme naturel (népérien) de x.

log10(x)
Retourne le logarithme en base 10 de x.

modf(x)
Retourne les parties fractionnaire et entière de x. Les deux résultats portent le signe de x. La partie entière est retournée sous la forme d'un réel.

pow(x, y)
Retourne x**y.

sin(x)
Retourne le sinus de x.

sinh(x)
Retourne le sinus hyperbolique de x.

sqrt(x)
Retourne la racine carrée de x.

tan(x)
Retourne la tangente de x.

tanh(x)
Retourne la tangente hyperbolique de x.

Notez que frexp() et modf() ont un modèle d'appel et de retour différent de leurs équivalents en C: elles prennent un argument unique et retournent une paire de valeurs, plutôt que de retourner leur deuxième valeur à travers un "paramètre de sortie" (il n'existe rien de tel en Python).

Le module définit aussi deux constantes mathématiques:

pi
La constante mathématique pi.

e
La constante mathématique e.

Voir aussi:

Module cmath:
Versions pour nombres complexes de beaucoup de ces fonctions.