PyPAM based data processing

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.

• [x] JSON generation of timekeeping with indication of start and duration of recognized sound files
• [x] Audio file processing
  • [x] Frequency and psd array output
  • [x] Concatenation of processed 1-minute segments for daily product
  • [x] Calibration with given sensitivity file (NetCDF), or flat sensitivity value
• [x] Data products
  • [x] NetCDF with metadata
  • [x] Summary plot
• [x] Cloud processing
  • [x] Inputs can be downloaded from and uploaded to S3
  • [x] 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:

Documentation

Official documentation is available at docs.mbari.org/pbp.

Installation

Please see https://docs.mbari.org/pbp/#installation.

Programs and API

The mbari-pbp package includes command line interface (CLI) programs, and also provides APIs you can use in your Python scripts or notebooks.

CLI Programs

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

API documentation is available at docs.mbari.org/pbp/api.

References

• 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

Development

Interested in contributing? Please see DEVELOPMENT.md for details.