WaveLabX

WaveLabX

WaveLabX is an open-source Python toolkit for laboratory wave-probe analysis, providing reproducible wave statistics and incident–reflected decomposition.

• Zero-crossing wave statistics from single-probe records
• Two-probe Goda–Suzuki frequency-domain decomposition
• Three-probe redundant-array decomposition with validity filtering

Installation

Recommended: use a Python virtual environment.

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Minimal usage

import wavelabx
# See run_wavelabx_example.ipynb for a full demonstration

Files included

• wavelabx/ — package source (API documented in docstrings)
• run_wavelabx_example.ipynb — example notebook
• wavedata.csv — example dataset
• figures/ — figures for manuscript and examples
• paper.md, paper.bib — JOSS manuscript source

License & Citation

WaveLabX is released under the MIT License (see LICENSE).

If you use WaveLabX in published research, please cite the associated JOSS manuscript and the archived software release on Zenodo. Citation metadata is provided in CITATION.cff.

Zenodo archive DOI: https://doi.org/10.5281/zenodo.18049227