Welcome to the FieldTrip website

FieldTrip is the MATLAB software toolbox for MEG, EEG, iEEG and NIRS analysis, which is released free of charge as open source software under the GNU general public license.

Please cite the FieldTrip reference paper when you have used FieldTrip in your study.

Robert Oostenveld, Pascal Fries, Eric Maris, and Jan-Mathijs Schoffelen. FieldTrip: Open Source Software for Advanced Analysis of MEG, EEG, and Invasive Electrophysiological Data. Computational Intelligence and Neuroscience, vol. 2011, Article ID 156869, 9 pages, 2011. doi:10.1155/2011/156869.

To get started, head over to the getting started documentation and the tutorials.

Latest release

The latest code developments can be tracked in detail on GitHub.

19 September, 2020

FieldTrip version 20200919 has been released. Besides some bug fixes, this includes updates to the BIDS data handling, the reading functions will now by default read the channels.tsv and events.tsv files when present. See GitHub for the detailed list of updates.

News and announcements

You can also follow us on Twitter.

17 September, 2020

We are changing our communication strategy, which is an integral part of our work! We will continue to use this website for news items and updates on releases, but we will also use Twitter more systematically and to the point. Instead of sending a tweet upon every commit (which made sense in the pre-GitHub days but not any more), we will start sending less frequent but more interesting tweets with important releases, announcements of new features, documentation updates, training events, and other interesting information! So to follow the important news, please keep checking here or follow us on Twitter.

01 July, 2020

In FieldTrip release 20200701 the low-level functions in fieldtrip/inverse have been renamed to ft_inverse_xxx and their input and output arguments have been cleaned up. This addresses a long-standing plan for improving the inverse modeling API. Except for the renaming of the low-level functions (which you won’t notice if you call them through the high-level ft_sourceanalysis and ft_dipolefitting) there are no functional changes.

24 June, 2020

We are sorry to report that with merging the recent pull request #1377 about a month ago, we introduced a bug in the FieldTrip release that might have affected your computations.

Specifically, the handling of the defaults for cfg.reducerank and the cfg.backproject changed a bit, which had an unforeseen sideeffect in ft_prepare_leadfield, if (and only if) you used this function for the computation of MEG-based leadfields, using the singleshell method. Specifically, ft_prepare_leadfield would by default compute MEG singleshell leadfields with reducerank=2 (this is how it always has been), but it would wrongly backproject (i.e. the intended projection of the rank-reduced 2-column leadfield back into 3D space with a column for the x, y, and z dipole moment in Cartesian space) the rank-reduced leadfield. Rather, ft_prepare_leadfield would on line 292 discard the last column. The error was due to MATLAB interpreting if [] as false, causing on line 295 only the first two columns to be copied to the output. Consequently, the leadfield for the z-direction was discarded.

Are you affected? If you used the master branch from GitHub (which is the development version), or a release version between 20200529 and 20200607, and if you have used ft_prepare_leadfield for MEG with singleshell models, then you are likely affected. You can check yourself: your precomputed leadfields should have three columns; if they only have two columns and you did not explicityly specify reducerank and backproject in your configuration, your leadfields are wrong. Other models than MEG singleshell are not affected.

To resolve the problem, please update to the latest 20200623 release version from the FTP server or from the GitHub release page and recompute your leadfields, source estimates, etcetera.

11 June, 2020

Robert and Jan-Mathijs have made an improvement to how color schemes can be specified. In functions supporting cfg.colormap, you can now also specify a subset of the color schemes that are in matplotlib, as well as the brewermap color schemes (e.g. ‘RdBu’). See ft_colormap for more information.

In this movie you can see Robert and Jan-Mathijs working on this. And finally, as a bonus, we have added an ‘ftcolors’ colormap, which will give your artwork this extra FieldTrippy feel. Happy plotting!

28 May, 2020

We have changed the links to the reference documentation (i.e. the help that is at the start of each FieldTrip function) here on the website such that they now point to the code on GitHub, rather than to a Markdown copy of the fucntion help on the website. This makes it possible to scroll down past the help, and to look at the code and the details of the implementation. Also, it makes it easier for you to contribute your suggestions to the help or to the code itself: You can simply click on the “pencil” symbol in the upper right corner.

If you want to know more about contributing, please see here. We also have a detailed git and GitHub tutorial that explains it in much more detail.

07 May, 2020

During the recent toolkit, which took place online, the participants worked on their own computers, causing a larger than usual variability on MATLAB versions and Operating Systems. One issue we encountered was a compatibility problem with SPM-related mex-files. Specfically, when using the default version, which up until now has been spm8, certain functions did not work. We are typically reluctant to change default behavior of functions, but now we decided to upgrade the default SPM version to spm12, for a more stable user experience overall. We expect this change to be inconsequential for most of you, but would like to note that, when needed, you can always go back to using spm8, by specifying cfg.spmversion=’spm8’, wherever appropriate. Note that cfg.spmversion is only a supported option for the high-level fieldtrip functions.

29 April, 2020

Last week we hosted the MEG/EEG toolkit course online. Due to the COVID-19 pandemic we had to transform it in an online format in which almost everyone (participants and tutors) were attending from home. The format consisted of lectures, extended Q&A sessions, and hands-on sessions where participants worked on tutorials on their own computer. Besides doing it online, this posed additional challenges, with kids at home requiring attention, with time-zone differences, and with some participants now also having clinical duties. This required a lot of creativity of everyone involved, resulting in interesting opportunities. In short: it was a great success, with very good interaction between the about 35 participants and the tutors.

We have documented the work that went into the preparations, the instruction “manual” that we wrote for the participants and tutors, and also some of the lessons we learned along the way. Furthermore, where possible we recorded the online Zoom lectures and Q&A sessions, allowing others to learn from them as well. Please see the 2020 toolkit page for all details.