Giter Site home page Giter Site logo

aa's Introduction

๐Ÿšง aa ๐Ÿšง

(Not maintained any more. A new app (based on reproa) is coming. Stay tuned!)

Description

BIDS App containing an instance of the Automatic Analysis.

Automatic Analysis software was originally developed by Dr Rhodri Cusack for supporting research at the MRC Cognition and Brain Science Unit. It is made available to the academic community in the hope that it may prove useful.

Definitions: aa means the Automatic Analysis software package and any associated documentation whether electronic or printed.

aa is a pipeline system for neuroimaging written primarily in Matlab. It robustly supports recent versions of SPM, as well as selected functions from other software packages. The goal is to facilitate automatic, flexible, and replicable neuroimaging analyses through a comprehensive pipeline system.

License

Use of this software is subject to the terms of the license, found in the license.txt file distributed with this software.

Documentations

More information can be found on the official aa webpage

Error Reporting

Experiencing problems? Please open an issue and explain what's happening so we can help.

Acknowledgement

For any papers that report data analyzed with aa, please include the website (http://www.automaticanalysis.org) and cite the aa paper:

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.

Instructions

The bids/aa Docker container enables users to run Automatic Analysis right from container launch. The pipeline requires that data be organized in accordance with the BIDS spec.

To get your container ready to run just follow these steps:

  • In your terminal, type:
$ docker pull bids/aa

Now we're ready to launch our instances and process some data!

Like a normal docker container, you can startup your container with a single line.

usage: run <bids_dir> <output_dir> {participant|group}
           [--participant_label <participant_label>]
           [--freesurfer_license <license_file>]
           [--connection <pipeline to connect to>]
           [<tasklist> <user_customisation>]

positional arguments:
    <bids_dir>
                            The directory with the input dataset formatted
                            according to the BIDS standard.
    <output_dir>
                            The directory where the output files should be stored.
                            If you are running group level analysis this folder
                            should be prepopulated with the results of the
                            participant level analysis.
    {participant|group}
                            Level of the analysis that will be performed. Multiple
                            participant level analyses can be run independently
                            (in parallel) using the same output_dir.

optional arguments:
    --participant_label <participant_label>
                            The label(s) of the participant(s) that should be
                            analyzed. The label corresponds to
                            sub-<participant_label> from the BIDS spec (so it does
                            not include "sub-"). If this parameter is not provided
                            all subjects should be analyzed. Multiple participants
                            can be specified with a space separated list.
    --freesurfer_license <license_file>
                            Path to FreeSurfer license key file. Required if you specify
                            tasklist with freesurfer modules. To obtain it you
                            need to register (for free) at
                            https://surfer.nmr.mgh.harvard.edu/registration.html
    --connection <pipeline to connect to>
                            Path to a previously processed pipeline, from where inputs
                            will be taken.
    <tasklist>
                            aa tasklist describing the steps (XML file). It also requires
                            <user_customisation>.
    <user_customisation>
                            Customisation of the provided <tasklist>. It must be an XML
                            file corresponding to aa's aap structure.
                                - Its structure must correspond to that of the aap
                                  apart from special cases (see later).
                                - Index in lists of structures (e.g. aamod_smooth(1))
                                  can be indicated following to aa practice:
                                  e.g. aamod_smooth_00001. Default is 1
                                - Special cases
                                    - firstlevel_contrasts
                                    - input.isBIDS

aa's People

Contributors

chrisgorgo avatar pre-commit-ci[bot] avatar remi-gau avatar tiborauer avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar

aa's Issues

TODO

  • sub-pipeline selection from a limited set of predefined pipelines
  • config file (m-file) to customize the pipeline

Failed to instantiate MATLAB

when I ran this docker command:
sudo docker run -i --rm
-v ~/bids/dataset/:/bids_dataset
-v ~/outputs:/outputs
bids/aa
/bids_dataset /outputs participant --participant_label 01
--fs-license-file /outputs/fs_license.txt

I got this error:
LD_LIBRARY_PATH is .:/opt/mcr/v94/runtime/glnxa64:/opt/mcr/v94/bin/glnxa64:/opt/mcr/v94/sys/os/glnxa64:/opt/mcr/v94/sys/opengl/lib/glnxa64
Failed to initialize MATLAB Runtime Instance: The specified component has expired.

Invalid argument order

A valid BIDS App takes the following positional arguments

  1. Position 1: input bids directory
  2. Position 2: output directory
  3. Position 3: analysis level

However, aa currently takes:

  1. Position 1: input bids directory
  2. Position 2: XML config file
  3. Position 3: XML config file2
  4. Position 4: output directory
  5. Position 5: analysis level

making it incompatible with the framework. The extra XML files would have to be moved to positions 4 and 5.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.