beampower 1.0.3

Package for beamforming/backprojection.

Welcome to the beampower repository!

About the package

beampower is a package for beamforming (or backprojection) of seismic signal for event detection and location. The Python wrapper can call the C (CPU) or CUDA-C (GPU) implementation. See the documentation at https://ebeauce.github.io/beampower/.

Installation

The simplest way to use BeamPower:

pip install beampower

GPU support is included if available.

Learn More

• Documentation: https://ebeauce.github.io/beampower/
• Tutorials: See the notebooks in the notebooks/ folder
  • Download seismic data
  • Pre-process waveforms
  • Calculate travel times
  • Locate events

For Developers

Clone and install locally:

git clone https://github.com/ebeauce/beampower.git
cd beampower

# Build the libraries FIRST (required for local development)
make clean
make  # builds both CPU and GPU libraries

# Then install
pip install .

If you modify C or CUDA code:

# For C code changes:
make clean
make python_CPU

# For CUDA code changes:
make clean
make python_GPU

# For both:
make clean
make

# Then reinstall to pick up changes:
pip install --force-reinstall .

Reference

Please, if you use this package for your research, cite:

Beaucé, Eric and Frank, William B. and Seydoux, Léonard and Poli, Piero and Groebner, Nathan and van der Hilst, Robert D. and Campillo, Michel (2023). BPMF: A Backprojection and Matched‐Filtering Workflow for Automated Earthquake Detection and Location. Seismological Research Letters. DOI: https://doi.org/10.1785/0220230230.