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.

As of December 2020, AA is deprecated at CBU. The last update that was deployed at CBU is release 5.4.0_202008, which is available on the imaging system under /imaging/local/software/AA/release-5.4.0_202008. For critical errors in existing pipelines, please contact Johan Carlin for support. For new projects, please investigate alternatives such as nipype, which is available at CBU as part of the Neuroconda environment.

AA continues to be developed outside of CBU, and its developers can be reached on the project Github page.

The documentation below is outdated and should be read with caution.

For more information see:

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

Paths to aa

Different versions live in:

Installing aa

Requirements

Using aa

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

Configuration

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.

Running

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)

Features

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.

Recent Updates

2013/11/25

New feature - first-level model

Fix - subjectname

2013/11/21 New features!

2013/10/29 New features!

2013/09/06 New features!

Known issue (backward compatibility) SOLVED (see Recent Update on 2013/10/29):

If you want to customize DICOM sources, you need to put your own path to source not into rawdatadir directly (as used to), but into rawdatadir.paths (cell array) or rawdatadir.paths{1} (cellstring).

2013/08/08 Parallel computing is working

Known bugs:

Conventional SPM diagnostic will be missing for:

However, FSL diagnostics are unaffected.

2013/08/02 new version v4.1 (latest devel-share branch from GitHub)

2013/06/26 merge with the latest devel-rhodri branch from GitHub

2013/06/06 new feature

2013/05/13 new feature

2013/04/24 CBSU Patch/Extension for Version 4 is available

New features:

Known bugs:

Parallel computing is still not working!

2013/03/03 Version 4 is available

New features in version 4