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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pydvma-2.4.1.tar.gz.
File metadata
- Download URL: pydvma-2.4.1.tar.gz
- Upload date:
- Size: 785.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c96a32b2b82903e466131be80d1c6239b25e31c1962072f39b85f20779edfdd4
|
|
| MD5 |
e9df1953aa382c4f5b553abf4d00ee04
|
|
| BLAKE2b-256 |
8c68bdffe1899f305052d55e816cfabbae67863973fd04dc2d18f78f7d35fcfd
|
File details
Details for the file pydvma-2.4.1-py3-none-any.whl.
File metadata
- Download URL: pydvma-2.4.1-py3-none-any.whl
- Upload date:
- Size: 7.5 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f2a9f903068d9a938d13c128b277d6097c57e4ea3b030e2b8f61a2b75b1c2e9e
|
|
| MD5 |
87a09af8731f9c589f09c4475a2b95a1
|
|
| BLAKE2b-256 |
29628db9cc568cf97f9e0337fe38e4eb3c1b5fd8b247ef5c270ad71eb5a7d49f
|
