`math.md`

562 строк · 47.4 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.15/library/math.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `math` – Математические функции89---1011Этот модуль предоставляет доступ к распространённым математическим функциям и константам, в том числе определённым стандартом C.1213Эти функции нельзя использовать с комплексными числами; если нужна поддержка комплексных чисел, используйте одноимённые функции из модуля [`cmath`](https://python-all.ru/3.15/library/cmath.html#module-cmath). Различие между функциями, поддерживающими комплексные числа, и теми, которые их не поддерживают, проведено потому, что большинству пользователей не нужно углубляться в математику, необходимую для понимания комплексных чисел. Получение исключения вместо комплексного результата позволяет раньше обнаружить непредвиденное комплексное число, переданное в качестве параметра, так что программист может выяснить, как и почему оно возникло.1415Модуль предоставляет следующие функции. Если не указано иное, все возвращаемые значения являются числами с плавающей запятой.1617| **Арифметика с плавающей запятой** |  |18| --- | --- |19| [`ceil(x)`](https://python-all.ru/3.15/library/math.html#math.ceil) | Потолок *x* – наименьшее целое число, большее или равное *x* |20| [`fabs(x)`](https://python-all.ru/3.15/library/math.html#math.fabs) | Абсолютное значение *x* |21| [`floor(x)`](https://python-all.ru/3.15/library/math.html#math.floor) | Пол *x* – наибольшее целое число, меньшее или равное *x* |22| [`fma(x, y, z)`](https://python-all.ru/3.15/library/math.html#math.fma) | Совмещённая операция умножения-сложения: `(x * y) + z` |23| [`fmax(x, y)`](https://python-all.ru/3.15/library/math.html#math.fmax) | Максимум двух значений с плавающей запятой |24| [`fmin(x, y)`](https://python-all.ru/3.15/library/math.html#math.fmin) | Минимум двух значений с плавающей запятой |25| [`fmod(x, y)`](https://python-all.ru/3.15/library/math.html#math.fmod) | Остаток от деления `x / y` |26| [`modf(x)`](https://python-all.ru/3.15/library/math.html#math.modf) | Дробная и целая части *x* |27| [`remainder(x, y)`](https://python-all.ru/3.15/library/math.html#math.remainder) | Остаток от деления *x* на *y* |28| [`trunc(x)`](https://python-all.ru/3.15/library/math.html#math.trunc) | Целая часть *x* |29| **Функции для работы с числами с плавающей запятой** |  |30| [`copysign(x, y)`](https://python-all.ru/3.15/library/math.html#math.copysign) | Модуль (абсолютное значение) *x* со знаком *y* |31| [`frexp(x)`](https://python-all.ru/3.15/library/math.html#math.frexp) | Мантисса и экспонента *x* |32| [`isclose(a, b, rel_tol, abs_tol)`](https://python-all.ru/3.15/library/math.html#math.isclose) | Проверяет, близки ли значения *a* и *b* друг к другу |33| [`isfinite(x)`](https://python-all.ru/3.15/library/math.html#math.isfinite) | Проверить, не является ли *x* ни бесконечностью, ни NaN |34| [`isnormal(x)`](https://python-all.ru/3.15/library/math.html#math.isnormal) | Проверяет, является ли *x* нормальным числом |35| [`issubnormal(x)`](https://python-all.ru/3.15/library/math.html#math.issubnormal) | Проверяет, является ли *x* субнормальным числом |36| [`isinf(x)`](https://python-all.ru/3.15/library/math.html#math.isinf) | Проверить, является ли *x* положительной или отрицательной бесконечностью |37| [`isnan(x)`](https://python-all.ru/3.15/library/math.html#math.isnan) | Проверить, является ли *x* значением NaN (не число) |38| [`ldexp(x, i)`](https://python-all.ru/3.15/library/math.html#math.ldexp) | `x * (2**i)`, обратная функция к [`frexp()`](https://python-all.ru/3.15/library/math.html#math.frexp) |39| [`nextafter(x, y, steps)`](https://python-all.ru/3.15/library/math.html#math.nextafter) | Число с плавающей запятой, отстоящее от *x* на *steps* шагов в направлении *y* |40| [`signbit(x)`](https://python-all.ru/3.15/library/math.html#math.signbit) | Проверяет, является ли *x* отрицательным числом |41| [`ulp(x)`](https://python-all.ru/3.15/library/math.html#math.ulp) | Значение наименьшего значащего бита *x* |42| **Степенные, экспоненциальные и логарифмические функции** |  |43| [`cbrt(x)`](https://python-all.ru/3.15/library/math.html#math.cbrt) | Кубический корень из *x* |44| [`exp(x)`](https://python-all.ru/3.15/library/math.html#math.exp) | *e* в степени *x* |45| [`exp2(x)`](https://python-all.ru/3.15/library/math.html#math.exp2) | *2* в степени *x* |46| [`expm1(x)`](https://python-all.ru/3.15/library/math.html#math.expm1) | *e* в степени *x* минус 1 |47| [`log(x, base)`](https://python-all.ru/3.15/library/math.html#math.log) | Логарифм *x* по заданному основанию (по умолчанию *e*) |48| [`log1p(x)`](https://python-all.ru/3.15/library/math.html#math.log1p) | Натуральный логарифм *1+x* (по основанию *e*) |49| [`log2(x)`](https://python-all.ru/3.15/library/math.html#math.log2) | Двоичный логарифм *x* |50| [`log10(x)`](https://python-all.ru/3.15/library/math.html#math.log10) | Десятичный логарифм *x* |51| [`pow(x, y)`](https://python-all.ru/3.15/library/math.html#math.pow) | *x* в степени *y* |52| [`sqrt(x)`](https://python-all.ru/3.15/library/math.html#math.sqrt) | Квадратный корень *x* |53| **Функции суммирования и произведения** |  |54| [`dist(p, q)`](https://python-all.ru/3.15/library/math.html#math.dist) | Евклидово расстояние между двумя точками *p* и *q*, заданными как итерируемый объект координат |55| [`fsum(iterable)`](https://python-all.ru/3.15/library/math.html#math.fsum) | Сумма значений во входном *iterable* |56| [`hypot(*coordinates)`](https://python-all.ru/3.15/library/math.html#math.hypot) | Евклидова норма итерируемого объекта координат |57| [`prod(iterable, start)`](https://python-all.ru/3.15/library/math.html#math.prod) | Произведение элементов во входном *iterable* с начальным значением *start* |58| [`sumprod(p, q)`](https://python-all.ru/3.15/library/math.html#math.sumprod) | Сумма произведений из двух итерируемых объектов *p* и *q* |59| **Преобразование угловых величин** |  |60| [`degrees(x)`](https://python-all.ru/3.15/library/math.html#math.degrees) | Преобразовать угол *x* из радианов в градусы |61| [`radians(x)`](https://python-all.ru/3.15/library/math.html#math.radians) | Преобразовать угол *x* из градусов в радианы |62| **Тригонометрические функции** |  |63| [`acos(x)`](https://python-all.ru/3.15/library/math.html#math.acos) | Арккосинус *x* |64| [`asin(x)`](https://python-all.ru/3.15/library/math.html#math.asin) | Арксинус *x* |65| [`atan(x)`](https://python-all.ru/3.15/library/math.html#math.atan) | Арктангенс *x* |66| [`atan2(y, x)`](https://python-all.ru/3.15/library/math.html#math.atan2) | `atan(y / x)` |67| [`cos(x)`](https://python-all.ru/3.15/library/math.html#math.cos) | Косинус *x* |68| [`sin(x)`](https://python-all.ru/3.15/library/math.html#math.sin) | Синус *x* |69| [`tan(x)`](https://python-all.ru/3.15/library/math.html#math.tan) | Тангенс *x* |70| **Гиперболические функции** |  |71| [`acosh(x)`](https://python-all.ru/3.15/library/math.html#math.acosh) | Обратный гиперболический косинус *x* |72| [`asinh(x)`](https://python-all.ru/3.15/library/math.html#math.asinh) | Обратный гиперболический синус *x* |73| [`atanh(x)`](https://python-all.ru/3.15/library/math.html#math.atanh) | Обратный гиперболический тангенс *x* |74| [`cosh(x)`](https://python-all.ru/3.15/library/math.html#math.cosh) | Гиперболический косинус *x* |75| [`sinh(x)`](https://python-all.ru/3.15/library/math.html#math.sinh) | Гиперболический синус *x* |76| [`tanh(x)`](https://python-all.ru/3.15/library/math.html#math.tanh) | Гиперболический тангенс *x* |77| **Специальные функции** |  |78| [`erf(x)`](https://python-all.ru/3.15/library/math.html#math.erf) | [Функция ошибок](https://python-all.ru/3.15/library/math.html) при *x* |79| [`erfc(x)`](https://python-all.ru/3.15/library/math.html#math.erfc) | [Дополнительная функция ошибок](https://python-all.ru/3.15/library/math.html) при *x* |80| [`gamma(x)`](https://python-all.ru/3.15/library/math.html#math.gamma) | [Гамма-функция](https://python-all.ru/3.15/library/math.html) при *x* |81| [`lgamma(x)`](https://python-all.ru/3.15/library/math.html#math.lgamma) | Натуральный логарифм абсолютного значения [гамма-функции](https://python-all.ru/3.15/library/math.html) при *x* |82| **Константы** |  |83| [`pi`](https://python-all.ru/3.15/library/math.html#math.pi) | *π* = 3.141592… |84| [`e`](https://python-all.ru/3.15/library/math.html#math.e) | *e* = 2.718281… |85| [`tau`](https://python-all.ru/3.15/library/math.html#math.tau) | *τ* = 2*π* = 6.283185… |86| [`inf`](https://python-all.ru/3.15/library/math.html#math.inf) | Положительная бесконечность |87| [`nan`](https://python-all.ru/3.15/library/math.html#math.nan) | «Не число» (NaN) |8889## Арифметика с плавающей запятой9091#### `math.ceil(x)`9293Возвращает потолок *x* – наименьшее целое число, большее или равное *x*. Если *x* не является числом с плавающей запятой, делегирует выполнение [`x.__ceil__`](https://python-all.ru/3.15/reference/datamodel.html#object.__ceil__), которая должна вернуть значение типа [`Integral`](https://python-all.ru/3.15/library/numbers.html#numbers.Integral).9495#### `math.fabs(x)`9697Возвращает абсолютное значение *x*.9899#### `math.floor(x)`100101Возвращает пол *x* – наибольшее целое число, меньшее или равное *x*. Если *x* не является числом с плавающей запятой, делегирует выполнение [`x.__floor__`](https://python-all.ru/3.15/reference/datamodel.html#object.__floor__), которая должна вернуть значение типа [`Integral`](https://python-all.ru/3.15/library/numbers.html#numbers.Integral).102103#### `math.fma(x, y, z)`104105Совмещённая операция умножения-сложения. Возвращает `(x * y) + z`, вычисленное как будто с бесконечной точностью и диапазоном, после чего следует однократное округление до формата `float`. Эта операция часто обеспечивает лучшую точность, чем прямое выражение `(x * y) + z`.106107Эта функция следует спецификации операции fusedMultiplyAdd, описанной в стандарте IEEE 754. Стандарт оставляет один случай определённым реализацией, а именно результат `fma(0, inf, nan)` и `fma(inf, 0, nan)`. В этих случаях `math.fma` возвращает NaN и не возбуждает никаких исключений.108109Добавлено в версии 3.13.110111#### `math.fmax(x, y)`112113Возвращает большее из двух значений с плавающей запятой, рассматривая NaN как пропущенные данные.114115Когда оба операнда – (знаковые) NaN или нули, возвращаются `nan` и `0` соответственно, а знак результата определяется реализацией; иначе говоря, `fmax()` не обязан учитывать знак таких операндов (см. приложение F стандарта C11, §F.10.0.3 и §F.10.9.2).116117Добавлено в версии 3.15.118119#### `math.fmin(x, y)`120121Возвращает меньшее из двух значений с плавающей запятой, рассматривая NaN как пропущенные данные.122123Когда оба операнда – (знаковые) NaN или нули, возвращаются `nan` и `0` соответственно, а знак результата определяется реализацией; иначе говоря, `fmin()` не обязан учитывать знак таких операндов (см. приложение F стандарта C11, §F.10.0.3 и §F.10.9.3).124125Добавлено в версии 3.15.126127#### `math.fmod(x, y)`128129Возвращает остаток от деления с плавающей запятой `x / y`, как определено библиотечной функцией C `fmod(x, y)`. Обратите внимание, что выражение Python `x % y` может возвращать другой результат. Цель стандарта C состоит в том, чтобы `fmod(x, y)` было математически (с бесконечной точностью) равно `x - n*y` для некоторого целого числа *n* такого, что результат имеет тот же знак, что и *x*, и величину меньше `abs(y)`. Функция Python `x % y` возвращает результат со знаком *y* и может быть не вычислима точно для аргументов типа float. Например, `fmod(-1e-100, 1e100)` равно `-1e-100`, но результат Python `-1e-100 % 1e100` равен `1e100-1e-100`, что не может быть представлено точно как float и округляется до неожиданного значения `1e100`. По этой причине функция `fmod()` обычно предпочтительнее при работе с числами с плавающей запятой, а функция Python `x % y` предпочтительнее при работе с целыми числами.130131#### `math.modf(x)`132133Возвращает дробную и целую части *x*. Оба результата имеют тот же знак, что и *x*, и являются числами с плавающей запятой.134135Обратите внимание, что `modf()` имеет другую схему вызова и возврата значения по сравнению с аналогами на C: она принимает один аргумент и возвращает пару значений, а не возвращает второе значение через «выходной параметр» (в Python такого нет).136137#### `math.remainder(x, y)`138139Возвращает остаток от деления по стандарту IEEE 754 для *x* на *y*. Для конечных *x* и конечного ненулевого *y* это разность `x - n*y`, где `n` – ближайшее целое к точному значению частного `x / y`. Если `x / y` находится ровно посередине между двумя последовательными целыми, то для `n` используется ближайшее *чётное* целое. Таким образом, остаток `r = remainder(x, y)` всегда удовлетворяет условию `abs(r) <= 0.5 * abs(y)`.140141Особые случаи следуют IEEE 754: в частности, `remainder(x, math.inf)` равно *x* для любого конечного *x*, а `remainder(x, 0)` и `remainder(math.inf, x)` возбуждают [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError) для любого не-NaN *x*. Если результат операции остатка равен нулю, этот нуль будет иметь тот же знак, что и *x*.142143На платформах, использующих двоичную арифметику с плавающей запятой IEEE 754, результат этой операции всегда представим точно: погрешность округления не вносится.144145Добавлено в версии 3.7.146147#### `math.trunc(x)`148149Возвращает *x* с отброшенной дробной частью, оставляя только целую часть. Это округление в сторону нуля: `trunc()` эквивалентно [`floor()`](https://python-all.ru/3.15/library/math.html#math.floor) для положительных *x* и эквивалентно [`ceil()`](https://python-all.ru/3.15/library/math.html#math.ceil) для отрицательных *x*. Если *x* не является float, делегирует [`x.__trunc__`](https://python-all.ru/3.15/reference/datamodel.html#object.__trunc__), которая должна возвращать значение [`Integral`](https://python-all.ru/3.15/library/numbers.html#numbers.Integral).150151Для функций [`ceil()`](https://python-all.ru/3.15/library/math.html#math.ceil), [`floor()`](https://python-all.ru/3.15/library/math.html#math.floor) и [`modf()`](https://python-all.ru/3.15/library/math.html#math.modf) обратите внимание, что *все* числа с плавающей запятой достаточно большой величины являются точными целыми числами. Float в Python обычно имеют точность не более 53 бит (как и тип C double на данной платформе), и в этом случае любой float *x* с `abs(x) >= 2**52` не имеет дробных битов.152153## Функции для работы с числами с плавающей запятой154155#### `math.copysign(x, y)`156157Возвращает float с модулем (абсолютным значением) *x*, но со знаком *y*. На платформах, поддерживающих знаковый нуль, `copysign(1.0, -0.0)` возвращает *-1.0*.158159#### `math.frexp(x)`160161Возвращает мантиссу и экспоненту *x* в виде пары `(m, e)`. Если *x* – конечное ненулевое число, то *m* является float с `0.5 <= abs(m) < 1.0`, а целое *e* таково, что `x == m * 2**e` точно. В противном случае возвращает `(x, 0)`. Это используется для «разбора» внутреннего представления float переносимым способом.162163Обратите внимание, что `frexp()` имеет другую схему вызова и возврата значения по сравнению с аналогами на C: она принимает один аргумент и возвращает пару значений, а не возвращает второе значение через «выходной параметр» (в Python такого нет).164165#### `math.isclose(a, b, *, rel_tol=1e-09, abs_tol=0.0)`166167Возвращает `True`, если значения *a* и *b* близки друг к другу, и `False` иначе.168169Близость двух значений определяется на основе заданных абсолютного и относительного допусков. Если ошибок не возникает, результатом будет: `abs(a-b) <= max(rel_tol * max(abs(a), abs(b)), abs_tol)`.170171*rel\_tol* – это относительный допуск; это максимально допустимая разница между *a* и *b*, относительно большего абсолютного значения *a* или *b*. Например, чтобы установить допуск 5%, передайте `rel_tol=0.05`. По умолчанию допуск равен `1e-09`, что гарантирует совпадение двух значений с точностью примерно до 9 десятичных знаков. *rel\_tol* должен быть неотрицательным и меньше `1.0`.172173*abs\_tol* – это абсолютный допуск; по умолчанию он равен `0.0` и должен быть неотрицательным. При сравнении `x` с `0.0`, `isclose(x, 0)` вычисляется как `abs(x) <= rel_tol * abs(x)`, что равно `False` для любого ненулевого `x` и *rel\_tol* меньшего, чем `1.0`. Поэтому добавьте соответствующий положительный аргумент *abs\_tol* в вызов.174175Особые значения IEEE 754: `NaN`, `inf` и `-inf` обрабатываются согласно правилам IEEE. В частности, `NaN` не считается близким ни к какому другому значению, включая `NaN`. `inf` и `-inf` считаются близкими только сами к себе.176177Добавлено в версии 3.5.178179> **См. также**180>181> [**PEP 485**](https://python-all.ru/3.15/library/math.html) – Функция для проверки приблизительного равенства182183#### `math.isfinite(x)`184185Возвращает `True`, если *x* не является ни бесконечностью, ни NaN, и `False` в противном случае. (Заметьте, что `0.0` *считается* конечным.)186187Добавлено в версии 3.2.188189#### `math.isnormal(x)`190191Возвращает `True`, если *x* – нормальное число, то есть ненулевое конечное число, не являющееся субнормальным (см. [`issubnormal()`](https://python-all.ru/3.15/library/math.html#math.issubnormal)). В противном случае возвращает `False`.192193Добавлено в версии 3.15.194195#### `math.issubnormal(x)`196197Возвращает `True`, если *x* – субнормальное число, то есть ненулевое конечное число, чья абсолютная величина меньше [`sys.float_info.min`](https://python-all.ru/3.15/library/sys.html#sys.float_info.min). В противном случае возвращает `False`.198199Добавлено в версии 3.15.200201#### `math.isinf(x)`202203Возвращает `True`, если *x* является положительной или отрицательной бесконечностью, и `False` в противном случае.204205#### `math.isnan(x)`206207Возвращает `True`, если *x* является NaN (не числом), и `False` в противном случае.208209#### `math.ldexp(x, i)`210211Возвращает `x * (2**i)`. По сути, это обратная функция по отношению к [`frexp()`](https://python-all.ru/3.15/library/math.html#math.frexp).212213#### `math.nextafter(x, y, steps=1)`214215Возвращает значение с плавающей запятой, отстоящее на *steps* шагов от *x* в направлении *y*.216217Если *x* равно *y*, возвращает *y*, если только *steps* не равно нулю.218219Примеры:220221- `math.nextafter(x, math.inf)` идёт вверх: в сторону положительной бесконечности.222- `math.nextafter(x, -math.inf)` идёт вниз: в сторону минус бесконечности.223- `math.nextafter(x, 0.0)` идёт к нулю.224- `math.nextafter(x, math.copysign(math.inf, x))` идёт от нуля.225226См. также [`math.ulp()`](https://python-all.ru/3.15/library/math.html#math.ulp).227228Добавлено в версии 3.9.229230Изменено в версии 3.12: Добавлен аргумент *steps*.231232#### `math.signbit(x)`233234Возвращает `True`, если знак числа *x* отрицателен, и `False` в противном случае.235236Это полезно для определения знакового бита нулей, бесконечностей и NaN.237238Добавлено в версии 3.15.239240#### `math.ulp(x)`241242Возвращает значение наименее значащего бита числа с плавающей запятой *x*:243244- Если *x* – NaN (не число), возвращает *x*.245- Если *x* отрицательно, возвращает `ulp(-x)`.246- Если *x* – положительная бесконечность, возвращает *x*.247- Если *x* равен нулю, возвращает наименьший положительный *денормализованный* представимый float (меньше минимального положительного *нормализованного* float, [`sys.float_info.min`](https://python-all.ru/3.15/library/sys.html#sys.float_info)).248- Если *x* равен наибольшему положительному представимому float, возвращает значение наименее значащего бита *x*, такое, что первый float, меньший *x*, равен `x - ulp(x)`.249- В противном случае (*x* – положительное конечное число) возвращает значение наименее значащего бита *x*, такое, что первый float, больший *x*, равен `x + ulp(x)`.250251ULP означает «единица в последнем разряде».252253См. также [`math.nextafter()`](https://python-all.ru/3.15/library/math.html#math.nextafter) и [`sys.float_info.epsilon`](https://python-all.ru/3.15/library/sys.html#sys.float_info).254255Добавлено в версии 3.9.256257## Степенные, показательные и логарифмические функции258259#### `math.cbrt(x)`260261Возвращает кубический корень из *x*.262263Добавлено в версии 3.12.264265#### `math.exp(x)`266267Возвращает *e*, возведённое в степень *x*, где *e* = 2.718281… – основание натуральных логарифмов. Обычно это точнее, чем `math.e ** x` или `pow(math.e, x)`.268269#### `math.exp2(x)`270271Возвращает *2*, возведённое в степень *x*.272273Добавлено в версии 3.12.274275#### `math.expm1(x)`276277Возвращает *e*, возведённое в степень *x*, минус 1. Здесь *e* – основание натуральных логарифмов. Для малых чисел с плавающей запятой *x* вычитание в `exp(x) - 1` может привести к [значительной потере точности](https://python-all.ru/3.15/library/math.html); функция `expm1()` позволяет вычислить это значение с полной точностью:278279```python280>>> from math import exp, expm1281>>> exp(1e-5) - 1  # даёт результат с точностью до 11 знаков2821.0000050000069649e-05283>>> expm1(1e-5)    # результат с полной точностью2841.0000050000166668e-05285```286287Добавлено в версии 3.2.288289#### `math.log(x[, base])`290291С одним аргументом возвращает натуральный логарифм *x* (по основанию *e*).292293С двумя аргументами возвращает логарифм *x* по заданному основанию *base*, вычисленный как `log(x)/log(base)`.294295#### `math.log1p(x)`296297Возвращает натуральный логарифм *1+x* (основание *e*). Результат вычисляется способом, точным для *x* вблизи нуля.298299#### `math.log2(x)`300301Возвращает двоичный логарифм *x*. Обычно это точнее, чем `log(x, 2)`.302303Добавлено в версии 3.3.304305> **См. также**306>307> [`int.bit_length()`](https://python-all.ru/3.15/library/stdtypes.html#int.bit_length) возвращает количество битов, необходимое для представления целого числа в двоичном виде, без учёта знака и ведущих нулей.308309#### `math.log10(x)`310311Возвращает десятичный логарифм *x*. Обычно это точнее, чем `log(x, 10)`.312313#### `math.pow(x, y)`314315Возвращает *x*, возведённое в степень *y*. Особые случаи по возможности следуют стандарту IEEE 754. В частности, `pow(1.0, x)` и `pow(x, 0.0)` всегда возвращают `1.0`, даже когда *x* – нуль или NaN. Если *x* и *y* конечны, *x* отрицательно, а *y* не является целым, то `pow(x, y)` не определено и возбуждает [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError).316317В отличие от встроенного оператора `**`, `math.pow()` преобразует оба аргумента к типу [`float`](https://python-all.ru/3.15/library/functions.html#float). Используйте `**` или встроенную функцию `pow()` для точного вычисления целочисленных степеней.318319Изменено в версии 3.11: Особые случаи `pow(0.0, -inf)` и `pow(-0.0, -inf)` были изменены так, чтобы возвращать `inf` вместо возбуждения [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError), для согласованности с IEEE 754.320321#### `math.sqrt(x)`322323Возвращает квадратный корень из *x*.324325## Функции суммирования и произведения326327#### `math.dist(p, q)`328329Возвращает евклидово расстояние между двумя точками *p* и *q*, каждая из которых задаётся как последовательность (или итерируемый объект) координат. Обе точки должны иметь одинаковую размерность.330331Примерно эквивалентно:332333```python334sqrt(sum((px - qx) ** 2.0 for px, qx in zip(p, q, strict=True)))335```336337Добавлено в версии 3.8.338339#### `math.fsum(iterable)`340341Возвращает точную сумму значений с плавающей запятой из итерируемого объекта. Избегает потери точности за счёт отслеживания нескольких промежуточных частичных сумм.342343Точность алгоритма зависит от гарантий арифметики IEEE-754 и типичного случая, когда режим округления – «half-even». В некоторых сборках не под Windows базовая библиотека C использует сложение с расширенной точностью и может иногда дважды округлять промежуточную сумму, что приводит к ошибке в самом младшем значащем бите.344345Для более подробного обсуждения и двух альтернативных подходов см. [рецепты ASPN cookbook для точного суммирования чисел с плавающей запятой](https://python-all.ru/3.15/library/math.html).346347#### `math.hypot(*coordinates)`348349Возвращает евклидову норму, `sqrt(sum(x**2 for x in coordinates))`. Это длина вектора от начала координат до точки, заданной координатами.350351Для двумерной точки `(x, y)` это эквивалентно вычислению гипотенузы прямоугольного треугольника по теореме Пифагора, `sqrt(x*x + y*y)`.352353Изменено в версии 3.8: Добавлена поддержка n-мерных точек. Ранее поддерживался только двумерный случай.354355Изменено в версии 3.10: Улучшена точность алгоритма так, что максимальная ошибка составляет менее 1 ulp (единицы в последнем разряде). Как правило, результат почти всегда правильно округлён с точностью до 1/2 ulp.356357#### `math.prod(iterable, *, start=1)`358359Вычисляет произведение всех элементов входного *итерируемого объекта*. Значение *start* по умолчанию для произведения равно `1`.360361Если итерируемый объект пуст, возвращает начальное значение. Эта функция предназначена специально для работы с числовыми значениями и может отвергать нечисловые типы.362363Добавлено в версии 3.8.364365#### `math.sumprod(p, q)`366367Возвращает сумму произведений значений из двух итерируемых объектов *p* и *q*.368369Возбуждает [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError), если входные данные имеют разную длину.370371Примерно эквивалентно:372373```python374sum(map(operator.mul, p, q, strict=True))375```376377Для входных данных типа float и смешанных int/float промежуточные произведения и суммы вычисляются с расширенной точностью.378379Добавлено в версии 3.12.380381## Преобразование углов382383#### `math.degrees(x)`384385Преобразует угол *x* из радианов в градусы.386387#### `math.radians(x)`388389Преобразует угол *x* из градусов в радианы.390391## Тригонометрические функции392393#### `math.acos(x)`394395Возвращает арккосинус *x* в радианах. Результат находится в диапазоне от `0` до `pi`.396397#### `math.asin(x)`398399Возвращает арксинус *x* в радианах. Результат находится в диапазоне от `-pi/2` до `pi/2`.400401#### `math.atan(x)`402403Возвращает арктангенс *x* в радианах. Результат находится в диапазоне от `-pi/2` до `pi/2`.404405#### `math.atan2(y, x)`406407Возвращает `atan(y / x)` в радианах. Результат находится в диапазоне от `-pi` до `pi`. Вектор на плоскости от начала координат до точки `(x, y)` образует этот угол с положительной осью X. Особенность `atan2()` в том, что ему известны знаки обоих аргументов, поэтому он может вычислить правильный квадрант для угла. Например, `atan(1)` и `atan2(1, 1)` равны `pi/4`, но `atan2(-1, -1)` равен `-3*pi/4`.408409#### `math.cos(x)`410411Возвращает косинус *x* радиан.412413#### `math.sin(x)`414415Возвращает синус *x* радиан.416417#### `math.tan(x)`418419Возвращает тангенс *x* радиан.420421## Гиперболические функции422423[Гиперболические функции](https://python-all.ru/3.15/library/math.html) – это аналоги тригонометрических функций, основанные на гиперболах, а не на окружностях.424425#### `math.acosh(x)`426427Возвращает обратный гиперболический косинус *x*.428429#### `math.asinh(x)`430431Возвращает обратный гиперболический синус *x*.432433#### `math.atanh(x)`434435Возвращает обратный гиперболический тангенс *x*.436437#### `math.cosh(x)`438439Возвращает гиперболический косинус *x*.440441#### `math.sinh(x)`442443Возвращает гиперболический синус *x*.444445#### `math.tanh(x)`446447Возвращает гиперболический тангенс *x*.448449## Специальные функции450451#### `math.erf(x)`452453Возвращает значение [функции ошибок](https://python-all.ru/3.15/library/math.html) в точке *x*.454455Функция `erf()` может использоваться для вычисления традиционных статистических функций, таких как [кумулятивное стандартное нормальное распределение](https://python-all.ru/3.15/library/math.html):456457```python458def phi(x):459    'Cumulative distribution function for the standard normal distribution'460    return (1.0 + erf(x / sqrt(2.0))) / 2.0461```462463Добавлено в версии 3.2.464465#### `math.erfc(x)`466467Возвращает дополнительную функцию ошибок в точке *x*. [Дополнительная функция ошибок](https://python-all.ru/3.15/library/math.html) определяется как `1.0 - erf(x)`. Она используется для больших значений *x*, где вычитание из единицы может привести к [потере значимости](https://python-all.ru/3.15/library/math.html).468469Добавлено в версии 3.2.470471#### `math.gamma(x)`472473Возвращает значение [гамма-функции](https://python-all.ru/3.15/library/math.html) в точке *x*.474475Добавлено в версии 3.2.476477#### `math.lgamma(x)`478479Возвращает натуральный логарифм абсолютного значения гамма-функции в точке *x*.480481Добавлено в версии 3.2.482483## Теоретико-числовые функции484485Для обратной совместимости модуль `math` также предоставляет псевдонимы следующих функций из модуля [`math.integer`](https://python-all.ru/3.15/library/math.integer.html#module-math.integer):486487| [`comb(n, k)`](https://python-all.ru/3.15/library/math.integer.html#math.integer.comb) | Количество способов выбрать *k* элементов из *n* элементов без повторений и без учёта порядка |488| --- | --- |489| [`factorial(n)`](https://python-all.ru/3.15/library/math.integer.html#math.integer.factorial) | Факториал *n* |490| [`gcd(*integers)`](https://python-all.ru/3.15/library/math.integer.html#math.integer.gcd) | Наибольший общий делитель целочисленных аргументов |491| [`isqrt(n)`](https://python-all.ru/3.15/library/math.integer.html#math.integer.isqrt) | Целочисленный квадратный корень из неотрицательного целого *n* |492| [`lcm(*integers)`](https://python-all.ru/3.15/library/math.integer.html#math.integer.lcm) | Наименьшее общее кратное целочисленных аргументов |493| [`perm(n, k)`](https://python-all.ru/3.15/library/math.integer.html#math.integer.perm) | Количество способов выбрать *k* элементов из *n* элементов без повторений и с учётом порядка |494495Добавлено в версии 3.5: Функция [`gcd()`](https://python-all.ru/3.15/library/math.html#math.gcd).496497Добавлено в версии 3.8: Функции [`comb()`](https://python-all.ru/3.15/library/math.html#math.comb), [`perm()`](https://python-all.ru/3.15/library/math.html#math.perm) и [`isqrt()`](https://python-all.ru/3.15/library/math.html#math.isqrt).498499Добавлено в версии 3.9: Функция [`lcm()`](https://python-all.ru/3.15/library/math.html#math.lcm).500501Изменено в версии 3.9: Добавлена поддержка произвольного количества аргументов в функции [`gcd()`](https://python-all.ru/3.15/library/math.html#math.gcd) . Ранее поддерживались только два аргумента.502503Изменено в версии 3.10: Числа с плавающей запятой с целыми значениями (например, `5.0`) больше не принимаются в функции [`factorial()`](https://python-all.ru/3.15/library/math.html#math.factorial).504505[Мягко устарело](https://python-all.ru/3.15/glossary.html#term-soft-deprecated) с версии 3.15: Используйте функции [`math.integer`](https://python-all.ru/3.15/library/math.integer.html#module-math.integer) вместо этих псевдонимов.506507## Константы508509#### `math.pi`510511Математическая константа *π* = 3,141592… с доступной точностью.512513#### `math.e`514515Математическая константа *e* = 2,718281… с доступной точностью.516517#### `math.tau`518519Математическая константа *τ* = 6,283185… с доступной точностью. Тау – это константа окружности, равная 2*π*, отношению длины окружности к её радиусу. Чтобы узнать больше о Тау, посмотрите видео Ви Харт [Pi is (still) Wrong](https://python-all.ru/3.15/library/math.html) и начните праздновать [День Тау](https://python-all.ru/3.15/library/math.html), съев вдвое больше пирога!520521Добавлено в версии 3.6.522523#### `math.inf`524525Положительная бесконечность с плавающей запятой. (Для отрицательной бесконечности используйте `-math.inf`.) Эквивалентно результату `float('inf')`.526527Добавлено в версии 3.5.528529#### `math.nan`530531Значение с плавающей запятой «не число» (NaN). Эквивалентно результату `float('nan')`. В соответствии с требованиями стандарта [IEEE-754](https://python-all.ru/3.15/library/math.html), `math.nan` и `float('nan')` не считаются равными никакому другому числовому значению, включая самих себя. Чтобы проверить, является ли число NaN, используйте функцию [`isnan()`](https://python-all.ru/3.15/library/math.html#math.isnan) для проверки на NaN вместо `is` или `==`. Пример:532533```python534>>> import math535>>> math.nan == math.nan536False537>>> float('nan') == float('nan')538False539>>> math.isnan(math.nan)540True541>>> math.isnan(float('nan'))542True543```544545Добавлено в версии 3.5.546547Изменено в версии 3.11: Теперь всегда доступно.548549**Особенность реализации CPython:** Модуль `math` в основном состоит из тонких обёрток вокруг функций математической библиотеки C платформы. Поведение в исключительных случаях следует приложению F стандарта C99, где это применимо. Текущая реализация вызывает [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError) для недопустимых операций, таких как `sqrt(-1.0)` или `log(0.0)` (где приложение F C99 рекомендует сигнализировать о недопустимой операции или делении на ноль), и [`OverflowError`](https://python-all.ru/3.15/library/exceptions.html#OverflowError) для результатов, вызывающих переполнение (например, `exp(1000.0)`). NaN не будет возвращён ни одной из указанных выше функций, если только один или несколько входных аргументов не были NaN; в этом случае большинство функций вернут NaN, но (опять же следуя приложению F C99) есть некоторые исключения из этого правила, например `pow(float('nan'), 0.0)` или `hypot(float('nan'), float('inf'))`.550551Обратите внимание, что Python не различает сигнальные NaN и тихие NaN, и поведение для сигнальных NaN остаётся неуточнённым. Обычное поведение – обрабатывать все NaN так, как будто они тихие.552553> **См. также**554>555> **Модуль [`cmath`](https://python-all.ru/3.15/library/cmath.html#module-cmath)**556>557> Версии многих из этих функций для комплексных чисел.558>559> **Модуль [`math.integer`](https://python-all.ru/3.15/library/math.integer.html#module-math.integer)**560>561> Математические функции для целых чисел.562