Welcome to the official online data repository of the KIDS framework; the Kinematic-based (In)activity Detection and Segmentation framework made especially for wearable inertial data collected during sleep

## Overview

- This repository contains preprocessed kinematics data collected from five human participants (PAs) who participated in simulated sleep trials. The data were preprocessed by two different preprocessing methods (UMAP and ADR methods). For each PA, two main CSV files are provided, for UMAP and ADR respectively, containing all preprocessed kinematic data collected throughout the simulated sleep session.

## Data Description

- Detailed description of the data, including its format and any preprocessing that was done.
- The preprocessed kinematics data is a three-dimensional (3D) timeseries, a low-dimensional representation of the hand-to-forearm orientation about the left wrist (LW) joint.

- The hand-to-forearm kinematics (originally 4D axis-angle orientations) were computed at 30 Hz using the Madgwick Filter, given the raw inertial data available from wearable sensor mounted on the hand and forearm. Subsequently, the 4D kinematics were preprocessed by two dimension reduction techniques: (1) Uniform UMAP: Uniform Manifold Approximation and Projection (UMAP), and (2) Analytical Dimension Reduction (ADR) that was proposed in our paper. The output of the preprocessing stage is the 3D preprocessed kinematics data available in this repository.

- In each CSV file, three columns are available representing the first, second and third output dimensions from either UMAP or ADR. Most engineering software can readily import these files.

## Citing the Dataset

- Preprint Citation: Elnaggar, O., Arelhi, R., Coenen, F., Hopkinson, A., Mason, L. and Paoletti, P., 2023. KIDS: kinematics-based (in) activity detection and segmentation in a sleep case study. arXiv preprint arXiv:2301.03469.

- The citation for the main journal paper will be available as soon as it is accepted an published online.

## License

- The dataset can be used for research purposes only (no commercial uses are allowed). If you are a researcher who used this dataset in research work to be published, please note that you will need to cite the paper of this dataset (refer to ## Citing the Dataset).

## File Structure

- KIDS Data
	- Preprocessed Kinematics
		- UMAP
			- PA 1
				- LW.csv
			- PA 2
				- LW.csv
			- PA 3
				- LW.csv
			- PA 4
				- LW.csv
			- PA 5
				- LW.csv
		- ADR
			- PA 1
				- LW.csv
			- PA 2
				- LW.csv
			- PA 3
				- LW.csv
			- PA 4
				- LW.csv
			- PA 5
				- LW.csv