Katrin Löer, Claudia Finger

We introduce the code package B3AM for beamforming of three-component ambient noise array data, which is available for MATLAB and Python. We explain the theory behind three-component beamforming and polarisation analysis in particular, provide an overview of the workflow, and discuss the output using a worked example based on the MATLAB implementation. The strength of the presented code package is the analysis of multiple beam response maps from multiple time windows. Hence, it provides statistical information about the ambient noise wavefield recorded over a period of time, such as the ratio of surface to body waves, average dispersion velocities, or dominant propagation direction. It can be used to validate assumptions made about the ambient noise wavefield in a particular location, helping to interpret results from other techniques, such as the analysis of horizontal-to-vertical spectral ratios or ambient noise interferometry, and enabling more precise monitoring of specific wavefield components. While designed initially with seismic networks in mind, B3AM is applicable over a wide range of frequencies and array sizes and can thus be adapted also for laboratory settings or civil engineering applications.