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 intrinsic Beamformer.synthetic method. It can, however, also be used with the Beamformer.integrate output and more frequency bands.

Parameters:

data : array of floats

The spectral data (sound pressures in Pa) in an array with one value per frequency line. The number of entries must be identical to the number of grid points.

freq : array of floats

The frequencies that correspon to the input data (as yielded by the PowerSpectra.fftfreq method).

f : float or list of floats

Band center frequency/frequencies for which to return the results.

num : integer

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 used FFT block size.