Should I add FieldTrip with all subdirectories to my MATLAB path?
In general you should not add FieldTrip with all subdirectories to your path. There are a number of external toolboxes (in fieldtrip/external) which are irrelevant for most users, and even can cause some problems if they overlap with other (custom) toolboxes on your path. Furthermore, there are some functions for backward compatibility in fieldtrip/compat, which should only be added to your path in case you use an older MATLAB release.
Please be aware that you should NOT do
because that will add many toolbox directories to your path that you won’t use. Furthermore, it would cause some toolboxes to be on your path twice (such as SPM) and creates problems with builtin MATLAB functions for which FieldTtrip has backward-compatibility replacements.
You should do
where full_path_to_fieldtrip is the location where the FieldTrip directory is located. Inside the Donders Centre for Cognitive Neuroimaging, this would be on Linux
and on Windows
whereas on your personal computer it might be
After adding the FieldTrip main path, you should execute the ft_defaults function (formerly called fieldtripdefs.m), which sets the defaults and configures up the minimal required path settings.
If a subsequent FieldTrip function need an external toolbox that is present in fieldtrip/external, the ft_hastoolbox function will be called by the respective function and the path will be updated on the fly.
Making it persistent
Clean up your path
If you want to ensure that you have a clean version of the FieldTrip toolbox on your MATLAB path, please do
restoredefaultpath addpath /home/common/matlab/fieldtrip ft_defaults
All other dependencies will subsequently be added automatically when needed.
How to deal with toolboxes that FieldTrip uses?
In case FieldTrip function needs additional functions (e.g. for reading a specific data format such as CTF, or for performing a specific computation such as runica), it uses the ft_hastoolbox helper function to determine whether a toolbox is present. If the toolbox is present on your path, it will not add it once more. If the toolbox “xxx” is not yet present, but the directory seems to be present in fieldtrip/external/xxx, then it will add that directory to your path.
The main FieldTrip functions such as ft_preprocessing and ft_freqanalysis all call the ft_defaults function at the beginning. The ft_defaults function ensures that the required subdirectories such as fieldtrip/preproc and fieldtrip/fileio are added. All other toolboxes in fieldtrip/external will only be added upon request, i.e. only when a function from one of those toolboxes is really needed.
You might be worried that this automatic path-checking and path-adding on every function call makes it slow. The ft_hastoolbox function remembers (with a persistent variable) whether a certain toolbox has already been checked, and therefore does not check the same toolbox twice. In case FieldTrip folders are removed, for instance by using rmpath or restoredefaultpath, make sure to reset the persistent variable in the ft_hastoolbox function again by executing “clear ft_hastoolbox”.