Модули и функции · встроенный MicroPython FEMM 5

math

Модуль содержит скалярные математические функции вещественного аргумента, доступные во встроенном MicroPython.

Условия работы

Доступные константы: math.pi и math.e. Функции принимают скаляры; для массива используйте операции numpy.
Тригонометрические функции работают с радианами. Выход из вещественной области определения вызывает ValueError.
Неквалифицированные sqrt/log/sin и другие одноимённые команды FEMM могут иметь комплексную ветвь. Здесь описаны именно явно вызванные math.*.

math.sqrtКвадратный корень неотрицательного вещественного числа.

math.sqrt

math.sqrt(x)

Квадратный корень неотрицательного вещественного числа.

Аргументы

Аргументы вызова `math.sqrt`
Имя	Назначение и допустимые значения
`x`	x ≥ 0.

Возвращаемое значение

float

Пример

"Пример math.sqrt.\nСреда: встроенный MicroPython FEMM 5.\nКвадратный корень неотрицательного вещественного числа.\nРезультат: float"

import math
y=math.sqrt(9)
assert abs(y-(3))<1e-10
print(y)

Ожидаемый результат. Результат равен 3.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.expЭкспонента e**x.

math.exp

math.exp(x)

Экспонента e**x.

Аргументы

Аргументы вызова `math.exp`
Имя	Назначение и допустимые значения
`x`	Безразмерный вещественный аргумент.

Возвращаемое значение

float

Пример

"Пример math.exp.\nСреда: встроенный MicroPython FEMM 5.\nЭкспонента e**x.\nРезультат: float"

import math
y=math.exp(0)
assert abs(y-(1))<1e-10
print(y)

Ожидаемый результат. Результат равен 1.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.sinСинус угла.

math.sin

math.sin(x)

Синус угла.

Аргументы

Аргументы вызова `math.sin`
Имя	Назначение и допустимые значения
`x`	Угол в радианах.

Возвращаемое значение

float

Пример

"Пример math.sin.\nСреда: встроенный MicroPython FEMM 5.\nСинус угла.\nРезультат: float"

import math
y=math.sin(math.pi/2)
assert abs(y-(1))<1e-10
print(y)

Ожидаемый результат. Результат равен 1.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.cosКосинус угла.

math.cos

math.cos(x)

Косинус угла.

Аргументы

Аргументы вызова `math.cos`
Имя	Назначение и допустимые значения
`x`	Угол в радианах.

Возвращаемое значение

float

Пример

"Пример math.cos.\nСреда: встроенный MicroPython FEMM 5.\nКосинус угла.\nРезультат: float"

import math
y=math.cos(math.pi)
assert abs(y-(-1))<1e-10
print(y)

Ожидаемый результат. Результат равен -1.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.tanТангенс угла.

math.tan

math.tan(x)

Тангенс угла.

Аргументы

Аргументы вызова `math.tan`
Имя	Назначение и допустимые значения
`x`	Угол в радианах; избегайте полюсов pi/2+k*pi.

Возвращаемое значение

float

Пример

"Пример math.tan.\nСреда: встроенный MicroPython FEMM 5.\nТангенс угла.\nРезультат: float"

import math
y=math.tan(0)
assert abs(y-(0))<1e-10
print(y)

Ожидаемый результат. Результат равен 0.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.asinАрксинус.

math.asin

math.asin(x)

Арксинус.

Аргументы

Аргументы вызова `math.asin`
Имя	Назначение и допустимые значения
`x`	Вещественное число в [-1,1].

Возвращаемое значение

float, радианы

Пример

"Пример math.asin.\nСреда: встроенный MicroPython FEMM 5.\nАрксинус.\nРезультат: float, радианы"

import math
y=math.asin(1)
assert abs(y-(math.pi/2))<1e-10
print(y)

Ожидаемый результат. Результат равен math.pi/2.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.acosАрккосинус.

math.acos

math.acos(x)

Арккосинус.

Аргументы

Аргументы вызова `math.acos`
Имя	Назначение и допустимые значения
`x`	Вещественное число в [-1,1].

Возвращаемое значение

float, радианы

Пример

"Пример math.acos.\nСреда: встроенный MicroPython FEMM 5.\nАрккосинус.\nРезультат: float, радианы"

import math
y=math.acos(-1)
assert abs(y-(math.pi))<1e-10
print(y)

Ожидаемый результат. Результат равен math.pi.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.atanАрктангенс.

math.atan

math.atan(x)

Арктангенс.

Аргументы

Аргументы вызова `math.atan`
Имя	Назначение и допустимые значения
`x`	Вещественное число.

Возвращаемое значение

float, радианы

Пример

"Пример math.atan.\nСреда: встроенный MicroPython FEMM 5.\nАрктангенс.\nРезультат: float, радианы"

import math
y=math.atan(1)
assert abs(y-(math.pi/4))<1e-10
print(y)

Ожидаемый результат. Результат равен math.pi/4.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.fabsАбсолютное значение вещественного числа.

math.fabs

math.fabs(x)

Абсолютное значение вещественного числа.

Аргументы

Аргументы вызова `math.fabs`
Имя	Назначение и допустимые значения
`x`	Вещественное число.

Возвращаемое значение

float

Пример

"Пример math.fabs.\nСреда: встроенный MicroPython FEMM 5.\nАбсолютное значение вещественного числа.\nРезультат: float"

import math
y=math.fabs(-2.5)
assert abs(y-(2.5))<1e-10
print(y)

Ожидаемый результат. Результат равен 2.5.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.floorОкругление вниз к ближайшему целому.

math.floor

math.floor(x)

Округление вниз к ближайшему целому.

Аргументы

Аргументы вызова `math.floor`
Имя	Назначение и допустимые значения
`x`	Конечное вещественное число.

Возвращаемое значение

int

Пример

"Пример math.floor.\nСреда: встроенный MicroPython FEMM 5.\nОкругление вниз к ближайшему целому.\nРезультат: int"

import math
y=math.floor(-1.2)
assert abs(y-(-2))<1e-10
print(y)

Ожидаемый результат. Результат равен -2.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.ceilОкругление вверх к ближайшему целому.

math.ceil

math.ceil(x)

Округление вверх к ближайшему целому.

Аргументы

Аргументы вызова `math.ceil`
Имя	Назначение и допустимые значения
`x`	Конечное вещественное число.

Возвращаемое значение

int

Пример

"Пример math.ceil.\nСреда: встроенный MicroPython FEMM 5.\nОкругление вверх к ближайшему целому.\nРезультат: int"

import math
y=math.ceil(-1.2)
assert abs(y-(-1))<1e-10
print(y)

Ожидаемый результат. Результат равен -1.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.truncОтбрасывание дробной части к нулю.

math.trunc

math.trunc(x)

Отбрасывание дробной части к нулю.

Аргументы

Аргументы вызова `math.trunc`
Имя	Назначение и допустимые значения
`x`	Конечное вещественное число.

Возвращаемое значение

int

Пример

"Пример math.trunc.\nСреда: встроенный MicroPython FEMM 5.\nОтбрасывание дробной части к нулю.\nРезультат: int"

import math
y=math.trunc(-1.9)
assert abs(y-(-1))<1e-10
print(y)

Ожидаемый результат. Результат равен -1.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.radiansПреобразование градусов в радианы.

math.radians

math.radians(x)

Преобразование градусов в радианы.

Аргументы

Аргументы вызова `math.radians`
Имя	Назначение и допустимые значения
`x`	Угол в градусах.

Возвращаемое значение

float, радианы

Пример

"Пример math.radians.\nСреда: встроенный MicroPython FEMM 5.\nПреобразование градусов в радианы.\nРезультат: float, радианы"

import math
y=math.radians(180)
assert abs(y-(math.pi))<1e-10
print(y)

Ожидаемый результат. Результат равен math.pi.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.degreesПреобразование радиан в градусы.

math.degrees

math.degrees(x)

Преобразование радиан в градусы.

Аргументы

Аргументы вызова `math.degrees`
Имя	Назначение и допустимые значения
`x`	Угол в радианах.

Возвращаемое значение

float, градусы

Пример

"Пример math.degrees.\nСреда: встроенный MicroPython FEMM 5.\nПреобразование радиан в градусы.\nРезультат: float, градусы"

import math
y=math.degrees(math.pi)
assert abs(y-(180))<1e-10
print(y)

Ожидаемый результат. Результат равен 180.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.isfiniteПроверка конечности числа.

math.isfinite

math.isfinite(x)

Проверка конечности числа.

Аргументы

Аргументы вызова `math.isfinite`
Имя	Назначение и допустимые значения
`x`	Вещественное число.

Возвращаемое значение

bool

Пример

"Пример math.isfinite.\nСреда: встроенный MicroPython FEMM 5.\nПроверка конечности числа.\nРезультат: bool"

import math
y=math.isfinite(2.0)
assert abs(y-(True))<1e-10
print(y)

Ожидаемый результат. Результат равен True.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.isinfПроверка бесконечности со знаком плюс или минус.

math.isinf

math.isinf(x)

Проверка бесконечности со знаком плюс или минус.

Аргументы

Аргументы вызова `math.isinf`
Имя	Назначение и допустимые значения
`x`	Вещественное число.

Возвращаемое значение

bool

Пример

"Пример math.isinf.\nСреда: встроенный MicroPython FEMM 5.\nПроверка бесконечности со знаком плюс или минус.\nРезультат: bool"

import math
y=math.isinf(float("inf"))
assert abs(y-(True))<1e-10
print(y)

Ожидаемый результат. Результат равен True.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.isnanПроверка специального значения NaN.

math.isnan

math.isnan(x)

Проверка специального значения NaN.

Аргументы

Аргументы вызова `math.isnan`
Имя	Назначение и допустимые значения
`x`	Вещественное число.

Возвращаемое значение

bool

Пример

"Пример math.isnan.\nСреда: встроенный MicroPython FEMM 5.\nПроверка специального значения NaN.\nРезультат: bool"

import math
y=math.isnan(float("nan"))
assert abs(y-(True))<1e-10
print(y)

Ожидаемый результат. Результат равен True.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.atan2Определяет угол вектора с учётом четверти.

math.atan2

math.atan2(y, x)

Определяет угол вектора с учётом четверти.

Аргументы

Аргументы вызова `math.atan2`
Имя	Назначение и допустимые значения
`y`	Координата по вертикальной оси.
`x`	Координата по горизонтальной оси; единицы те же, что у y.

Возвращаемое значение

float — угол в радианах в пределах [-pi,pi].

Пример

"Пример math.atan2.\nСреда: встроенный MicroPython FEMM 5.\nОпределяет угол вектора с учётом четверти.\nРезультат: float — угол в радианах в пределах [-pi,pi]."

import math
y=math.atan2(1,0)
assert abs(y-(math.pi/2))<1e-10
print(y)

Ожидаемый результат. Результат равен math.pi/2.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.copysignПереносит знак второго числа на модуль первого.

math.copysign

math.copysign(x, y)

Переносит знак второго числа на модуль первого.

Аргументы

Аргументы вызова `math.copysign`
Имя	Назначение и допустимые значения
`x`	Число, модуль которого сохраняется.
`y`	Число, знак которого переносится.

Возвращаемое значение

float.

Пример

"Пример math.copysign.\nСреда: встроенный MicroPython FEMM 5.\nПереносит знак второго числа на модуль первого.\nРезультат: float."

import math
y=math.copysign(3,-1)
assert abs(y-(-3))<1e-10
print(y)

Ожидаемый результат. Результат равен -3.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.fmodОстаток вещественного деления; знак задаёт делимое.

math.fmod

math.fmod(x, y)

Остаток вещественного деления; знак задаёт делимое.

Аргументы

Аргументы вызова `math.fmod`
Имя	Назначение и допустимые значения
`x`	Делимое.
`y`	Ненулевой делитель.

Возвращаемое значение

float — остаток со знаком x.

Пример

"Пример math.fmod.\nСреда: встроенный MicroPython FEMM 5.\nОстаток вещественного деления; знак задаёт делимое.\nРезультат: float — остаток со знаком x."

import math
y=math.fmod(-5.5,2)
assert abs(y-(-1.5))<1e-10
print(y)

Ожидаемый результат. Результат равен -1.5.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.powВозводит вещественное число в степень.

math.pow

math.pow(x, y)

Возводит вещественное число в степень.

Аргументы

Аргументы вызова `math.pow`
Имя	Назначение и допустимые значения
`x`	Вещественное основание.
`y`	Вещественный показатель; отрицательное основание требует целочисленного показателя.

Возвращаемое значение

float.

Пример

"Пример math.pow.\nСреда: встроенный MicroPython FEMM 5.\nВозводит вещественное число в степень.\nРезультат: float."

import math
y=math.pow(2,3)
assert abs(y-(8))<1e-10
print(y)

Ожидаемый результат. Результат равен 8.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.ldexpСобирает число из мантиссы и двоичного порядка.

math.ldexp

math.ldexp(x, exp)

Собирает число из мантиссы и двоичного порядка.

Аргументы

Аргументы вызова `math.ldexp`
Имя	Назначение и допустимые значения
`x`	Вещественная мантисса.
`exp`	Целая степень двойки.

Возвращаемое значение

float — x*2**exp.

Пример

"Пример math.ldexp.\nСреда: встроенный MicroPython FEMM 5.\nСобирает число из мантиссы и двоичного порядка.\nРезультат: float — x*2**exp."

import math
y=math.ldexp(0.5,4)
assert abs(y-(8))<1e-10
print(y)

Ожидаемый результат. Результат равен 8.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.logВычисляет натуральный логарифм либо log(x)/log(base).

math.log

math.log(x, base=math.e)

Вычисляет натуральный логарифм либо log(x)/log(base).

Аргументы

Аргументы вызова `math.log`
Имя	Назначение и допустимые значения
`x`	Положительный безразмерный скаляр.
`base`	Необязательное положительное основание, отличное от 1; передаётся позиционно.

Возвращаемое значение

float — логарифм по указанному основанию.

Особенности вызова

base=1 вызывает ZeroDivisionError.

Пример

"Пример math.log.\nСреда: встроенный MicroPython FEMM 5.\nВычисляет натуральный логарифм либо log(x)/log(base).\nРезультат: float — логарифм по указанному основанию."

import math
y=math.log(100,10)
assert abs(y-2)<1e-10
print(y)

Ожидаемый результат. Результат равен 2.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.frexpРазлагает число на мантиссу и двоичный порядок. Для ненулевого конечного x: 0.5 ≤ abs(m) < 1.

math.frexp

math.frexp(x)

Разлагает число на мантиссу и двоичный порядок. Для ненулевого конечного x: 0.5 ≤ abs(m) < 1.

Аргументы

Аргументы вызова `math.frexp`
Имя	Назначение и допустимые значения
`x`	Вещественное число.

Возвращаемое значение

Кортеж (m,e): float мантиссы и int порядка; x=m*2**e.

Пример

"Пример math.frexp.\nСреда: встроенный MicroPython FEMM 5.\nРазлагает число на мантиссу и двоичный порядок. Для ненулевого конечного x: 0.5 ≤ abs(m) < 1.\nРезультат: Кортеж (m,e): float мантиссы и int порядка; x=m*2**e."

import math
m,e=math.frexp(8.0)
assert m==0.5 and e==4
assert math.ldexp(m,e)==8
print(m,e)

Ожидаемый результат. Кортеж (0.5,4).

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

math.modfРазделяет число на дробную и целую части.

math.modf

math.modf(x)

Разделяет число на дробную и целую части.

Аргументы

Аргументы вызова `math.modf`
Имя	Назначение и допустимые значения
`x`	Вещественное число.

Возвращаемое значение

Кортеж (fraction,integer), обе части float со знаком исходного x.

Пример

"Пример math.modf.\nСреда: встроенный MicroPython FEMM 5.\nРазделяет число на дробную и целую части.\nРезультат: Кортеж (fraction,integer), обе части float со знаком исходного x."

import math
f,i=math.modf(-2.75)
assert f==-0.75 and i==-2.0
print(f,i)

Ожидаемый результат. Кортеж (-0.75,-2.0).

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

Имена в установленной сборке

Перечень получен во встроенном интерпретаторе. Он включает функции, классы и константы. Ссылки ведут к контрактам; для прямого доступа ulab учитывайте условия этого раздела.

acosasinatanatan2ceilcopysigncosdegreeseexpfabsfloorfmodfrexpisfiniteisinfisnanldexplogmodfpipowradianssinsqrttantrunc