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
|
.. _routines.emath:
Mathematical functions with automatic domain
********************************************
.. currentmodule:: numpy.emath
.. note:: ``numpy.emath`` is a preferred alias for ``numpy.lib.scimath``,
available after :mod:`numpy` is imported.
Wrapper functions to more user-friendly calling of certain math functions
whose output data-type is different than the input data-type in certain
domains of the input.
For example, for functions like `log` with branch cuts, the versions in this
module provide the mathematically valid answers in the complex plane::
>>> import math
>>> np.emath.log(-math.exp(1)) == (1+1j*math.pi)
True
Similarly, `sqrt`, other base logarithms, `power` and trig functions
are correctly handled. See their respective docstrings for specific examples.
Functions
---------
.. autosummary::
:toctree: generated/
arccos
arcsin
arctanh
log
log2
logn
log10
power
sqrt
|