Mathematical functions with automatic domain

.. _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 numpy as np 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