sleep-scoring

Sleep is a flexible open-source graphical user interface for visualization, analysis and scoring of polysomnographic sleep data. It was originally developed by Etienne Combrisson in collaboration with Raphael Vallat and Christian O Reilly. This standalone version was devleoped by Anjo Pagdanganan under the guidance of Omer Sharon at the Center for Human Sleep Sciene at UC Berkeley in order to allow direct installation in a contemporary python environment. It also includes some bug fixes and new features, such as:

• Signal graph backgrounds colored according to hypnogram

• Hypnogram live updates during scoring

• Option to save old and new formats for hypnogram data

A copy of the relevant documentation is provided in this repo, but can also be found at the original Visbrain repo. This copy contains not just the documentation for Sleep, but also the rest of Visbrain’s documentation for archival purposes.

Example code can be found under examples/gui_sleep

Installation

It is recommended to install this in a virtual environment using conda. This package was developed on Python 3.12 but has been shown to work with Python >= 3.9.:

python -m pip install sleep-scoring

(It is recommended to preface pip with python -m to ensure it uses the virtual environment’s installation of python)

Start scoring

Sleep can be deployed using this python script (see examples/basic_sleep.py):

from sleep_scoring.gui import Sleep

Sleep().show()

You can either start Python in the terminal with the python command and write the commands there, or you can create a python script and run it.

Citation

Combrisson E, Vallat R, Eichenlaub J-B, O’Reilly C, Lajnef T, Guillot A, Ruby PM and Jerbi K (2017) Sleep: An Open-Source Python Software for Visualization, Analysis, and Staging of Sleep Data. Front. Neuroinform. 11:60. doi: 10.3389/fninf.2017.00060