The tedana pipeline

tedana works by decomposing multi-echo BOLD data via principal component analysis (PCA) and independent component analysis (ICA). The resulting components are then analyzed to determine whether they are TE-dependent or -independent. TE-dependent components are classified as BOLD, while TE-independent components are classified as non-BOLD, and are discarded as part of data cleaning.

In tedana, we take the time series from all the collected TEs, combine them, and decompose the resulting data into components that can be classified as BOLD or non-BOLD. This is performed in a series of steps, including:

  • Principal component analysis
  • Independent component analysis
  • Component classification

Multi-echo data

Here are the echo-specific time series for a single voxel in an example resting-state scan with 8 echoes.


The values across volumes for this voxel scale with echo time in a predictable manner.


Adaptive mask generation

Longer echo times are more susceptible to signal dropout, which means that certain brain regions (e.g., orbitofrontal cortex, temporal poles) will only have good signal for some echoes. In order to avoid using bad signal from affected echoes in calculating T_{2}^* and S_{0} for a given voxel, tedana generates an adaptive mask, where the value for each voxel is the number of echoes with “good” signal. When T_{2}^* and S_{0} are calculated below, each voxel’s values are only calculated from the first n echoes, where n is the value for that voxel in the adaptive mask.

Adaptive mask code


tedana allows users to provide their own mask. The adaptive mask will be computed on this explicit mask, and may reduce it further based on the data. If a mask is not provided, tedana runs nilearn.masking.compute_epi_mask on the first echo’s data to derive a mask prior to adaptive masking. The workflow does this because the adaptive mask generation function sometimes identifies almost the entire bounding box as “brain”, and compute_epi_mask restricts analysis to a more reasonable area.


Monoexponential decay model fit

The next step is to fit a monoexponential decay model to the data in order to estimate voxel-wise T_{2}^* and S_0. S_0 corresponds to the total signal in each voxel before decay and can reflect coil sensivity. T_{2}^* corresponds to the rate at which a voxel decays over time, which is related to signal dropout and BOLD sensitivity. Estimates of the parameters are saved as t2sv.nii.gz and s0v.nii.gz.

While T_{2}^* and S_0 in fact fluctuate over time, estimating them on a volume-by-volume basis with only a small number of echoes is not feasible (i.e., the estimates would be extremely noisy). As such, we estimate average T_{2}^* and S_0 maps and use those throughout the workflow.

In order to make it easier to fit the decay model to the data, tedana transforms the data by default. The BOLD data are transformed as log(|S|+1), where S is the BOLD signal. The echo times are also multiplied by -1.

Decay model fit code


It is now possible to do a nonlinear monoexponential fit to the original, untransformed data values by specifiying --fittype curvefit. This method is slightly more computationally demanding but may obtain more accurate fits.


A simple line can then be fit to the transformed data with linear regression. For the sake of this introduction, we can assume that the example voxel has good signal in all eight echoes (i.e., the adaptive mask has a value of 8 at this voxel), so the line is fit to all available data.


tedana actually performs and uses two sets of T_{2}^*/S_0 model fits. In one case, tedana estimates T_{2}^* and S_0 for voxels with good signal in at least two echoes. The resulting “limited” T_{2}^* and S_0 maps are used throughout most of the pipeline. In the other case, tedana estimates T_{2}^* and S_0 for voxels with good data in only one echo as well, but uses the first two echoes for those voxels. The resulting “full” T_{2}^* and S_0 maps are used to generate the optimally combined data.


The values of interest for the decay model, S_0 and T_{2}^*, are then simple transformations of the line’s intercept (B_{0}) and slope (B_{1}), respectively:

S_{0} = e^{B_{0}}

T_{2}^{*} = \frac{1}{B_{1}}

The resulting values can be used to show the fitted monoexponential decay model on the original data.


We can also see where T_{2}^* lands on this curve.


Optimal combination

Using the T_{2}^* estimates, tedana combines signal across echoes using a weighted average. The echoes are weighted according to the formula

w_{TE} = TE * e^{\frac{-TE}{T_{2}^*}}

The weights are then normalized across echoes. For the example voxel, the resulting weights are:


These normalized weights are then used to compute a weighted average that takes advantage of the higher signal in earlier echoes and the higher sensitivity at later echoes. The distribution of values for the optimally combined data lands somewhere between the distributions for other echoes.


The time series for the optimally combined data also looks like a combination of the other echoes (which it is). This optimally combined data is written out as ts_OC.nii.gz

Optimal combination code



An alternative method for optimal combination that does not use T_{2}^*, is the parallel-acquired inhomogeneity desensitized (PAID) ME-fMRI combination method (Poser et al., 2006). This method specifically assumes that noise in the acquired echoes is “isotopic and homogeneous throughout the image,” meaning it should be used on smoothed data. As we do not recommend performing tedana denoising on smoothed data, we discourage using PAID within the tedana workflow. We do, however, make it accessible as an alternative combination method in the t2smap workflow.


The next step is an attempt to remove noise from the data. This process can be broadly separated into three steps: decomposition, metric calculation and component selection. Decomposition reduces the dimensionality of the optimally combined data using principal component analysis (PCA) and then an independent component analysis (ICA). Metrics which highlights the TE-dependence or independence are derived from these components. Component selection uses these metrics in order to identify components that should be kept in the data or discarded. Unwanted components are then removed from the optimally combined data to produce the denoised data output.


The next step is to dimensionally reduce the data with TE-dependent principal component analysis (PCA). The goal of this step is to make it easier for the later ICA decomposition to converge. Dimensionality reduction is a common step prior to ICA. TEDPCA applies PCA to the optimally combined data in order to decompose it into component maps and time series (saved as mepca_mix.1D). Here we can see time series for some example components (we don’t really care about the maps):


These components are subjected to component selection, the specifics of which vary according to algorithm. Specifically, tedana offers two different approaches that perform this step.

The simplest approach (the default mdl, aic and kic options for –tedpca) is based on a Moving Average (stationary Gaussian) process proposed by Li et al (2007). A moving average process is the output of a linear system (which in this case is a smoothing filter) that has an independent and identically distributed Gaussian process as the input. If we assume that the linear system is shift invariant, the moving average process is a stationary Gaussian random process. Simply put, this process more optimally selects the number of components for fMRI data following a subsampling scheme described in Li et al (2007). The selection of components is performed with either of the three options provided by –tedpca:

  • aic: the Akaike Information Criterion, which is the least aggressive option; i.e., returns the largest number of components.
  • kic: the Kullback-Leibler Information Criterion, which stands in the middle in terms of aggressiveness.
  • mdl: the Minimum Description Length, which is the most aggressive (and recommended) option.

A more complicated approach involves applying a decision tree (similar to the decision tree described in the TEDICA section below) to identify and discard PCA components which, in addition to not explaining much variance, are also not significantly TE-dependent (i.e., have low Kappa) or TE-independent (i.e., have low Rho). These approaches can be accessed using either the kundu or kundu_stabilize options for the –tedpca flag. For a more thorough explanation of this approach, consider the supplemental information in Kundu et al (2013)

After component selection is performed, the retained components and their associated betas are used to reconstruct the optimally combined data, resulting in a dimensionally reduced version of the dataset which is then used in the TEDICA step.




Next, tedana applies TE-dependent independent component analysis (ICA) in order to identify and remove TE-independent (i.e., non-BOLD noise) components. The dimensionally reduced optimally combined data are first subjected to ICA in order to fit a mixing matrix to the whitened data. This generates a number of independent timeseries (saved as meica_mix.1D), as well as beta maps which show the spatial loading of these components on the brain (betas_OC.nii.gz).


Linear regression is used to fit the component time series to each voxel in each of the original, echo-specific data. This results in echo- and voxel-specific betas for each of the components. The beta values from the linear regression can be used to determine how the fluctuations (in each component timeseries) change across the echo times.

TE-dependence (R_2 or 1/T_{2}^*) and TE-independence (S_0) models can then be fit to these betas. For more information on how these models are estimated, see TE (In)Dependence Models. These models allow calculation of F-statistics for the R_2 and S_0 models (referred to as \kappa and \rho, respectively).

The grey lines show how beta values (Parameter Estimates) change over time. Refer the the physics section {\Delta}{S_0} for more information about the S_0 and T_2^* models.

_images/a14_te_dependence_models_component_0.png _images/a14_te_dependence_models_component_1.png _images/a14_te_dependence_models_component_2.png

A decision tree is applied to \kappa, \rho, and other metrics in order to classify ICA components as TE-dependent (BOLD signal), TE-independent (non-BOLD noise), or neither (to be ignored). These classifications are saved in comp_table_ica.txt. The actual decision tree is dependent on the component selection algorithm employed. tedana includes the option kundu (which uses hardcoded thresholds applied to each of the metrics).

Components that are classified as noise are projected out of the optimally combined data, yielding a denoised timeseries, which is saved as dn_ts_OC.nii.gz.



Removal of spatially diffuse noise (optional)

Due to the constraints of ICA, TEDICA is able to identify and remove spatially localized noise components, but it cannot identify components that are spread out throughout the whole brain. See Power et al. (2018) for more information about this issue. One of several post-processing strategies may be applied to the ME-DN or ME-HK datasets in order to remove spatially diffuse (ostensibly respiration-related) noise. Methods which have been employed in the past include global signal regression (GSR), T1c-GSR, anatomical CompCor, Go Decomposition (GODEC), and robust PCA. Currently, tedana implements GSR and T1c-GSR.

Global signal control code