Process Faces dataset (#236)

* Process Faces dataset

Closes #41

Remaining / highlightes issues:

- Original dataset doesn't store fine-calibration and crosstalk files
   according to BIDS, so not doing Maxwell filtering for now

- I'd like to calculate the contrast of "face" vs "scrambled", however,
   to do that, I'd need to merge the "familiar" and "unfamiliar" events
   to "faces". We need to add support for operations like this.

Tests will fail until mne-tools/mne-bids#680
has been merged.

* Remove cruft

.circleci/config.yml

@@ -173,6 +173,15 @@ jobs:
                cp ~/mne_data/${DS}/derivatives/mne-study-template/*/**/*.html ~/reports/${DS}/
                rm -rf ~/mne_data/${DS}/derivatives/mne-study-template/
 
+        - run:
+            name: test ds000117
+            command: |
+               export DS=ds000117
+               python tests/run_tests.py ${DS}
+               mkdir ~/reports/${DS}
+               cp ~/mne_data/${DS}/derivatives/mne-study-template/*/**/*.html ~/reports/${DS}/
+               rm -rf ~/mne_data/${DS}/derivatives/mne-study-template/
+
         - store_artifacts:
             path: /home/circleci/reports
             destination: reports

docs/mkdocs.yml

@@ -66,6 +66,7 @@ nav:
         - examples/ds003104.md
         - examples/eeg_matchingpennies.md
         - examples/ds001810.md
+        - examples/ds000117.md
 
 plugins:
     - search

tests/configs/config_ds000117.py

@@ -1,16 +1,6 @@
-"""Configuration file for the ds000117 dataset.
-
-Set the `MNE_BIDS_STUDY_CONFIG` environment variable to
-"config_ds000117" to overwrite `config.py` with the values specified
-below.
-
-Download ds000117 from OpenNeuro: https://github.com/OpenNeuroDatasets/ds000117
-
-export MNE_BIDS_STUDY_CONFIG=config_ds000117
-export BIDS_ROOT=~/mne_data/ds000117
-
 """
-import os.path as op
+Faces dataset
+"""
 
 study_name = 'ds000117'
 bids_root = '~/mne_data/ds000117'
@@ -20,15 +10,16 @@
 sessions = ['meg']
 interactive = False
 acq = None
-bids_root = op.join(op.expanduser('~'), 'data', 'ds000117')
-subjects_dir = op.join(bids_root, 'derivatives', 'freesurfer', 'subjects')
 subjects = ['01']
 
-use_maxwell_filter = True
+# use_maxwell_filter = True
+# subjects_dir = op.join(bids_root, 'derivatives', 'freesurfer', 'subjects')
 
 reject = {'grad': 4000e-13, 'mag': 4e-12}
-conditions = ['face', 'scrambled']
-contrasts = [('face', 'scrambled')]
+conditions = ['Famous', 'Unfamiliar', 'Scrambled']
+contrasts = [('Famous', 'Scrambled'),
+             ('Unfamiliar', 'Scrambled'),
+             ('Famous', 'Unfamiliar')]
 decode = True
 use_ssp = False
 use_ica = False

tests/run_tests.py

@@ -36,7 +36,8 @@ def fetch(dataset=None):
     'eeg_matchingpennies': ('config_eeg_matchingpennies', 'preprocessing',
                             'sensor', 'report'),
     'ds003104': ('config_ds003104', 'preprocessing', 'sensor',  'source',
-                 'report')
+                 'report'),
+    'ds000117': ('config_ds000117', 'preprocessing', 'sensor', 'report')
 }