summaryrefslogtreecommitdiffstatshomepage
path: root/docs/library/cmath.rst
blob: d729561d65227ab1517493e6a344e39f1b74ff5f (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
:mod:`cmath` --- mathematical functions for complex numbers
===========================================================

.. module:: cmath
   :synopsis: mathematical functions for complex numbers

The ``cmath`` module provides some basic mathematical funtions for
working with complex numbers.


Functions
---------

.. function:: cos(z)

   Return the cosine of ``z``.

.. function:: exp(z)

   Return the exponential of ``z``.

.. function:: log(z)

   Return the natural logarithm of ``z``.  The branch cut is along the negative real axis.

.. function:: log10(z)

   Return the base-10 logarithm of ``z``.  The branch cut is along the negative real axis.

.. function:: phase(z)

   Returns the phase of the number ``z``, in the range (-pi, +pi].

.. function:: polar(z)

   Returns, as a tuple, the polar form of ``z``.

.. function:: rect(r, phi)

   Returns the complex number with modulus ``r`` and phase ``phi``.

.. function:: sin(z)

   Return the sine of ``z``.

.. function:: sqrt(z)

   Return the square-root of ``z``.


Constants
---------

.. data:: e

   base of the natural logarithm

.. data:: pi

   the ratio of a circle's circumference to its diameter