pydvma
A Python package for dynamics and vibration measurements and analysis.
About
pydvma is a modular library for data measurement and analysis in the context of dynamics and vibration, developed at the University of Cambridge Department of Engineering. It's designed for use in student laboratory experiments and research projects.
Key features:
- Data acquisition via soundcards or National Instruments DAQs
- Pre-trigger recording and PC-generated output stimulus for impulse/transfer-function measurements
- FFT, transfer functions, coherence, and spectrograms (STFT and CWT)
- Modal analysis tools (mode-fitting, damping estimation)
- A browser-based web logger with a live oscilloscope, analysis and modal-fitting views
- Export to
.dvma, MATLAB and CSV; theme-invariant figure export (PNG/PDF)
The web logger — the recommended interface
The interactive interface is now the web logger, which runs in three modes over one shared analysis engine:
| Mode | Open it | Install |
|---|---|---|
| Pages app — analysis of saved files + soundcard capture | torebutlin.github.io/pydvma/app/ | none |
| Local bridge — the same app driving real hardware (soundcard or NI-DAQ) | pydvma-serve --open |
pip install "pydvma[serve,soundcard]" |
JupyterLite — import pydvma in a browser notebook |
torebutlin.github.io/pydvma/lite/ | none |
The earlier desktop Qt logger GUI has been removed now that the web logger has full parity (its last version is the
qt-finalgit tag).
Quick Start
Analyse or measure in the browser with no install — open the
Pages app and drag in a
.dvma, .npy or .mat file, or capture from a soundcard.
To drive real hardware (soundcard or NI-DAQ) from the same app on your own machine:
pip install "pydvma[serve,soundcard]" # add [ni] for National Instruments
pydvma-serve --open # serves the app + bridge, opens a browser
[serve] on its own installs only the bridge itself — name the
backends you need alongside it (soundcard, ni), or use
pydvma[full] for both.
To script analysis and acquisition in Python:
import pydvma as dvma
dataset = dvma.load_data('measurement.dvma') # or record with log_data
freq = dvma.calculate_fft(dataset.time_data_list[0])
Plain pip install pydvma installs the analysis-only core (data
structures, FFT/TF/modal analysis, file I/O) with no hardware
dependencies — it runs anywhere, including in-browser under pyodide.
Native data format is .dvma (safe, pickle-free); .npy files saved
by older versions still load.
Documentation
Full documentation: torebutlin.github.io/pydvma
- Installation Guide - Detailed setup instructions
- Quick Start - Get up and running quickly
- User Guide - Comprehensive usage guides
- API Reference - Detailed API documentation
Contributing
Contributions are welcomed:
- Report bugs via GitHub Issues
- Submit pull requests for bug fixes and improvements
- Contact us for significant changes or new features
See the Contributing Guide for details.
Support & citation
pydvma is free and open for everyone — no features are gated. If it
supports your teaching or research, the most valuable thing you can do is
cite it. This repository includes a
CITATION.cff file, so GitHub's "Cite this repository"
button and most reference managers can import the citation directly.
If your institution would like to support continued development, or you would simply like to tell us how you use pydvma, get in touch: tb267@cam.ac.uk. See the Support & citation page for details (a DOI will follow via Zenodo once a release is archived).
License
BSD 3-Clause License - see LICENSE for details.
1 maintainer
Metadata
1 maintainer
Release files for pydvma 2.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| pydvma-2.5.0.tar.gz | 821.3 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pydvma-2.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 8.4 MB
Release files / pydvma-2.5.0.tar.gz
| Download URL | pydvma-2.5.0.tar.gz |
|---|---|
| Size | 821.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3ce7609897777b7a32940dc298a3b6f7cf5288ff4f72c7de6bfcab407adac8e0
|
|
BLAKE2b-256 checksum How to use checksums |
34474886f157c0e8f868c1655db95024cc93478c3b74263a13211b3ac3de38e1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Release files / pydvma-2.5.0-py3-none-any.whl
| Download URL | pydvma-2.5.0-py3-none-any.whl |
|---|---|
| Size | 7.6 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d90204747642b3587bfd1ebd1f7b152ae25c39b3a2c93c722035c44d082c82e7
|
|
BLAKE2b-256 checksum How to use checksums |
c26ab15e4348bcc3340c3896819555a5215ea352cbcb6bd4d9d3bb3481a55ee5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Security for pydvma 2.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
