Visualization of large amount of data for personalized medicine

Project of Scientific Research in the field of biomedical engineering with the aim of build a end-to-end system of collection,analysis and visualization of biomedical data related to neuromotors diseases as Parkinson Disease (PD) - the main studied disease in this project.

Getting Started

This research is divided in two different repositories. This one is focused on the control of the collection device, data receiving, data storage, processing, and visualization. In the other hand, the second repository - Inertial Data Collection Device - is focused on the hardware of inertial data collection and its firmware.

We made it with two different visions: (1) aimed to research studies; and (2) real-world data collection.
Furthermore, you can use this software in CLI mode or GUI mode. You can select the best option for your confort and requisites.

If you have any question, issue or sugestion feel free to send us a report on the discussion tab here on GitHub.

In order to use or develop this project you must install mainly pybluez and PySide2, since they are the core used in the process of this project at all.

Prerequisites

You need to install these things to run the project

sudo apt-get install python3-pyqt5 libbluetooth-dev bluetooth
pip3 install PySide2 pybluez

Executing

You need to remember that we have two different ways of execute the software, depending in which mode you want to use.

CLI

In order to execute the CLI interface you must edit the line 38 of the file src/cli/main.py changing the address of the bluetooth device as bellow:

bd_addr = "00:11:22:33:44:55"

Then, just run on terminal:

python3 src/cli/main.py

GUI

In order to execute the the GUI interface you must execute the following command on your terminal.

python3 src/app/main.py

Then you going to have the interface running on your computer.

Built With

• PySide2 5.15.2 - Cross-platform GUI toolkit Qt
• PyBluez 0.23 - Bluetooth Python extension module
• Python 3.6.9 - High-level programming language
• Qt Creator 4.14.0 - cross-platform, integrated development environment (IDE)
• Qt 5.15.2 - cross-platform application development framework

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

• Wanghley Soares Martins - junior researcher - wanghley
• Fábio Henrique Monteiro Oliveira - research advisor - oliveirafhm

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

• Built to impact the diagnosis of Parkinson's Disease all around the world
• To understand fully how the code works you must have a background of server-client communication
• You must understand that all communication process happens through Bluetooth. Consequently, a previous study of the protocol can help
• Feel free to use the code but do not forget to reference us