xiuos/Ubiquitous/RT_Thread/micropython/docs/std-librarys/math.md

284 lines
4.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## **math** 数学函数
**math** 模块提供了对 C 标准定义的数学函数的访问。
> 注意:本模块需要带有硬件 FPU精度是32位这个模块需要浮点功能支持。
### 常数
#### **math.e**
自然对数的底数。
示例:
```
>>>import math
>>>print(math.e)
2.718282
```
#### **math.pi**
圆周长与直径的比值。
示例:
```
>>> print(math.pi)
3.141593
```
### 函数
#### **math.acos(x)**
传入弧度值计算cos(x)的反三角函数。
#### **math.acosh(x)**
返回 ``x`` 的逆双曲余弦。
#### **math.asin(x)**
传入弧度值计算sin(x)的反三角函数。
示例:
```
>>> x = math.asin(0.5)
>>> print(x)
0.5235988
```
#### **math.asinh(x)**
返回``x`` 的逆双曲正弦。
#### **math.atan(x)**
返回 ``x`` 的逆切线。
#### **math.atan2(y, x)**
Return the principal value of the inverse tangent of y/x.
#### **math.atanh(x)**
Return the inverse hyperbolic tangent of x.
#### **math.ceil(x)**
向上取整。
示例:
```
>>> x = math.ceil(5.6454)
>>> print(x)
6
```
#### **math.copysign(x, y)**
Return x with the sign of y.
#### **math.cos(x)**
传入弧度值,计算余弦。
示例计算cos60°
```
>>> math.cos(math.radians(60))
0.5
```
#### **math.cosh(x)**
Return the hyperbolic cosine of x.
#### **math.degrees(x)**
弧度转化为角度。
示例:
```
>>> x = math.degrees(1.047198)
>>> print(x)
60.00002
```
#### **math.erf(x)**
Return the error function of x.
#### **math.erfc(x)**
Return the complementary error function of x.
#### **math.exp(x)**
计算e的x次方
示例:
```
>>> x = math.exp(2)
>>> print(x)
7.389056
```
#### **math.expm1(x)**
计算 math.exp(x) - 1。
#### **math.fabs(x)**
计算绝对值。
示例:
```
>>> x = math.fabs(-5)
>>> print(x)
5.0
>>> y = math.fabs(5.0)
>>> print(y)
5.0
```
#### **math.floor(x)**
向下取整。
示例:
```
>>> x = math.floor(2.99)
>>> print(x)
2
>>> y = math.floor(-2.34)
>>> print(y)
-3
```
#### **math.fmod(x, y)**
取x除以y的模。
示例:
```
>>> x = math.fmod(4, 5)
>>> print(x)
4.0
```
#### **math.frexp(x)**
Decomposes a floating-point number into its mantissa and exponent. The returned value is the tuple (m, e) such that x == m * 2**e exactly. If x == 0 then the function returns (0.0, 0), otherwise the relation 0.5 <= abs(m) < 1 holds.
#### **math.gamma(x)**
返回伽马函数
示例
```
>>> x = math.gamma(5.21)
>>> print(x)
33.08715
```
#### **math.isfinite(x)**
Return True if x is finite.
#### **math.isinf(x)**
Return True if x is infinite.
#### **math.isnan(x)**
Return True if x is not-a-number
#### **math.ldexp(x, exp)**
Return x * (2**exp).
#### **math.lgamma(x)**
返回伽马函数的自然对数
示例
```
>>> x = math.lgamma(5.21)
>>> print(x)
3.499145
```
#### **math.log(x)**
计算以e为底的x的对数
示例
```
>>> x = math.log(10)
>>> print(x)
2.302585
```
#### **math.log10(x)**
计算以10为底的x的对数
示例
```
>>> x = math.log10(10)
>>> print(x)
1.0
```
#### **math.log2(x)**
计算以2为底的x的对数
示例
```
>>> x = math.log2(8)
>>> print(x)
3.0
```
#### **math.modf(x)**
Return a tuple of two floats, being the fractional and integral parts of x. Both return values have the same sign as x.
#### **math.pow(x, y)**
计算 x y 次方)。
示例
```
>>> x = math.pow(2, 3)
>>> print(x)
8.0
```
#### **math.radians(x)**
角度转化为弧度
示例
```
>>> x = math.radians(60)
>>> print(x)
1.047198
```
#### **math.sin(x)**
传入弧度值计算正弦
示例计算sin90°
```
>>> math.sin(math.radians(90))
1.0
```
#### **math.sinh(x)**
Return the hyperbolic sine of x.
#### **math.sqrt(x)**
计算平方根
示例
```
>>> x = math.sqrt(9)
>>> print(x)
3.0
```
#### **math.tan(x)**
传入弧度值计算正切
示例计算tan60°
```
>>> math.tan(math.radians(60))
1.732051
```
#### **math.tanh(x)**
Return the hyperbolic tangent of x.
#### **math.trunc(x)**
取整
示例
```
>>> x = math.trunc(5.12)
>>> print(x)
5
>>> y = math.trunc(-6.8)
>>> print(y)
-6
```
更多内容可参考 [math](http://docs.micropython.org/en/latest/pyboard/library/math.html)