akuffoetal_dataset_2025

Personal light exposure dataset for Kumasi, Ghana, following the Guidolin et al. 2024 protocol (MeLiDos project)

https://github.com/melidosproject/akuffoetal_dataset_2025

Repository

Personal light exposure dataset for Kumasi, Ghana, following the Guidolin et al. 2024 protocol (MeLiDos project)

README.Rmd

---
output: github_document
---



```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>"
)
```

   
   



### Personal light exposure dataset for Kumasi, Ghana; collected by Kwame Nkrumah University of Science and Technology (KNUST) following the protocol of Guidolin et al. 2024 (MeLiDos field study)

**Version v1.0.1**


[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.15576731.svg)](https://doi.org/10.5281/zenodo.15576731)


![Overview of light exposure data. (A) location of data collection. (B) collection periods for participants, (C) photoperiods, and (D) double plot of median, interquartile range (50%), 75%, and 95% ribbons of light exposure across all participants. Shaded areas indicate nighttime from civil dusk to civil dawn.](output/figures/Figure_1.png)

### About this repository

This repository contains the comprehensive dataset for the [MeLiDos](www.melidos.eu) field study site of Kumasi, Ghana. Data were collected by [Kwame Nkrumah University of Science and Technology (KNUST)](https://www.knust.edu.gh) and are further processed and analysed by the [Translational Sensory & Circadian Neuroscience Unit (TSCN)](https://www.tscnlab.org). A detailed description of the experiment is available in [Guidolin et al., 2024](https://www.ncbi.nlm.nih.gov/pubmed/39592960).

This repository is transitioning towards a [FAIR](https://www.go-fair.org/fair-principles/) and fully human and machine-readable light exposure dataset, based on a [community-based and peer-reviewed Metadata descriptor](https://bmcdigitalhealth.biomedcentral.com/articles/10.1186/s44247-024-00113-9). As part of this transition, files will be converted from semi-rectangular data, to fully [tabular data](https://specs.frictionlessdata.io/tabular-data-package/). Further, metadata will be added and converted from XLSX to JSON. For full traceability, all versions will be archived in [Zenodo](https://zenodo.org) and are accessible through their own persistent identifier (DOI).

### Citation

APA reference:

> Akuffo, K. O., Agbeshie, G. K., Zauner, J., & Spitschan, M. (2025). Personal light exposure dataset for Kumasi, Ghana (Version 1.0.1) [Data set]. URL: https://github.com/MeLiDosProject/AkuffoEtAl_Dataset_2025. DOI: doi.org/10.5281/zenodo.15576731

## Summary of the dataset
| Dataset name | KNUST |
| --- | --- |
| Period of data collection (total) | October 2024 to February 2025 |
| Location | Kumasi, Ghana |
| Number of participants enrolled  | N=15 |
| Number of participants included in data analysis and this repository | N=15 |
| Duration of experiment for each participant | N=7 days (Monday to Monday) |

### Included files

The following files are included with this Dataset:

- `data/Metadata_MeLiDos_KNUST.xlsx`: Preliminary Metadata prior to conversion to JSON

- `data/Study_dates_MeLiDos_KNUST.xlsx`: Recruitment dates to clean light exposure recordings

- `data`: Folder with measurement and project data in the following structure:
```         
    data/
        raw/
            group/
               chronotype/
               demographics/
               discharge/
               screening/
            individual/
               $ParticipantID/
                     chronotype/
                     continuous/
                         actlumus_wrist
                         actlumus_head
                         actlumus_chest
                         currentconditions/
                         exercisediary/
                         experiencelog/
                         mHLEA_digital/
                         mHLEA_paper/
                         sleepdiary/
                         wearlog/
                         wellbeingdiary/
                     demographics/
                     discharge/
                     screening/
    metadata/
```

- `LICENSE`: Licensing terms. This dataset is published with a
  permissive CC-BY-4.0 license

All data are anonymous.

# Folder structure
## Group

This folder contains grouped data, i.e. any data that are collected at the group level and/or were grouped to facilitate import during analyses.

| Folder name | Content |
| --- | --- |
| **chronotype** | N=2 csv files, one for the Morning Eveningness Questionnaire (MEQ) and one for the Munich Chronotype Questionnaire (MCTQ). Each contains data for N=15 participants. A lookup table each links record_id with participant ID.  |
| **demographics** | N=1 csv files. Contains demographic information for N=15 participants. A lookup table links record_id with participant ID. |
| **discharge** | N=1 csv file, which contains answers from al. questionnaires that N=15 participants had to fill at discharge: 1) Light Exposure Behaviour Assessment (LEBA instrument), 2) Visual Light Sensitivity Questionnaire-8 (VLSQ-8), 3) Assessment of Sleep Environment (ASE) questionnaire, 4) Modified Theory Framework of Acceptability (mTFA) questionnaire, 5) Feedback (1 Y/N and multiple choice questions). A lookup table links record_id with participant ID. |
| **screening** | N=1 csv file for N=15 participants containing screening information. A lookup table links record_id with participant ID. |

## Individual
This folder contains individual-level data for N=15 participant, each stored in a separate folder named after the participant ID (PID). The data within each participant folder follows the following structure. 

| Folder name | Content |
| --- | -- |
| **continuous/actlumus_chest** | txt files from ActLumus worn at chest level, one for each participant. Also, a report (`_Report`) from the device. |
| **continuous/actlumus_head** | txt files from ActLumus worn at eye level, one for each participant. Also, a report (`_Report`) from the device. |
| **continuous/actlumus_wrist** | txt files from ActLumus worn at the wrist, one for each participant. Also, a report (`_Report`) from the device. |
| **continuous/currenconditions/** | Questionnaire comprising 3 questionnaires on 1) current mood (MoodZoom), 2) light conditions (custom) and 3) alertness (Karolinska Sleepiness Scale). Completed 4/times per day, at 11:00, 14:00, 17:00 and 20:00. Participants instructed to completed as close as possible to the indicated times.  |
| **continuous/exercisediary/** | Custom made questionnaire on exercise. Completed daily in the evening |
| **continuous/experiencelog/** | Custom made questionnaire about experiences wearing the light glasses. Completed any time participant had an experience to report (n**o restrictions). |
| **continuous/mHLEA_digital/** | Custom made questionnaire to test Daily in the evening |  |
| **continuous/mHLEA_paper/** | N/A. This was transcribed by the experimenter after study end for each participant.  |
| **continuous/sleepdiary/** | Daily in the morning  | 
| **continuous/wearlog/** | Any time participant had removed or started wearing the light logger |
| **continuous/wellbeingdiary/** | Daily in the evening |
| **chronotype/** | Munich Chronotype Questionnaire (MCTQ) & Morning Eveningness Questionnaire (MEQ) completed at study intake (Monday, day 1) |
| **demographics/** | Screening questionnaire containing demographic and health information. Completed online before study intake.  |
| **discharge/** | n=5 csv files with LEBA, VLSQ8, feedback, mTFA, and ASE. Completed at discharge (Monday, day 8).  | 

Owner

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: 'Personal light exposure dataset for Kumasi, Ghana'
message: >-
  If you use this dataset, please cite it using the metadata
  from this file.
type: dataset
authors:
  - given-names: Kwadwo Owusu
    family-names: Akuffo
    email: akuffokwadwoowusu@knust.edu.gh
    affiliation: >-
      Kwame Nkrumah University of Science and Technology
      (KNUST)
    orcid: 'https://orcid.org/0000-0001-6683-249X'
  - given-names: Gabriel Kwaku
    family-names: Agbeshie
    email: agbeshiekwakugabriel@gmail.com
    affiliation: >-
      Kwame Nkrumah University of Science and Technology
      (KNUST)
    orcid: 'https://orcid.org/0009-0009-6135-7111'
  - given-names: Johannes
    family-names: Zauner
    email: johannes.zauner@tum.de
    affiliation: >-
      Technical University of Munich; Max Planck Institute
      for Biological Cybernetics
    orcid: 'https://orcid.org/0000-0003-2171-4566'
  - given-names: Manuel
    family-names: Spitschan
    email: manuel.spitschan@tum.de
    affiliation: >-
      Technical University of Munich; Max Planck Institute
      for Biological Cybernetics; TUM Institute for Advanced
      Study (TUM-IAS)
    orcid: 'https://orcid.org/0000-0002-8572-9268'
identifiers:
  - type: doi
    value: 10.5281/zenodo.15576732
    description: Zenodo archive (V1.0.0)
  - type: doi
    value: 10.5281/zenodo.15576731
    description: Zenodo Archive (latest version)
repository-code: 'https://github.com/MeLiDosProject/AkuffoEtAl_Dataset_2025'
url: 'https://www.melidos.eu'
abstract: >-
  This repository contains the comprehensive dataset for the
  MeLiDos field study site of Kumasi, Ghana. Data were
  collected by Kwame Nkrumah University of Science and
  Technology (KNUST) and are further processed and analysed
  by the Translational Sensory & Circadian Neuroscience Unit
  (TSCN). A detailed description of the experiment is
  available in Guidolin et al., 2024.
keywords:
  - light exposure
  - wearable
  - healthy light
  - circadian
  - melanopic
  - naturalistic setting
license: CC-BY-4.0
commit: 321ea1806d9f266ecd8e87305be857861f7e4180
version: 1.0.0
date-released: '2025-06-02'

GitHub Events