Add c-VEP paradigm and first dataset

docs/source/dataset_summary.rst

@@ -83,6 +83,26 @@ SSVEP
    :class:`Wang2016`,34,62,40,6,5s,250Hz,1
 
 
+c-VEP
+======================
+
+Include neuro experiments where the participant is presented with psuedo-random noise-codes,
+such as m-sequences, Gold codes, or any arbitrary "pseudo-random" code. Specifically, the
+difference with SSVEP is that SSVEP presents periodic stimuli, while c-VEP presents
+non-periodic stimuli. For a review of c-VEP BCI, see:
+
+Martínez-Cagigal, V., Thielen, J., Santamaria-Vazquez, E., Pérez-Velasco, S., Desain, P.,&
+Hornero, R. (2021). Brain–computer interfaces based on code-modulated visual evoked
+potentials (c-VEP): A literature review. Journal of Neural Engineering, 18(6), 061002.
+DOI: https://doi.org/10.1088/1741-2552/ac38cf
+
+.. csv-table::
+   :header: Dataset, #Subj, #Chan, #Classes, #Trials / class, Trials length, #Epochs / class, Sampling rate, #Sessions, Codes, Presentation rate
+   :class: sortable
+
+   :class:`Thielen2021`,30,8,20,5,31.5s,18900 NT / 18900 T,512Hz,1,Gold codes,60Hz
+
+
 Resting States
 ======================
 

docs/source/datasets.rst

@@ -75,6 +75,17 @@ SSVEP Datasets
     Lee2019_SSVEP
 
 
+--------------
+c-VEP Datasets
+--------------
+
+.. autosummary::
+    :toctree: generated/
+    :template: class.rst
+
+    Thielen2021
+
+
 ----------------------
 Resting State Datasets
 ----------------------

docs/source/paradigms.rst

@@ -42,6 +42,19 @@ SSVEP Paradigms
     SSVEP
     FilterBankSSVEP
 
+
+---------------
+c-VEP Paradigms
+---------------
+
+.. autosummary::
+    :toctree: generated/
+    :template: class.rst
+
+    CVEP
+    FilterBankCVEP
+
+
 --------------
 Fixed Interval Windows Processings
 --------------

docs/source/whats_new.rst

@@ -44,6 +44,7 @@ Enhancements
 - Rename many dataset class names to standardize and deprecate old names (:gh:`455` by `Pierre Guetschel`_)
 - Change many dataset codes to match the class names (:gh:`455` by `Pierre Guetschel`_)
 - Add :obj:`moabb.datasets.compound_dataset.utils.compound_dataset_list`  (:gh:`455` by `Pierre Guetschel`_)
+- Add c-VEP paradigm and Thielen2021 c-VEP dataset (:gh:`463` by `Jordy Thielen`_)
 
 Bugs
 ~~~~
@@ -376,3 +377,4 @@ API changes
 .. _Pierre Guetschel: https://github.com/PierreGtch
 .. _Ludovic Darmet: https://github.com/ludovicdmt
 .. _Thomas Moreau: https://github.com/tommoral
+.. _Jordy Thielen: https://github.com/thijor

moabb/datasets/__init__.py

@@ -65,6 +65,7 @@
 from .ssvep_mamem import MAMEM1, MAMEM2, MAMEM3
 from .ssvep_nakanishi import Nakanishi2015
 from .ssvep_wang import Wang2016
+from .thielen2021 import Thielen2021
 from .upper_limb import Ofner2017
 from .utils import _init_dataset_list
 from .Weibo2014 import Weibo2014

moabb/datasets/fake.py

@@ -1,3 +1,4 @@
+import re
 import tempfile
 from pathlib import Path
 
@@ -49,7 +50,7 @@ def __init__(
         self.channels = channels
         code = (
             f"{code}-{paradigm.lower()}-{n_subjects}-{n_sessions}-{n_runs}-"
-            f"{''.join([e.replace('_', '').lower() for e in event_list])}-"
+            f"{''.join([re.sub('[^A-Za-z0-9]', '', e).lower() for e in event_list])}-"
             f"{''.join([c.lower() for c in channels])}"
         )
         super().__init__(