scipy 1.8.0 Pypi GitHub Homepage
Other Docs
NotesParametersReturnsBackRef
hilbert(x, N=None, axis=-1)

The transformation is done along the last axis by default.

Notes

The analytic signal x_a(t) of signal x(t) is:

$$x_a = F^{-1}(F(x) 2U) = x + i y$$

where :None:None:`F` is the Fourier transform, :None:None:`U` the unit step function, and :None:None:`y` the Hilbert transform of x.

In other words, the negative half of the frequency spectrum is zeroed out, turning the real-valued signal into a complex signal. The Hilbert transformed signal can be obtained from np.imag(hilbert(x)) , and the original signal from np.real(hilbert(x)) .

Parameters

x : array_like

Signal data. Must be real.

N : int, optional

Number of Fourier components. Default: x.shape[axis]

axis : int, optional

Axis along which to do the transformation. Default: -1.

Returns

xa : ndarray

Analytic signal of x, of each 1-D array along :None:None:`axis`

Compute the analytic signal, using the Hilbert transform.

Examples

In this example we use the Hilbert transform to determine the amplitude envelope and instantaneous frequency of an amplitude-modulated signal.

>>> import numpy as np
... import matplotlib.pyplot as plt
... from scipy.signal import hilbert, chirp
>>> duration = 1.0
... fs = 400.0
... samples = int(fs*duration)
... t = np.arange(samples) / fs

We create a chirp of which the frequency increases from 20 Hz to 100 Hz and apply an amplitude modulation.

>>> signal = chirp(t, 20.0, t[-1], 100.0)
... signal *= (1.0 + 0.5 * np.sin(2.0*np.pi*3.0*t) )

The amplitude envelope is given by magnitude of the analytic signal. The instantaneous frequency can be obtained by differentiating the instantaneous phase in respect to time. The instantaneous phase corresponds to the phase angle of the analytic signal.

>>> analytic_signal = hilbert(signal)
... amplitude_envelope = np.abs(analytic_signal)
... instantaneous_phase = np.unwrap(np.angle(analytic_signal))
... instantaneous_frequency = (np.diff(instantaneous_phase) /
...  (2.0*np.pi) * fs)
>>> fig, (ax0, ax1) = plt.subplots(nrows=2)
... ax0.plot(t, signal, label='signal')
... ax0.plot(t, amplitude_envelope, label='envelope')
... ax0.set_xlabel("time in seconds")
... ax0.legend()
... ax1.plot(t[1:], instantaneous_frequency)
... ax1.set_xlabel("time in seconds")
... ax1.set_ylim(0.0, 120.0)
... fig.tight_layout()
See :

Back References

The following pages refer to to this document either explicitly or contain code examples using this.

scipy.signal._signaltools.hilbert

Local connectivity graph

Hover to see nodes names; edges to Self not shown, Caped at 50 nodes.

Using a canvas is more power efficient and can get hundred of nodes ; but does not allow hyperlinks; , arrows or text (beyond on hover)

SVG is more flexible but power hungry; and does not scale well to 50 + nodes.

All aboves nodes referred to, (or are referred from) current nodes; Edges from Self to other have been omitted (or all nodes would be connected to the central node "self" which is not useful). Nodes are colored by the library they belong to, and scaled with the number of references pointing them


GitHub : /scipy/signal/_signaltools.py#2194
type: <class 'function'>
Commit: