ScoreREM: A user friendly Matlab-GUI for rapid eye movement (REM) sleep microstructure (Phasic/Tonic) annotation and quantification

Licence:
ScoreREM Copyright (C) 2024 Kiran K G Ravindran. Refer to the License.txt for more details.

Overview

ScoreREM is a user-friendly Matlab GUI that allows rapid annotation and quantification of rapid eye movement (REM) sleep microstructure. It allows import of sleep polysomnography recordings collected in EDF format, automatically score the hypnogram and REM events. These recordings can range from full polysomnography recordings to partial polysomnography recordings with a minimum of one electroencephalography, electrooculography and electromyography signals available. Legacy cassette recordings and R&K hypnograms are also supported by the application. Custom recording start times can be set using a text file containing markers. Additional channels derivations can be created. Users can choose the segmentation length for scoring the events and filtering options and view the data in the GUI. The application allows the user to loop through REM epochs, score the micro segments as Phasic/Tonic/Artefact, edit the existing sleep scoring and export the scored labels and summary measures for further analysis. The application can also be used for general-purpose scoring of epoch micro segments in other sleep stages as well.

Requirements and Installation

• ScoreREM Matlab: 2023b or newer with signal processing toolbox to allow scoring and export of the labels and analysis results.
• The automatic sleep staging and REM event detection is facilitated via Python language interpreter in Matlab and requires compatible Python 3.11.6 installation and supporting packages (YASA and MNE).
• The app allows manual scoring in the absense of the python installation

The application can be installed using the .mlappinstall file in src.

We have provided a standalone version of ScoreREM which works with the Matlab runtime.

We have provided the supporting documentation to help with the installation. To install Python 3.11.6 and the required packages, read the instructions in installation support.

The application requires 24 inch screen or over to display correctly.

Please refer to the documentation (Supplemental Materials of the citation below) and citation below for more details.

Example Data

The example templates for the Marker and hypnograms txt files can be found in examplefiles. Public repositories containing example EDF data for exploring the application can be found here:

1. Haaglanden Medisch Centrum sleep staging database
2. Sleep-EDF Database Cassette PSG

Acknowledgements

This work was supported by the UK Dementia Research Institute, [award number UKDRI-7005], through UK DRI Ltd, principally funded by the UK Medical Research Council, and additional funding partner Alzheimer’s Society. The authors thank Dr Valeria Jaramillo, Dr Sara Wong, Giuseppe Atzori, and Marta Messina Pineda for their helpful feedback during software development and testing of the ScoreREM for user acceptability.

Citation

For any use of ScoreREM please cite:

Preprint

(For downloading the article follow the DOI link or go to the Preprint folder above)

1. G Ravindran, Kiran K. and Dijk, Derk-Jan, ScoreREM: A User-Friendly Matlab-GUI for Rapid Eye Movement (REM) Sleep Microstructure (Phasic/Tonic) Annotation and Quantification. Available at SSRN: https://ssrn.com/abstract=4882491 or http://dx.doi.org/10.2139/ssrn.4882491

For general in-text referencing guidelines for softwares:

Katz DS, Chue Hong NP, Clark T et al. Recognizing the value of software: a software citation guide [version 2; peer review: 2 approved]. F1000Research 2021, 9:1257 (https://doi.org/10.12688/f1000research.26932.2)