Skip to content

Commit

Permalink
update README
Browse files Browse the repository at this point in the history
  • Loading branch information
chanshing committed Nov 19, 2024
1 parent 04d4ba5 commit d97dc63
Showing 1 changed file with 9 additions and 8 deletions.
17 changes: 9 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
# Capture-24 Benchamrk
# CAPTURE-24 Benchamrk

The purpose of the Capture-24 dataset is to serve as a training dataset for developing Human Activity Recognition (HAR) classifiers.
The purpose of the CAPTURE-24 dataset is to serve as a training dataset for developing Human Activity Recognition (HAR) classifiers.
These classifiers enable the identification of activities performed by individuals wearing smartwatch accelerometers during unmonitored free-living, such as in the UK Biobank physical activity monitoring study.
Our goal is to ensure the use of the best possible model for accurate activity identification, with generalizable performance across different individuals and behaviors.
For more information on this dataset, you can go to the [webpage](https://ora.ox.ac.uk/objects/uuid:99d7c092-d865-4a19-b096-cc16440cd001) or [github repo](https://github.com/OxWearables/capture24).

The purpose of this repository is report a benchmark for trained HAR models on the Capture-24 dataset.
The purpose of this repository is report a benchmark for trained HAR models on the CAPTURE-24 dataset.
This can be done by either running through the [Benchmark.ipynb](Benchmark.ipynb) notebook, or by running through the set of command line scripts listed in the [Implementation](#implementation) section below.

## Methods
Expand All @@ -20,7 +20,7 @@ The numbered stages of this analysis present various possibilities and considera
### Stage 1: Participant accelerometery
<img src="wrist_accelerometer.jpg" width="300">

The Capture-24 dataset contains wrist-worn accelerometer data collected from 151 participants. To obtain ground truth annotations, the participants also wore a body camera during daytime, and used sleep diaries to register their sleep times.
The CAPTURE-24 dataset contains wrist-worn accelerometer data collected from 151 participants. To obtain ground truth annotations, the participants also wore a body camera during daytime, and used sleep diaries to register their sleep times.
Each participant was recorded for roughly 24 hours. The accelerometer was an Axivity AX3 wrist watch (image above) that mearures acceleration in all three axes (x, y, z) at a sampling rate of 100Hz.
The body camera was a Vicon Autographer with a sampling rate of 1 picture every 20 seconds.
Note that the camera images are not part of the data release — only the raw acceleration trace with text annotations are provided.
Expand Down Expand Up @@ -112,7 +112,7 @@ $ conda activate benchmark

### Data preparation

The Capture-24 data must first be prepared.
The CAPTURE-24 data must first be prepared.
This means it must be downloaded, extracted, and divided into 10s windows.
To do so, run:

Expand Down Expand Up @@ -157,7 +157,7 @@ When parsed as an argument in the `benchmark.py` script, all annotations and mod

## References
Dataset description and benchmark paper:
```tex
<!-- ```tex
@misc{chan2024capture24,
title={CAPTURE-24: A large dataset of wrist-worn activity tracker data collected in the wild for human activity recognition},
author={Shing Chan and Hang Yuan and Catherine Tong and Aidan Acquah and Abram Schonfeldt and Jonathan Gershuny and Aiden Doherty},
Expand All @@ -166,11 +166,12 @@ Dataset description and benchmark paper:
archivePrefix={arXiv},
primaryClass={cs.HC}
}
```
``` -->
Chan, S., Hang, Y., Tong, C. et al. CAPTURE-24: A large dataset of wrist-worn activity tracker data collected in the wild for human activity recognition. Sci Data 11, 1135 (2024). https://doi.org/10.1038/s41597-024-03960-3

Additional information about the dataset can be found [here](https://github.com/activityMonitoring/capture24_neurips/tree/master/data_info).

Papers that used the Capture-24 dataset:
Papers that used the CAPTURE-24 dataset:
- [Reallocating time from machine-learned sleep, sedentary behaviour or
light physical activity to moderate-to-vigorous physical activity is
associated with lower cardiovascular disease
Expand Down

0 comments on commit d97dc63

Please sign in to comment.