Metody matematyczne

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

Tabela 1. Metody matematyczne
Metoda Wykorzystanie
math.ceil(x) Zwraca maksymalną wartość x jako liczbę zmiennopozycyjną, która jest najmniejszą liczbą całkowitą równą x lub od niej większą.
math.copysign(x, y) Zwraca wartość x ze znakiem wartości y. copysign(1, -0.0) zwraca wartość -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 minimalną wartość x jako liczbę zmiennopozycyjną, która jest największą liczbą całkowitą równą x lub od niej mniejszą.
math.frexp(x) Zwraca mantysę (m) i wykładnik (e) wartości 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 ma wartość zero, zwraca (0.0, 0). W przeciwnym razie zwraca 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ść Real wartości x, która została obcięta do wartości Integral.
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 wartości 1+x (base e)
math.log10(x) Zwraca logarytm x o podstawie 10
math.pow(x, y) Zwraca wartość x podniesioną do potęgi y. pow(1.0, x) i pow(x, 0.0) zawsze zwracają wartość 1, nawet jeśli x ma wartość zero lub wartość nieokreśloną.
math.sqrt(x) Zwraca pierwiastek kwadratowy x

Wraz z funkcjami matematycznymi, są też pewne przydatne metody trygonometryczne. Metody te są wymienione w poniższej tabeli.

Tabela 2. Metody trygonometryczne
Metoda Wykorzystanie
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 normę 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.