Releases: LMBooth/QT-arithmetic_study
Release list
1.0.0
7 Difficulty Levels + Baseline Arithmetic Study — v1.0.0
Publication release accompanying the Scientific Data Data Descriptor "A Combined
Electroencephalogram–Electrocardiogram–Pupillometry Mental Arithmetic Dataset."
This repository contains the experiment presentation code (PyQt5 + Lab Streaming Layer) and the
XDF→BIDS conversion pipeline used to generate and curate the dataset published on OpenNeuro as
ds007262. This is the first stable, citable release and supersedes the pre‑release tags
0.0.1/0.0.2.
Highlights
Relicensed CC0‑1.0 → CC‑BY‑4.0. The code and dataset are now released under Creative Commons
Attribution 4.0, so reuse requires attribution and the work can be formally cited.
Corrected EEG unit scaling. A unit‑handling bug in the XDF→BIDS conversion scaled the EEG
channels by a factor of 10⁶ (microvolt samples were passed to MNE as volts, after which mne‑bids
re‑applied a microvolt conversion on write). EEG channels are now exported in true microvolts;
the ECG/auxiliary channels were never affected.
Added per‑trial response time. Every BIDS *_events.tsv now includes a response_time
column — the answer‑submission latency (outcome‑marker onset minus the preceding response‑window
onset) — documented in task-arithmetic_events.json.
Detailed changes since v0.0.2
conversion_package/scripts/convert_xdf_to_bids_eeg.py: convert EEG rows from microvolts to volts
before constructing the MNE RawArray, so mne‑bids/pybv write physiologically correct microvolts.
Auxiliary (D*) channels are written without unit scaling and are left unchanged.
bids_arithmetic/: EEG recordings re‑scaled to true microvolts; response_time added to all 18
participants' *_events.tsv; task-arithmetic_events.json extended with the response_time
data‑dictionary entry.
LICENSE, CITATION.cff, README.md: relicensed to CC‑BY‑4.0 (citation request retained, now
consistent with the licence).
Associated dataset and paper
Dataset: OpenNeuro ds007262 (v1.0.7) — raw XDF recordings plus BIDS‑conformant EEG, ECG and
pupillometry exports for 18 released participants performing a 7‑level (plus baseline) mental
arithmetic task with synchronised multimodal physiology.
Data Descriptor: A Combined Electroencephalogram–Electrocardiogram–Pupillometry Mental
Arithmetic Dataset, Scientific Data (under review).
Reproducibility
Run the experiment from Arithmetic_Difficulty/ (uses the bundled GeneratedQuestions item set),
record the LSL streams with Lab Recorder, then rebuild the BIDS dataset with the scripts in
conversion_package/ (see conversion_package/README.md). Requires Python 3.11+.
License
Creative Commons Attribution 4.0 International (CC‑BY‑4.0). See LICENSE.
Citation
If you use this software or dataset, please cite it — see CITATION.cff for machine‑readable
metadata, and cite the OpenNeuro dataset (ds007262) and the associated Data Descriptor.
License update to CC BY 4.0 (was CC0)
Changed license file attempting to update zenodo license downstream