Skip to content

Staging: SOAP

Self-contained modelling and evaluation of sleep staging

This page is under development: please see this vignette for more details.

Command Description
SOAP Single-observation accuracies and probabilities
REBASE Use SOAP to translate between epoch lengths (e.g. 20 to 30 second manual staging)
PLACE Use SOAP to localize "lost" stage annotations

This suite of commands are based around the SOAP (Single Observation Accuracies and Probabilities) function in Luna. In brief, SOAP generates a battery of epochwise features based on one or more channels, and then fits a simple (linear discriminant analysis) to those data, which the observed stages (i.e. passed as annotations) as the outcomes. If the signal is a) of sufficient quality, and b) is related to observed sleep stages via the computed features, then SOAP should be able to generate a model that explains the observed stages quite well. This can be assessed, for example, via the kappa coefficient between observed and predicted stages.

!!! info The SOAP command requires existing stage annotation, i.e. similar to the HYPNO command (whether these existing annotations are from manual scoring, or from an external, automated staging algorithm). That is, it does not predict sleep stages from scratch, given only signal data. For automated staging, see Luna's POPS command.

Overall, SOAP can be viewed in two ways: 1) as a tool to check the consistency between signals & staging, 2) as a tool to manipulate/use the existing staging, on the assumption that stages and signals are largely consistent.

SOAP

Single observation stage accuracies and probabilities

Parameters

to be completed

Output

to be completed

Example

to be completed

REBASE

Translate existing (manual) staging between different epoch durations (e.g. from 20 second to 30 seconds epoch) using the SOAP model

Parameters

to be completed

Output

to be completed

Example

to be completed

PLACE

Temporally align existing staging signal data

Parameters

to be completed

Output

to be completed

Example

to be completed

Back to top