import numpy
from dhbw import dasp
[docs]
def window(name, size):
"""
Returns coefficients of the specified window and size.
Parameters
----------
name : string
Window function name (rectangular, bartlett, blackman, hamming, hanning, kaiser).
size : int
Number of window coefficients to compute.
"""
# TODO https://docs.scipy.org/doc/scipy/reference/generated/scipy.signal.windows.get_window.html
assert isinstance(name, str)
assert isinstance(size, int)
if 'rectangular'.startswith(name.lower()):
return numpy.ones(size)
if 'bartlett'.startswith(name.lower()):
return numpy.bartlett(size)
if 'blackman'.startswith(name.lower()):
return numpy.blackman(size)
if 'hamming'.startswith(name.lower()):
return numpy.hamming(size)
if 'hanning'.startswith(name.lower()):
return numpy.hanning(size)
if 'kaiser'.startswith(name.lower()):
return numpy.kaiser(size, 14)
raise Exception(f'Invalid or unsupported window "{name}"!')
[docs]
def fft(x, norm=True, window='hanning'):
"""
Returns DFT of the specified real-valued array.
Parameters
----------
x : array
Real input array.
norm : bool, optional
Option whether to scale the output array by `1/N`.
window : str, optional
Window name.
Returns
-------
y : array
Complex output array.
"""
if window is not None:
x = x * dasp.fft.window(window, len(x))
y = numpy.fft.rfft(x, norm=('forward' if norm else 'backward'))
return y
[docs]
def ifft(x, norm=True):
"""
Returns IDFT of the specified complex-valued array.
Parameters
----------
x : array
Complex input array.
norm : bool, optional
Option whether to scale the output array by `1*N`.
Returns
-------
y : array
Real output array.
"""
y = numpy.fft.irfft(x, norm=('forward' if norm else 'backward'))
return y
[docs]
def abs(x, y, db=True, window='hanning'):
"""
Returns DFT frequencies and corresponding absolute values
of the specified timeline x and signal amplitudes y.
Alternatively specify the sample rate instead of the timeline x.
Parameters
----------
x : array or float
Timeline or sample rate.
y : array
Input signal amplitudes.
db : bool, optional
Express frequencies in decibel.
window : str, optional
Window name.
Returns
-------
freqs : array
Frequency array.
power : array
Corresponding absolute values.
"""
sr = x if numpy.isscalar(x) \
else int(len(x) / numpy.ptp(x)) # 1 / (duration / samples)
dft = dasp.fft.fft(y, window=window)
freqs = numpy.fft.rfftfreq(len(x), 1 / sr)
power = dasp.math.abs(dft, db=db)
return freqs, power
[docs]
def arg(x, y, wrap=None, window='hanning'):
"""
Returns DFT frequencies and corresponding argument values
of the specified timeline x and signal amplitudes y.
Alternatively specify the sample rate instead of the timeline x.
Parameters
----------
x : array or float
Timeline or sample rate.
y : array
Input signal amplitudes.
wrap : bool, optional
Explicitly wrap or unwrap argument values.
window : str, optional
Window name.
Returns
-------
freqs : array
Frequency array.
phase : array
Corresponding argument values.
"""
sr = x if numpy.isscalar(x) \
else int(len(x) / numpy.ptp(x)) # 1 / (duration / samples)
dft = dasp.fft.fft(y, window=window)
freqs = numpy.fft.rfftfreq(len(x), 1 / sr)
phase = dasp.math.arg(dft, wrap=wrap)
return freqs, phase