MNE-BIDS¶
This is a repository for creating BIDS-compatible datasets with MNE-Python.
BIDS (Brain Imaging Data Structure) is a standard to organize data according to a set of rules that describe:
how to name your files
where to place your files within a directory structure
what additional metadata to store, and how to store it in sidecar json and tsv files
The complete set of rules is written down in the BIDS specification. A BIDS-compatible dataset conforms to these rules and passes the BIDS-validator.
MNE-Python is a software package for analyzing neurophysiology data.
MNE-BIDS links BIDS and MNE with the goal to make your analyses faster to code, more robust to errors, and easily shareable with colleagues.
Documentation¶
The documentation can be found under the following links:
for the stable release
for the latest (development) version
Dependencies¶
numpy (>=1.14)
scipy (>=0.18.1)
mne (>=0.19.1)
nibabel (>=2.2, optional)
pybv (optional)
Installation¶
We recommend the Anaconda Python
distribution. We require that you use Python 3.5 or higher.
You may choose to install mne-bids
via pip or
via conda.
Installation via pip¶
Besides numpy and scipy (which are included in the standard Anaconda
installation), you will need to install the most recent version of MNE
using the pip tool:
$ pip install -U mne
Then install mne-bids:
$ pip install -U mne-bids
These pip commands also work if you want to upgrade if a newer version of
mne-bids is available. If you do not have administrator privileges on the
computer, use the --user flag with pip.
To check if everything worked fine, the following command should not give any error messages:
$ python -c 'import mne_bids'
For full functionality of mne-bids, you will also need to pip install
the following packages:
nibabel, for interacting with MRI datapybv, to convert EEG data to BrainVision if input format is not valid according to EEG BIDS specifications
If you want to use the latest development version of mne-bids, use the
following command:
$ pip install https://api.github.com/repos/mne-tools/mne-bids/zipball/master
Installation via conda¶
If you have followed the
MNE-Python installation instructions,
all that’s left to do is to install mne-bids without its dependencies, as
they’ve already been installed during the MNE installation process.
Activate the correct conda environment and install mne-bids:
$ conda activate mne
$ conda install --channel conda-forge --no-deps mne-bids
This approach ensures that the installation of mne-bids doesn’t alter any
other packages in your existing conda environment.
Alternatively, you may wish to take advantage of the fact that the
mne-bids package on conda-forge in fact depends on mne,
meaning that a “full” installation of mne-bids (i.e., including its
dependencies) will provide you with a working copy of of both mne and
mne-bids at once:
$ conda create --name mne --channel conda-forge mne-bids
After activating the environment, you should be ready to use mne-bids:
$ conda activate mne
$ python -c 'import mne_bids'
Quickstart¶
Currently, we support writing of BIDS datasets for MEG and EEG. Support for iEEG is experimental at the moment.
>>> from mne import io
>>> from mne_bids import write_raw_bids
>>> raw = io.read_raw_fif('my_old_file.fif')
>>> write_raw_bids(raw, 'sub-01_ses-01_run-05', bids_root='./bids_dataset')
Command Line Interface¶
In addition to import mne_bids, you can use the command line interface.
Simply type mne_bids in your command line and press enter, to see the
accepted commands. Then type mne_bids <command> --help, where <command>
is one of the accepted commands, to get more information about that
<command>.
Example:
$ mne_bids raw_to_bids --subject_id sub01 --task rest --raw data.edf --bids_root new_path
Bug reports¶
Use the GitHub issue tracker to report bugs.
Contributing¶
Please see our contributing guide.
Cite¶
If you use mne-bids in your work, please cite:
Appelhoff, S., Sanderson, M., Brooks, T., Vliet, M., Quentin, R., Holdgraf, C.,
Chaumon, M., Mikulan, E., Tavabi, K., Höchenberger, R., Welke, D., Brunner, C.,
Rockhill, A., Larson, E., Gramfort, A. and Jas, M. (2019). MNE-BIDS: Organizing
electrophysiological data into the BIDS format and facilitating their analysis.
Journal of Open Source Software 4: (1896).
and one of the following papers, depending on which modality you used:
MEG¶
Niso, G., Gorgolewski, K. J., Bock, E., Brooks, T. L., Flandin, G., Gramfort, A.,
Henson, R. N., Jas, M., Litvak, V., Moreau, J., Oostenveld, R., Schoffelen, J.,
Tadel, F., Wexler, J., Baillet, S. (2018). MEG-BIDS, the brain imaging data
structure extended to magnetoencephalography. Scientific Data, 5, 180110.
http://doi.org/10.1038/sdata.2018.110