Metody matematyczne

Moduł math zawiera użyteczne metody matematyczne. Niektóre z nich opisano w poniższej tabeli. O ile nie zaznaczono inaczej, wszystkie zwracane wartości są liczbami zmiennopozycyjnymi.

Tabela 1. Metody matematyczne
Metoda Zastosowanie
math.ceil(x) Zwraca, jako wartość zmiennopozycyjną, najmniejszą liczbę całkowitą nie mniejszą niż x.
math.copysign(x, y) Zwraca x ze znakiem argumentu y. copysign(1, -0.0) zwraca -1
math.fabs(x) Zwraca wartość bezwzględną x
math.factorial(x) Zwraca silnię x. Jeśli x jest liczbą ujemną lub niecałkowitą, generowany jest wyjątek ValueError.
math.floor(x) Zwraca, jako wartość zmiennopozycyjną, największą liczbę całkowitą nie większą niż x.
math.frexp(x) Zwraca mantysę (m) i wykładnik (e) argumentu x jako parę (m, e). m jest taką liczbą zmiennopozycyjną, a e jest taką liczbą całkowitą, że dokładnie spełniona jest zależność x == m * 2**e. Jeśli x jest równe zero, zwraca (0.0, 0), w przeciwnym razie 0.5 <= abs(m) < 1.
math.fsum(iterable) Zwraca dokładną zmiennopozycyjną sumę wartości zawartych w argumencie iterable
math.isinf(x) Sprawdza, czy zmiennopozycyjny argument x jest nieskończonością dodatnią lub ujemną
math.isnan(x) Sprawdza, czy zmiennopozycyjny argument x jest wartością nieliczbową NaN
math.ldexp(x, i) Zwraca x * (2**i). Jest to zasadniczo odwrócenie działania funkcji frexp.
math.modf(x) Zwraca część ułamkową i całkowitą argumentu x. Oba wyniki mają znak argumentu x i są liczbami zmiennopozycyjnymi.
math.trunc(x) Zwraca wartość rzeczywistą argumentu x, która została obcięta do części całkowitej.
math.exp(x) Zwraca e**x
math.log(x[, base]) Zwraca logarytm x o podstawie base. Jeśli wartość base nie jest określona, zwraca logarytm naturalny x.
math.log1p(x) Zwraca logarytm naturalny 1+x (o podstawie e)
math.log10(x) Zwraca logarytm x o podstawie 10
math.pow(x, y) Zwraca x do potęgi y. pow(1.0, x) i pow(x, 0.0) zawsze zwracają 1, nawet gdy x jest równe zero lub NaN.
math.sqrt(x) Zwraca pierwiastek kwadratowy x

Oprócz funkcji matematycznych dostępne są także użyteczne funkcje trygonometryczne. Zestawienie odpowiednich metod przedstawiono w poniższej tabeli.

Tabela 2. Metody trygonometryczne
Metoda Zastosowanie
math.acos(x) Zwraca arcus cosinus x w radianach
math.asin(x) Zwraca arcus sinus x w radianach
math.atan(x) Zwraca arcus tangens x w radianach
math.atan2(y, x) Zwraca atan(y / x) w radianach
math.cos(x) Zwraca cosinus x w radianach.
math.hypot(x, y) Zwraca normalną euklidesową sqrt(x*x + y*y). Jest to długość wektora od początku do punktu (x, y).
math.sin(x) Zwraca sinus x w radianach
math.tan(x) Zwraca tangens x w radianach
math.degrees(x) Przelicza kąt x z radianów na stopnie
math.radians(x) Przelicza kąt x ze stopni na radiany
math.acosh(x) Zwraca odwrotny cosinus hiperboliczny x
math.asinh(x) Zwraca odwrotny sinus hiperboliczny x
math.atanh(x) Zwraca odwrotny tangens hiperboliczny x
math.cosh(x) Zwraca cosinus hiperboliczny x
math.sinh(x) Zwraca cosinus hiperboliczny x
math.tanh(x) Zwraca tangens hiperboliczny x

Dostępne są także dwie stałe matematyczne. Wartość math.pi równa jest matematycznej stałej pi. Wartość math.e równa jest matematycznej stałej e.