Automatic analysis (aa)

Automatic analysis (aa) is a pipeline system for neuroimaging, written in Matlab. It supports SPM 5/8 and some functions from FSL.

For more information see:

Any problems, report them to Danny Mitchell (version 2 and 3) or Tibor Auer (version 4).

<<TableOfContents: execution failed [list index out of range] (see also the log)>>

Paths to aa

Different versions live in:

Installing aa


Using aa

For a comprehensive summary, please read the latest manuscript. Please, do not forget to cite it when using!


Before running aa you need to add the corresponding path to MATLAB Path:

(!) To avoid version conflicts make sure that it is added to the top of the Path. It is even more important that path_to_aa/extrafunctions/spm_mods is on the top (of SPM's paths), so modification to the spm may have effect.


You need a

Optionally, you can also specify your own parameter settings loaded by aarecipe. E.g.: User-specific parameter settings (you may need to change the path pointing to the "parent" xml)


Parallel computing

Handling multiple DICOM sources

Support for NIFTI-4D images

Multi-level interlinked reporting

Garbage collection

(!) From v4.2, it is automatically performed at the end of the analysis according to aap.options.garbagecollection

"Inheritable" parameter settings

There is an option to have site-, user-, and/or study-specific parameter settings containing only the parameters to be overridden (see example).

Non-Standard Modules

Advanced Features

Input file

It is possible to specify Subjects, Sessions and Events based on a text file. Required options in aap.acq_details.input (see also aap_parameters_defaults_CBSU.xml):

Citing aa

Cusack R, Vicente-Grabovetsky A, Mitchell DJ, Wild CJ, Auer T, Linke AC, Peelle JE (2015). Automatic analysis (aa): Efficient neuroimaging workflows and parallel processing using Matlab and XML. Frontiers in Neuroinformatics 8:90.