OxWearables/asleep
OxWearables/asleep has 61 GitHub stars and 17 forks. GitHot measured 0 stars in 24 hours, +1 in 7 days, and +4 in 15 days. Last checked 2026-11-17 16:20 UTC. Last push 2026-10-30.
측정된 스타 증가
- in 24h
- 0
- in 7 days
- +1
- in 15 days
- +4
- in 1 month
- 기록 수집 중
서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.
소개
asleep: a sleep classifier for wearable sensor data using machine learning
머신러닝README.md
Originalasleep: a sleep classifier for wearable sensor data using machine learning
This is a Python package for classifying sleep stages from wearable sensor data / wrist - worn accelerometer. The underlying model was trained and tested in 1000 + nights of multi - centre polysomnography with tri - axial accelerometer data.
The key features of this package are as follows:
- A simple and easy - to - use API for sleep stage classification.
- Sleep / wake metric estimation including total sleep duration and sleep efficiency.
- Sleep architecture metric estimation including rapid - eye - movement(REM) / NREM sleep duration.

Dependencies
- Python 3.8
- Java 8 (1.8.0) or greater
Check with:
$ python --version
$ java -version
Installation
$ pip install asleep
Development checks
Install the development dependencies and run the same quality gates used by tox:
$ pip install -e '.[dev,test]'
$ ruff check .
$ mypy
$ pytest
Usage
All the processing will be much faster after the first time because the model weights will to have to be downloaded the first time that the package is used.
# Process an AX3 file
$ get_sleep sample.cwa
# Or an ActiGraph file
$ get_sleep sample.gt3x
# Or a GENEActiv file
$ get_sleep sample.bin
# Or a CSV file (see data format below)
$ get_sleep sample.csv
Output
Summary
-------
{
"Filename": "sample.cwa",
"Filesize(MB)": 65.1,
"Device": "Axivity",
"DeviceID": 2278,
"ReadErrors": 0,
"SampleRate": 100.0,
"ReadOK": 1,
"StartTime": "2013-10-21 10:00:07",
"EndTime": "2013-10-28 10:00:01",
"Total sleep duration(min)": 655.7,
"Total overnight sleep(min)": 43132,
...
}
Estimated total sleep duration
---------------------
total sleep duration(min)
time
2013 - 10 - 21 435.2
2013 - 10 - 22 436.2
2013 - 10 - 23 432.2
...
Output: outputs /sample/
Visualisation
You can visualise the sleep parameters using the following command:
$ visu_sleep PATH_TO_OUTPUT_FOLDER
Processing CSV files
If a CSV file is provided, it must have the following header: time, x, y, z.
Example:
time, x, y, z
2013 - 10 - 21 10: 00: 08.000, -0.078923, 0.396706, 0.917759
2013 - 10 - 21 10: 00: 08.010, -0.094370, 0.381479, 0.933580
2013 - 10 - 21 10: 00: 08.020, -0.094370, 0.366252, 0.901938
2013 - 10 - 21 10: 00: 08.030, -0.078923, 0.411933, 0.901938
Citation
If you want to use our package for your project, please cite our paper below:
@article{yuan2024self,
title={Self-supervised learning of accelerometer data provides new insights for sleep and its association with mortality},
author={Yuan, Hang and Plekhanova, Tatiana and Walmsley, Rosemary and Reynolds, Amy C and Maddison, Kathleen J and Bucan, Maja and Gehrman, Philip and Rowlands, Alex and Ray, David W and Bennett, Derrick and others},
journal={NPJ digital medicine},
volume={7},
number={1},
pages={86},
year={2024},
publisher={Nature Publishing Group UK London}
}
Acknowledgements
We would like to thank all our code contributors, manuscript co - authors, and research participants for their help in making this work possible. The data processing pipeline of this repository is based on the step_count package from our group. Special thanks to @chanshing for his help in developing the package.
Maintainer documentation
See RELEASING.md for the package release process.