The mbari-pbp package allows to process ocean audio data archives to daily analysis products of hybrid millidecade spectra using PyPAM.
Status: Functional version, including support for cloud based processing.
- JSON generation of timekeeping with indication of start and duration of recognized sound files
- Audio file processing
- Frequency and psd array output
- Concatenation of processed 1-minute segments for daily product
- Calibration with given sensitivity file (NetCDF), or flat sensitivity value
- Data products
- NetCDF with metadata
- Summary plot
- Cloud processing
- Inputs can be downloaded from and uploaded to S3
- Inputs can be downloaded from public GCS bucket
- Outputs can be uploaded to GCS
Example plot of a daily hybrid millidecade generated with the
pbp hmb-plot command:
Official documentation is available at docs.mbari.org/pbp.
Please see https://docs.mbari.org/pbp/#installation.
The mbari-pbp package includes command line interface (CLI) programs, and also provides APIs you can use in your Python scripts or notebooks.
The pbp CLI program includes the following commands:
| Invocation | Description |
|---|---|
pbp meta-gen |
Generate JSON files with audio metadata |
pbp hmb-gen |
Main HMB generation program |
pbp cloud |
Program for cloud based processing |
pbp hmb-plot |
Utility program to plot HMB product |
API documentation is available at docs.mbari.org/pbp/api.
- PyPAM - Python tool for Passive Acoustic Monitoring – https://doi.org/10.5281/zenodo.6044593
- Computation of single-sided mean-square sound pressure spectral density with 1 Hz resolution follows ISO 18405 3.1.3.13 (International Standard ISO 18405:2017(E), Underwater Acoustics – Terminology. Geneva: ISO) – https://www.iso.org/standard/62406.html
- Hybrid millidecade spectra: A practical format for exchange of long-term ambient sound data – https://asa.scitation.org/doi/10.1121/10.0003324
- Erratum: Hybrid millidecade spectra – https://asa.scitation.org/doi/10.1121/10.0005818
Interested in contributing? Please see DEVELOPMENT.md for details.