mbari-pbp 0.3.0b4

PyPAM based Processing

PyPAM based data processing

This package uses PyPAM to generate hybrid millidecade band spectra for soundscape data.

Status: Functional version, including support for cloud based processing.

• JSON generation of timekeeping
• Timekeeping based on given JSON indicating start and duration of every available (recognized) sound file
• Audio file processing
  • Frequency and psd array output
  • Concatenation of processed 1-minute segments for daily product
  • Calibration with given sensitivity file (NetCDF)
  • Calibration with given flat sensitivity value
• Data products
  • NetCDF with metadata
  • CSV (optional)
  • Summary plot (optional)
• Cloud processing
  • Inputs can be downloaded from S3
  • Outputs can be uploaded to S3
  • Inputs can be downloaded from public GCS bucket
  • Outputs can be uploaded to GCS

TODO more details

Setup

Install PBP

pip install mbari-pbp

Programs

• pbp - Main PBP program, run pbp --help for usage.

• pbp-cloud - Program for cloud based processing. All parameters passed via environment variables, see source file.

• pbp-plot - Plotting program: pbp-plot.py --help.

• pbp-json-gen - Program to generate JSONs with audio metadata, run pbp-json-gen --help for usage.

Refs

• 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

See DEVELOPMENT.md for details.