pydvma 0.9.9

No project description provided

pydvma

A Python package for dynamics and vibration measurements and analysis.

About pydvma

This is a modular library for data measurement and analysis in the context of dynamics and vibration, for use in student laboratory experiments as well as for research projects, developed at Cambridge University Engineering Department.

A high-level interface allows straightforward application for common use-cases and a low-level interface provides more control when needed.

The aim is for a library that is simple to use and simple to maintain. It is not a full-featured GUI, but when used in conjunction with Jupyter Notebooks it is intended to provide the best of both worlds: interactive tools for common tasks and a command line interface for customisation.

Getting started

Installation

The logger is recommended for use with Python 3.10.

pip install pydvma

Or clone this repository and install using:

python setup.py install

Alternatively if you use anaconda then the following creates a Python 3.10 environment with the required packages:

conda create -n py310 python=3.10
conda activate py310
conda install numpy scipy jupyter matplotlib pyqtgraph
pip install pydvma

If you would like soundcard acquisition then also install sounddevice:

pip install sounddevice

If you would like National Instruments acquisition then you need to install the NIDAQMX v17.6 driver from National Instruments (here) and also install pydaqmx:

pip install pydaqmx

Running the logger

To get started, open the file:

pydvma_template.ipynb

or within a Jupyter Notebook or Python console:

import pydvma as dvma
import matplotlib

%matplotlib qt
settings = dvma.MySettings()
logger = dvma.Logger(settings)

Roadmap

At present the library has basic functionality for:

• logging data using soundcards or National Instrument DAQs (requires NiDAQmx to be installed from NI, windows only)
• logging with pre-trigger for impulse response measurements
• logging with pc generated output (soundcard and NIDAQ)
• computing frequency domain data
• computing transfer function data
• computing sonograms/spectrograms
• basic modal analysis tools (mode-fitting)
• saving and plotting data
• export to Matlab
• interactive tools for standard acquisition and analysis
• oscilloscope view of input signals

The plan is to include the following functionality:

• wider support for import/export
• more advanced modal analysis tools (e.g. global fitting)
• extend the range of hardware that can be accessed from this library

Contributer guidelines

Contributions to this project are welcomed, keeping in mind the project aims above:

• If you find a bug, please report using GitHub's issue tracker

• For bug-fixes and refinements: please feel free to clone the repository, make edits and create a pull request with a clear description of changes made.

• If you would like to make a more significant contribution or change, then please be in contact to outline your suggestion.

Please see the documentation for details of the code structure and templates for anticipated applications.