acoular.fbeamform.integrate¶
- acoular.fbeamform.integrate(data, grid, sector)¶
Integrates a sound pressure map over a given sector.
This function can be applied on beamforming results to quantitatively analyze the sound pressure in a given sector. If used with
Beamformer.result()
, the output is identical to the result of the intrinsicBeamformer.integrate
method. It can, however, also be used with theBeamformer.synthetic
output.- Parameters:
- data: array of floats
Contains the calculated squared sound pressure values in Pa**2. If data has the same number of entries than the number of grid points only one value is returned. In case of a 2-D array with the second dimension identical to the number of grid points an array containing as many entries as the first dimension is returned.
- grid: Grid object
Object of a
Grid
-derived class that provides the grid locations.- sector: array of floats or :class:`~acoular.grids.Sector`-derived object
Tuple with arguments for the indices method of a
Grid
-derived class (e.g.RectGrid.indices
orRectGrid3D.indices
). Possible sectors would be array([xmin, ymin, xmax, ymax]) or array([x, y, radius]). Alternatively, aSector
-derived object can be used.
- Returns:
- array of floats
The spectrum (all calculated frequency bands) for the integrated sector.