db()

audmath.db(x, *, bottom=-120)

Convert value to decibels.

The decibel of a value $x \in \R$ is given by

$$\text{db}(x) = \begin{cases} 20 \log_{10} x, & \text{if } x > 10^\frac{\text{bottom}}{20} \\ \text{bottom}, & \text{else} \end{cases}$$

where $\text{bottom}$ is provided by the argument of same name.

Parameters

• x (Union[int, float, Sequence, ndarray]) – input value(s)

• bottom (Union[int, float]) – minimum decibel value returned for very low input values. If set to None it will return -np.Inf for values equal or less than 0

Return type

Union[floating, ndarray]

Returns

input value(s) in dB

Examples

>>> db(1)
np.float64(0.0)
>>> db(0)
np.float64(-120.0)
>>> db(2)
np.float64(6.020599913279624)
>>> db([0, 1])
array([-120.,    0.])