/RBDtector

RBDtector detects phasic, tonic and any events linked to REM sleep behaviour disorder. It closely follows SINBAR and AASM scoring guidelines.

Primary LanguagePythonMIT LicenseMIT

RBDtector

A python software tool to detect REM sleep behavioral disorder (RBD) in .edf files. Relies on .txt files of previously classified periods of sleep phases and arousals.

Table of contents:

  1. How to install
    1. Windows
    2. Mac and Linux
  2. License
  3. Acknowledgements

How to install

Windows

  1. Download the zipped version of RBDtector here: dist/RBDtector.zip
  2. Extract the zip file into a folder of your choice
  3. Click the extracted RBDtector.exe to run RBDtector

In some cases, Windows Defender SmartScreen will flag RBDtector as an 'Application of unknown source'. This warning can simply be clicked away. If you want to, you can also submit the file to Windows' malware analysis before trusting it.

Mac and Linux

Installing RBDtector under MacOS or Linux requires the usage of simple terminal commands. General commands that work in the terminals of both operating systems can be found here.

  1. Prerequisites: Ensure you have a version of Git and Python 3 installed (including pip and tkinter - usually already included in Python 3)
  2. Open a terminal
  3. (optional: navigate to a folder into which you want to place RBDtector)
  4. Enter the following commands line by line:
    1. Clone git repository git clone https://github.com/aroethen/RBDtector.git
    2. Install requirements python3 -m pip -r RBDtector/requirements.txt
    3. Change into folder with main.py cd RBDtector/RBDtector
    4. Run with python3 main.py

License

This project is licensed under the MIT License (s. LICENSE file).

Acknowledgements

This project gratefully uses the following third-party open source libraries:

Library License
pyEDFlib BSD 2-Clause "Simplified" License
numpy [BSD 3-Clause "New" or "Revised" License] (https://github.com/numpy/numpy/blob/main/LICENSE.txt)
pandas [BSD 3-Clause "New" or "Revised" License] (https://github.com/pandas-dev/pandas/blob/main/LICENSE)
scipy [BSD 3-Clause "New" or "Revised" License] (https://github.com/scipy/scipy/blob/main/LICENSE.txt)
openpyxl [MIT License] (https://foss.heptapod.net/openpyxl/openpyxl/-/blob/branch/3.0/LICENCE.rst)