The following software should be available on your system: (necessary tools are included in the package)
Here we demonstrate the use of TA toolbox. We show how to make the basic settings for running TA algorithm. A simple synthetic dataset (Neuroimage paper) is included in the toolbox (test_data/phantom1db).
1. Data Preprocessing
Generally the functional data is preprocessed (realignment, smoothing, etc.) before TA. Normalization of the functional data into a common space (MNI/Talairach) is not necessary, however, the atlas and the functional data have to be matched. We use atlas wrapper to convert the structural atlas to functional space (from IBASPM and Jonas Richiardi preprocessing pipeline). Atlas should be a volume whose intensity consists of postive numbers inside the atlas and zero otherwise.
2. Running TA
The algorithm is run through a main (main.m) function in the toolbox. First, the toolbox should be added into the matlab path. Then, to start the process user needs to input the data path
s and parameters (MyInputs.m or MyInputsTest.m for synthetic data).
METHOD_TEMP: "S", for spike-like activity-inducing signals, "B" for block-like activity-inducing signals and "W" for smooth activity-inducing signals
METHOD_SPAT: "NO" for no spatial smoothing, "STRSPR" for structured-sparsity, "Tik" for l_2-norm smoothing)
DETRENDING: "normalize" does only z-normalization to each time course, "dct" performs first Discrete Cosine Transform for low frequency drifts and then performs z-normalization. There are also some parameters tuned by the user such as type of hemodynamic response function (HRF), repetition time (TR) etc.Then, the algorithm is run by executing main.m.
The user should enter the path to the data, atlas and the results and then enter the type of analysis he/she wants to perform. TA has various temporal and spatial regularization options:
3. Results The results are saved in "path_results" folder defined in "MyInputs.m".
The whole workspace is saved into a mat-file. The format of the file is "OUTS_METHODTEMP_LAMBDACOEF_METHODSPATIAL_SPATIALLAMBDACOEF_NAMEOFDATA_DATE.mat"
4 NIFTI-files are saved:
"TCN_.nii" = NORMALIZED-DETRENDED DATA
"TC_OUT_.nii" = RECOVERED ACTIVITY-RELATED SIGNALS
"TC_D_OUT_.nii" = RECOVERED ACTIVITY-INDUCING SIGNALS
"TC_D2_OUT_.nii" = RECOVERED INNOVATION SIGNALSThe results are 4D datasets and can be visualized with an appropriate data visualization tool (e.g., AFNI).
Here, we show TA analysis results for one subject performing 10 visual stimuli (Neuroimage paper).