OpenConMo
Python library for vibration signal–based condition monitoring, developed at Aalto University, Finland.
The objectives of the library are:
- Provide easy access to reproducing signal based condition monitoring papers
- 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 arotor.software@aalto.fi
Metadata
Release files for openconmo 0.0.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| openconmo-0.0.6.tar.gz | 20.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| openconmo-0.0.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 40.5 kB
Release files / openconmo-0.0.6.tar.gz
| Download URL | openconmo-0.0.6.tar.gz |
|---|---|
| Size | 20.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2b84cd4ba104067e76253032248c9387c6d56f3c76224847321da40413ef9b81
|
|
BLAKE2b-256 checksum How to use checksums |
c9900ea87d2f324ae9e0a2755df017bca8701b0ddfda24350e0fa755cae2d378
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.1
|
Release files / openconmo-0.0.6-py3-none-any.whl
| Download URL | openconmo-0.0.6-py3-none-any.whl |
|---|---|
| Size | 20.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
eb8a9160c7805ad257407591123de58e63706b6f17b49763c96c10464b339a1d
|
|
BLAKE2b-256 checksum How to use checksums |
db1de41f8663816f579f20427035b7e35030d542f100ac4cd6956b2974f68193
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.1
|