Skip to content

BraPolar is an Android m-Health for remote monitoring patients with Bipolar Affective Disorder, presenting real-time mood and behavior fluctuations in participants through interaction with their mobile devices.

License

Notifications You must be signed in to change notification settings

abelgonzalez/BraPolar

Repository files navigation

BraPolar 👨‍🔬


🧾 About

BraPolar v1.0, is an Android m-Health for remote monitoring of patients with Bipolar Affective Disorder. The app presents real-time mood and behavior fluctuations to specialists from participants through their interaction with mobile devices. This project was part of my master's degree dissertation in Brazil. In this work, I could execute all software development cycles from scratch, including Android applications, and documentation. Also, I could practice all research processes of scientific research writing and presenting this work at an international conference in Kyoto, Japan.


📷 Screenshots

Project scratch

Task planning

Bipolar symptoms and how follow-up with cellphone sensors

Firebase data stream architecture

**BraPolar login (left), participant home (center), keyboard typing (right)

Firebase active users during data capture

Firebase non-relational database instance sample

Specialist user (center) monitoring Mood fluctuations of two patients (left and right)

Paper presentation in Kyoto, Japan


🕖 Versioning

  • BraPolar v3.0 (expected in 20/06/2023)
  • BraPolar v2.4 (relased in 07/07/2022)
  • BraPolar v2.3 (relased in 21/05/2022)
  • BraPolar v2.2 (relased in 02/08/2021)
  • BraPolar v2.1 (relased in 17/11/2020)
  • BraPolar v2.0 (relased in 19/07/2019)
  • BraPolar v1.0 (relased in 11/02/2019)
  • BraPolar v0.5 (relased in 12/10/2018)

This project was part of my master's degree dissertation and my Ph.D. thesis, which is running. From v1.0, to preserve scientific code rights, I will not upload new public versions on Github until concluding my doctoral degree and get the authorization to publish all code.


✅ Main tracking features

  • Mood
  • Medication
  • Sleep patterns
  • Status Overview
  • Physical activity
  • Social interaction
  • Psycho-motor activity
  • Specialized assistance
  • Acoustic characteristics

🔧 Technology


👨‍💻 How to Setup

  # Clone the project
  $ git clone https://github.com/abelgonzalez/BraPolar.git
  # Enter directory
  $ cd BraPolar

Download and install:


😎 How to Run

*Build a BraPolar app:

  • Make sure the database in Firebase was correctly loaded, and you have a stable internet connection.
  • Load the root project folder (BraPolar) with Android Studio and run it.
  • When apps run, grant all permissions to android application.

or

*Executes an apk in your Android phone:

  • Enter in (...)\BraPolar\app\build and execute "BraPolarv1.0.apk" with login "login instructions.txt".

🤓 Scientific contributions

  • A. González Mondéjar, G. F. M. Silva-Calpa, A. Barbosa Raposo and D. C. Mograbi, "BraPolar: an M-Health Application for Remote Monitoring of People with Bipolar Disorder," 2019 IEEE 7th International Conference on Serious Games and Applications for Health (SeGAH), Kyoto, Japan, 2019, pp. 1-8, doi: 10.1109/SeGAH.2019.8882469.
  • A. González Mondéjar, G. F. M. Silva-Calpa, A. Barbosa Raposo and D. C. Mograbi, "An m-Health Application for Remote Monitoring of People with Bipolar Disorder through Digital Phenotyping and Smartphone Dependency," 2020 IEEE 33rd International Symposium on Computer-Based Medical Systems (CBMS), Rochester, MN, USA, 2020, pp. 388-391, doi: 10.1109/CBMS49503.2020.00080.

👉 Additional information

  • App Demo YouTube
  • BraPolar patient interaction demo YouTube
  • BraPolar specialists interaction demo YouTube
  • Master degree dissertation document (in Portuguese).
  • In case of sensitive bugs like security vulnerabilities, don't hesitate to contact me at abelgodev@gmail.com instead of using the issue tracker. I value your effort to improve the security and privacy of this project!

📝 License

This project is under the MIT license. See the file LICENCE for more details.


🧑‍💻 Author

Done with 💙 by Abel González Mondéjar

LinkedIn Badge

About

BraPolar is an Android m-Health for remote monitoring patients with Bipolar Affective Disorder, presenting real-time mood and behavior fluctuations in participants through interaction with their mobile devices.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages