Repository files navigation

The Signal Processing Toolbox™ provides several functions to power spectrum estimation, includingpspectrum,pwelch andstft. Although these functions are of high quality and well-documented, they might be cumbersome in some engineering applications. These applications include estimating magnitudes of vibration, noise and other discrete-time signals in engineering units or comparing theoretical results with measurements.

In such applications, you can useautofft to estimate the discrete Fourier transform (DFT), which mimics the properties of the Brüel & Kjaer FFT analysers. Based on your input, autofft segments signal, applies window functions and performs spectral averaging. The resulting averaged spectrum, also calledmodified periodogram, can be returned in various engineering spectral units, including decibels, magnitude, root mean square (RMS), peak-to-peak and power spectral density (PSD). autofft can also estimate spectral derivation or spectral integral of DFT and perform the short-time Fourier transform (STFT).

In such applications, you can use theautofft package which mimics the properties of the Brüel & Kjaer FFT analysers. Based on your input,autofft automatically filter signal, separates it into segments, applies window functions and performs spectral averaging. The resulting averaged spectrum, also calledmodified periodogram, can be returned in various engineering spectral units, including decibels, root mean square (RMS) and peak-to-peak magnitudes, and power spectral density (PSD).autofft can also estimate spectral derivation or spectral integral of the spectrumm and perform the short-time Fourier transform (STFT).

• Does not require the Signal Processing Toolbox™.
• Performs significantly better thanpwelch andpspectrum in computationally intensive problems.
• Estimates magnitudes of components in your data in engineering units, e.g. dB, V or Pa.
• Provides control over the setup of the frequency analyser, which is impossible with library functions.
• Can apply high-pass and frequency weighting filters per ISO 61672, spectral derivation or spectral integration.

• v1.5.3:New functionality: The results are now visualised automatically or manually using'PlotLayout' and'EngineeringUnit' parameters.
• v1.5.3:Changed functionality:'HighPassFrequency' parameter now also accepts a filter object or numerator and denominator coefficientsb anda. This feature allows experienced users to use their own filters and store them in the setup structure array.
• v1.5.3:Documentation: New example added.
• v1.5.3:Documentation: Nomenclature have been unified and simplified.
• v1.5.2:Changed functionality: The package no longer requires the Signal Processing Toolbox™.
• v1.5.2:Changed functionality: A first-order Butterworth digital filter is now used for high-pass filtering rather than a first-order elliptic filter.
• v1.5.2:New functions: The package is now distributed with functions that can construct Blackman-Harris, flat-top, Hamming, Hann, Kaiser and uniform windows and can design an n-th order Butterworth digital filter. These functions can be found in+utilities directory.
• v1.5.1:Code optimisation: The STFT is now computed more efficiently.
• v1.5.1:Bug fix: In same cases, times for the STFT were evaluated more than once. This has been fixed.
• New functionality: The output spectra can be returned in decibel scale using the'dbReference' parameter.
• New function: AfreqWeight function, which applies frequency weighting filters to the power spectrum, is now included in the package.
• Documentation: New example added.
• Code optimisation: Times at which the STFT is evaluated are computed more efficiently.

For more information readuser manual or visit