twistpy.array_processing.BeamformingArray.beamforming#

BeamformingArray.beamforming(method: str = 'MUSIC', event_time: Optional[UTCDateTime] = None, frequency_band: tuple = (90.0, 110.0), window: int = 5, number_of_sources: int = 1) ndarray[source]#

Compute beam power at specified time window location for this instance of class BeamformingArray.

Parameters
methodstr, default=’MUSIC’

Beamforming method to use.

Hint

‘BARTLETT’: Conventional beamforming.

‘MVDR’: Minimum Variance Distortionless Response beamformer or Capon beamformer. In seismology, often referred to as FK method.

‘MUSIC’: Multiple Signal Classification.

event_timeUTCDateTime

Start time of the analysis window

frequency_bandtuple

Frequency band over which beamforming is performed, specified as (minimum_frequency, maximum_frequency). (Covariance matrices are averaged within this frequency band)

windowfloat

Length of the time window defined as the number of dominant periods included in the window, where the dominant period is defined as 1/mean(minimum_frequency, maximum_frequency))

number_of_sourcesint

Number of sources that are estimated (only relevant for MUSIC, defaults to 1)

Returns
Pndarray

Beampower as an array of shape (N_incilination_grid, N_azimuth_grid, N_velocity_grid)