<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>AutomaticAnalysisFileStructure</title><revhistory><revision><revnumber>11</revnumber><date>2013-03-07 21:22:59</date><authorinitials>localhost</authorinitials><revremark>converted to 1.6 markup</revremark></revision><revision><revnumber>10</revnumber><date>2006-06-05 09:43:09</date><authorinitials>RhodriCusack</authorinitials></revision><revision><revnumber>9</revnumber><date>2006-06-05 09:42:26</date><authorinitials>RhodriCusack</authorinitials></revision><revision><revnumber>8</revnumber><date>2006-06-05 09:42:05</date><authorinitials>RhodriCusack</authorinitials></revision><revision><revnumber>7</revnumber><date>2006-06-05 09:41:36</date><authorinitials>RhodriCusack</authorinitials></revision><revision><revnumber>6</revnumber><date>2006-06-05 09:40:35</date><authorinitials>RhodriCusack</authorinitials></revision><revision><revnumber>5</revnumber><date>2006-06-05 09:40:15</date><authorinitials>RhodriCusack</authorinitials></revision><revision><revnumber>4</revnumber><date>2006-06-05 09:39:23</date><authorinitials>RhodriCusack</authorinitials></revision><revision><revnumber>3</revnumber><date>2006-06-05 09:39:00</date><authorinitials>RhodriCusack</authorinitials></revision><revision><revnumber>2</revnumber><date>2006-06-05 09:38:45</date><authorinitials>RhodriCusack</authorinitials></revision><revision><revnumber>1</revnumber><date>2006-06-05 09:38:27</date><authorinitials>RhodriCusack</authorinitials></revision></revhistory></articleinfo><para>This manual is for aa parallel version 2.2 and earlier. You might prefer the <ulink url="http://www.cambridgeneuroimaging.com/aawiki">new aa wiki for aa version 3.0 and above</ulink> or <ulink url="http://www.cambridgeneuroimaging.com/">information on cloud execution</ulink> </para><itemizedlist><listitem><para><ulink url="https://lsr-wiki-02.mrc-cbu.cam.ac.uk/imaging/AutomaticAnalysisFileStructure/imaging/AutomaticAnalysisIntroduction#">Introduction</ulink> </para></listitem><listitem><para><ulink url="https://lsr-wiki-02.mrc-cbu.cam.ac.uk/imaging/AutomaticAnalysisFileStructure/imaging/AutomaticAnalysisManual#">General overview</ulink> </para></listitem><listitem><para><ulink url="https://lsr-wiki-02.mrc-cbu.cam.ac.uk/imaging/AutomaticAnalysisFileStructure/imaging/AutomaticAnalysisFileStructure#">File format</ulink> </para></listitem><listitem><para><ulink url="https://lsr-wiki-02.mrc-cbu.cam.ac.uk/imaging/AutomaticAnalysisFileStructure/imaging/AutomaticAnalysisRecipes#">Choosing an appropriate recipe</ulink> </para></listitem><listitem><para><ulink url="https://lsr-wiki-02.mrc-cbu.cam.ac.uk/imaging/AutomaticAnalysisFileStructure/imaging/AutomaticAnalysisGettingStarted#">Getting started</ulink> </para></listitem><listitem><para><ulink url="https://lsr-wiki-02.mrc-cbu.cam.ac.uk/imaging/AutomaticAnalysisFileStructure/imaging/AutomaticAnalysisParallel#">aa parallel</ulink>  </para></listitem><listitem><para><ulink url="https://lsr-wiki-02.mrc-cbu.cam.ac.uk/imaging/AutomaticAnalysisFileStructure/imaging/AutomaticAnalysisManualReference#">Parameter set reference</ulink> </para></listitem><listitem><para><ulink url="https://lsr-wiki-02.mrc-cbu.cam.ac.uk/imaging/AutomaticAnalysisFileStructure/imaging/AutomaticAnalysisVersions#">Release notes for different versions</ulink> </para></listitem></itemizedlist><!--rule (<hr>) is not applicable to DocBook--><para> <emphasis role="strong"> Contents </emphasis> <!--The macro TableOfContents doesn't work with the DocBook formatter.--> </para><!--rule (<hr>) is not applicable to DocBook--><section><title>File Structure</title><section><title>Raw data</title><para>The data from our scanner, via a dicom gateway, get written in the following structure. </para><para><emphasis>/mridata/cbu/CBU[session number]_CBU[session number]/[sessionstarttime]/Series_[number]_[protocol name]</emphasis> </para><para><emphasis>e.g., /mridata/cbu/CBU060500_CBU060500/20060505_153428/Series_003_CBU_EPI_Standard</emphasis> </para><para>Users outside Cambridge will probably find their data are written in a different format, and the protocol names are different. This will require a few changes to the aa code - see <ulink url="https://lsr-wiki-02.mrc-cbu.cam.ac.uk/imaging/AutomaticAnalysisFileStructure/imaging/AutomaticAnalysisInstallation#">AutomaticAnalysisInstallation</ulink> on how to make these </para><para>You may change the location of raw data by changing the aap.directory_conventions.rawdatadir </para></section><section><title>Processed data</title><para>While some control is provided over naming conventions, the file structure for processed data is essentially fixed. For each subject, the format is</para><para><emphasis>[aap.acq_details.root]/[subject name]</emphasis> </para><para><emphasis>e.g., /imaging/rhodri/mystudy/CBU060100</emphasis> </para><para>within each subject directory you will typically find the following subdirectories </para><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para><emphasis>structurals</emphasis>       </para></entry><entry colsep="1" rowsep="1"><para>stores processed structural (i.e., hires T1 weighted) images</para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><emphasis>realtime_tmaps</emphasis>    </para></entry><entry colsep="1" rowsep="1"><para>stores converted real time t maps (if present) in nifti format</para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><emphasis>[named session]</emphasis>   </para></entry><entry colsep="1" rowsep="1"><para>one directory for each session, with name as provided for sessions in user script. Contains raw and processed EPIs in NIFTI format</para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><emphasis>results</emphasis>           </para></entry><entry colsep="1" rowsep="1"><para>stores first level statistical model (if used)</para></entry></row></tbody></tgroup></informaltable><para>within the study directory you will find </para><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para><emphasis>rfx</emphasis>               </para></entry><entry colsep="1" rowsep="1"><para> second level analysis, if used</para></entry></row></tbody></tgroup></informaltable><section><title>location of aa files</title><para>Various aa specific files are written into this directory structure. In study root: </para><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para><emphasis>aap_parameters.mat</emphasis> </para></entry><entry colsep="1" rowsep="1"><para> the aap structure corresponding to the user script last run on this study</para></entry></row></tbody></tgroup></informaltable><informaltable><tgroup cols="1"><colspec colname="col_0"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para><emphasis>done_[module name]</emphasis></para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><emphasis>diagnostic_[module name]</emphasis></para></entry></row></tbody></tgroup></informaltable><para>Each module specifies the level at which it should be run (e.g., once per study, per subject, or per session). The done_ and diagnostic_ files for a module will then get written to the appropriate study, subject or session directory. </para></section></section></section></article>