openconmo 0.0.6

A Python package for vibration signal based condition monitoring

OpenConMo

Python library for vibration signal–based condition monitoring, developed at Aalto University, Finland.
The objectives of the library are:

1. Provide easy access to reproducing signal based condition monitoring papers
2. Enable comparison of AI/ML based techniques with conventional signal processing tools

Installation

Install the latest version from PyPI:

pip install openconmo

Install and load datasets

If you want to download the original CWRU dataset in .mat format in separate files, you can use the code in tools/CWRU_download.py. Just run the code and the files will be downloaded to data/CWRU/RAW (the directory will be automatically created if missing). This is somewhat slow (~7 min).

The same code will create a CWRU.feather file, which holds the data in a format more easily read with python & pandas. The dataframe is formatted as follows:

measurement location	fault location	fault type	fault depth (mil)	fault orientation	sampling rate (kHz)	torque (hp)	tags	measurements
string	string	string	int	string	int	int	list[string]	np.array[np.float64]
DE/FE	DE/FE	OR/IR/B	0/7/14/21/28	C/OR/OP	12/48	0/1/2/3	see below	measurement samples

mil = 0.001 inches

Shorthand explanations: DE - drive end FE - fan end OR (fault type) - outer ring IR - inner ring B - ball / rolling element C - center () OR (orientation) - orthogonal OP - opposite

Possible tags (from Rolling element bearing diagnostics using the Case Western Reserve University data: A benchmark study): electric noise - measurement is has patches corrupted by electric noise clipped - measurement is clipped identical_DE_and_FE - measurements from DE and FE sensors are identical except with a scaling factor

Run notebooks

• Notebook 1: "smith_randall_example.ipynb", reproducing results of "Rolling element bearing diagnostics using the Case Western Reserve University data: A benchmark study" by Smith & Randall
• Notebook 2: "matlab_example.ipynb", reproducing results of "Rolling Element Bearing Fault Diagnosis"

Documentation

See openconmo documentation for documentation.

Requirements

• Numpy
• Pandas
• Scipy
• PyArrow (for loading datasets)

Authors

This software is authored and maintained by Sampo Laine, Sampo Haikonen, Aleksanteri Hämäläinen, Elmo Laine and Aku Karhinen, Mechatronics research group, Aalto University. Please email questions to [e-mail]