BIDS-iEEG Compatibility

By default, iELVis uses/builds on FreeSurfer's system for organizing files. However, it is also possible for iELVis to read and write files in accordance with the nascent BIDS-iEEG conventions. BIDS-iEEG is a set of conventions for data storage that facilitates robust and reproducible research as well as data and code sharing. The format may still evolve a bit (the initial standard was submitted for publication in mid-December 2018) but here is an example of a study organized according to the current draft of the BIDS-iEEG format:


and here is a preprint of the paper introducing BIDS-iEEG and describing its format:


Exporting FreeSurfer Organized iELVis Files into BIDS-iEEG Format:

To copy iELVis electrode information and associate neuroimaging files into BIDS-iEEG format, simply run iELVisFsurf2BIDS.m, by doing something like this:

>> iELVisFsurf2BIDS('PT001','~/Desktop/HandMotor',1);


Where 'PT001' is the patient's FreeSurfer ID, '~/Desktop/HandMotor', is the BIDS root directory that will be created (if it doesn't already exist) and 1 is the session in which the corresponding iEEG data have been recorded. This will create a sub-PT001 folder than contains electrode locations and information and well as the original raw pre- and post-implant brain volumes used for electrode localization.


The other directories created are subfolders of HandMotor/derivatives/iELVis which contain processed anatomical files (e.g., pial surfaces) used for electrode localization and visualization.



Creating iELVis Files from Scratch in BIDS-iEEG Format:

To create iELVis files in BIDS-iEEG format as well as the FreeSurfer-based format, simply call yangWangElecPjct.m or dykstraElecPjct.m with the optional arguments that specify the BIDS-iEEG root directory and session id. For example:







Reading Data in BIDS-iEEG Format:

You can use the following iELVis functions to visualize/process BIDS-iEEG data:




For example, this is how you can visualize electrode locations on the cortical surface:

>>cfg.title='PT001: BIDS-iEEG';


And this is how you can visualize depth electrode locations in sets of three 2D slices