acoular.spectra.synthetic¶
- acoular.spectra.synthetic(data, freqs, f, num=3)¶
Returns synthesized frequency band values of spectral data.
If used with
Beamformer.result()
and only one frequency band, the output is identical to the result of the intrinsicBeamformer.synthetic
method. It can, however, also be used with theBeamformer.integrate
output and more frequency bands.- Parameters:
- dataarray of floats
The spectral data (squared sound pressures in Pa^2) in an array with one value per frequency line. The number of entries must be identical to the number of grid points.
- freqarray of floats
The frequencies that correspon to the input data (as yielded by the
PowerSpectra.fftfreq
method).- ffloat or list of floats
Band center frequency/frequencies for which to return the results.
- numinteger
Controls the width of the frequency bands considered; defaults to 3 (third-octave band).
num
frequency band width
0
single frequency line
1
octave band
3
third-octave band
n
1/n-octave band
- Returns:
- array of floats
Synthesized frequency band values of the beamforming result at each grid point (the sum of all values that are contained in the band). Note that the frequency resolution and therefore the bandwidth represented by a single frequency line depends on the
sampling frequency
and usedFFT block size
.