wiki

#!/bin/sh

# --------------PPI ALL FACES TEMPLATE ----------------
#
# This script works with it's partner python, PPI_ALLFACES.py, and a MATLAB script 
# PPI_ALLFACES.m (in Scripts folder on Munin) to run PPI analysis.  It
# uses the PPI "button" in SPM to first extract a timeseries from
# based on a user specified roi.  Since the matrix that species we want to look
# at All Faces > Shapes is equivalent for all subjects this particular script is 
# hardcoded with the matrix, and does not require an order number OR matrix for
# user input.  If you are interested in running PPI for a contrast other
# than Faces > Shapes, please use PPI_FACES, or PPI_CARDS for the cards
# equivalent - which will take in an order number and produce contrasts for
# all conditions.  After PPI, this script moves into a single subject analysis,  
# and uses the extracted values (under PPI.P, PPI.ppi, and PPI.Y) as regressors.   
# It uses the ART motion outliers from the subject's original BOLD preprocessing for the
# task of interest as an additional regressor.  Output goes into the user 
# specified folder name under Analysis/SPM/Analyzed/(Subject)
#
# ----------------------------------------------------

# --- BEGIN GLOBAL DIRECTIVE -- 
#$ -S /bin/sh
#$ -o $HOME/$JOB_NAME.$JOB_ID.out
#$ -e $HOME/$JOB_NAME.$JOB_ID.out
#$ -m ea
# -- END GLOBAL DIRECTIVE -- 

# -- BEGIN PRE-USER --
#Name of experiment whose data you want to access 
EXPERIMENT=${EXPERIMENT:?"Experiment not provided"}

source /etc/biac_sge.sh

EXPERIMENT=`biacmount $EXPERIMENT`
EXPERIMENT=${EXPERIMENT:?"Returned NULL Experiment"}

if [ $EXPERIMENT = "ERROR" ]
then
	exit 32
else 
#Timestamp
echo "----JOB [$JOB_NAME.$JOB_ID] START [`date`] on HOST [$HOSTNAME]----" 
# -- END PRE-USER --
# **********************************************************

# -- BEGIN USER DIRECTIVE --
# Send notifications to the following address
#$ -M SUB_USEREMAIL_SUB

# -- END USER DIRECTIVE --

# -- BEGIN USER SCRIPT --


# ------------------------------------------------------------------------------
#  Step 1: Variables and Path Preparation
# ------------------------------------------------------------------------------

# Initialize input variables (fed in via python script)
SUBJ="SUB_SUBNUM_SUB"                # This is the full subject folder name under Data
RUN=SUB_RUNNUM_SUB                   # This is a run number, if applicable
OUTPUTFOL="SUB_OUTPUTFOL_SUB"        # This is the user specified name for the output folder under Analyzed/Subject
ATASK="SUB_ATASK_SUB"                # this is the task that the user is running - since the matrix is specific to the 
                                     # task, we can only run 1 at a time
VOIMASKTYPE="SUB_VMASKTYPE_SUB"      # the type of VOI mask to make (cube,sphere,mask)
VOINAME="SUB_NAMEOFVOI_SUB"          # name that we want our resulting VOI to have
CONTRASTNO=SUB_CONNUM_SUB            # this is the number of the contrast from the single subject SPM.mat that we want
                                     # to use to extract values from
SCENTERX=SUB_CENTERSPHEREX_SUB       # center voxels of sphere for VOI [x y z]
SCENTERY=SUB_CENTERSPHEREY_SUB  
SCENTERZ=SUB_CENTERSPHEREZ_SUB  
SRADIUS=SUB_RADIUSSPHERE_SUB         # radius of sphere for VOI
BOXDIMX=SUB_DIMBOXX_SUB              # Dimensions of the box for the VOI [2 2 2]
BOXDIMY=SUB_DIMBOXY_SUB
BOXDIMZ=SUB_DIMBOXZ_SUB
BOXCENTERX=SUB_CENTERBOXX_SUB        # Center of the box for the VOI [-10 -10 -10]
BOXCENTERY=SUB_CENTERBOXY_SUB
BOXCENTERZ=SUB_CENTERBOXZ_SUB
THEVOIMASK="SUB_THEMASKVOI_SUB"        # This is the name of a mask to use to make the VOI 
                                       # Mask name must include the extension!
VOIMASKTHRESH=SUB_MASKVOITHRESH_SUB    # The threshold to use for the VOI mask, should be 1?
CONTRAST="SUB_CONNAME_SUB"             # This is the name of the contrast we are interested in (Faces_gr_Shapes)
THRESHDESC="SUB_DESCOFTHRESH_SUB"      # This is either "FWE" or "none"
THRESHOLD=SUB_THRESH_SUB               # This is the threshold to use to create the individual VOI
EXTENT=SUB_VOXEXT_SUB                  # The extent threshold (0)
ADJUSTDATA=SUB_DATAADJUST_SUB          # Index of the F Contrast
SESSION=SUB_NUMSESS_SUB                # Choice of the session number - should be 1?
MASKOTHER="SUB_OTHERMASK_SUB"          # If the user wants to mask with another contrast (yes/no)
MASKOTHERCON="SUB_OTHERMASKCON_SUB"    # If yes, we need the contrast#, threshold, and inclusive
          
SUBINCLUDED="SUB_SUBINCLUDED_SUB"        # This is the number of subjects folder underROI/PPI/Task (125s)
MASKOTHERTHRESH=SUB_OTHERMASKTHRESH_SUB
MASKOTHERINCLUSIVE="SUB_OTHERMASKINCLUSIVE_SUB"

# Here we check that the user is running faces.  This script does not support other tasks! 
# Since the all faces > shapes matrix is the same for everyone, we don't need to know the order number.
case $ATASK in
    'faces')      echo 'Task selected for PPI analysis is faces.'
    ;;
    *)      	  echo "$ATASK is not a valid task name."
    	    	  echo "...must be faces!";;
esac

#Make the subject's VOI folder and Contrast folder
mkdir -p $EXPERIMENT/Analysis/SPM/Analyzed/$SUBJ/VOIs
mkdir -p $EXPERIMENT/Analysis/SPM/Analyzed/$SUBJ/VOIs/$CONTRAST
#Make the subject specific output directory
mkdir -p $EXPERIMENT/Analysis/SPM/Analyzed/$SUBJ/PPI
mkdir -p $EXPERIMENT/Analysis/SPM/Analyzed/$SUBJ/PPI/$CONTRAST
mkdir -p $EXPERIMENT/Analysis/SPM/Analyzed/$SUBJ/PPI/$CONTRAST/$OUTPUTFOL
  
# Initialize other variables to pass on to matlab template script
OUTDIR=$EXPERIMENT/Analysis/SPM/Analyzed/$SUBJ/PPI/$CONTRAST/$OUTPUTFOL       # This is the output directory
SCRIPTDIR=$EXPERIMENT/Scripts/                                  # This is the location of our MATLAB script templates
BIACROOT=/usr/local/packages/MATLAB/BIAC                        # This is where matlab is installed on the custer

# ------------------------------------------------------------------------------
#  Step 2: Creation and run of PPI_ALLFACES subject script
# ------------------------------------------------------------------------------


cd $SCRIPTDIR/MATLAB/PPI

# Loop through template script replacing keywords
for i in 'PPI_ALLFACES.m'; do
sed -e 's@SUB_MOUNT_SUB@'$EXPERIMENT'@g' \
 -e 's@SUB_OUTPUT_SUB@'$OUTPUTFOL'@g' \
 -e 's@SUB_BIACROOT_SUB@'$BIACROOT'@g' \
 -e 's@SUB_CONTRASTNO_SUB@'$CONTRASTNO'@g' \
 -e 's@SUB_TASK_SUB@'$ATASK'@g' \
 -e 's@SUB_VOINAME_SUB@'$VOINAME'@g' \
 -e 's@SUB_EXTENT_SUB@'$EXTENT'@g' \
 -e 's@SUB_CONTRAST_SUB@'$CONTRAST'@g' \
 -e 's@SUB_THETHRESHOLD_SUB@'$THRESHOLD'@g' \
 -e 's@SUB_SCRIPTDIR_SUB@'$SCRIPTDIR'@g' \
 -e 's@SUB_ADJUSTDATA_SUB@'$ADJUSTDATA'@g' \
 -e 's@SUB_SESSION_SUB@'$SESSION'@g' \
 -e 's@SUB_THRESHDESC_SUB@'$THRESHDESC'@g' \
 -e 's@SUB_MASKOTHER_SUB@'$MASKOTHER'@g' \
 -e 's@SUB_MASKOTHERCON_SUB@'$MASKOTHERCON'@g' \
 -e 's@SUB_INCLUDEDSUB_SUB@'$SUBINCLUDED'@g' \
 -e 's@SUB_MASKOTHERTHRESH_SUB@'$MASKOTHERTHRESH'@g' \
 -e 's@SUB_MASKOTHERINCLUSIVE_SUB@'$MASKOTHERINCLUSIVE'@g' \
 -e 's@SUB_VOIMASK_SUB@'$THEVOIMASK'@g' \
 -e 's@SUB_SPHERERADIUS_SUB@'$SRADIUS'@g' \
 -e 's@SUB_SPHERECENTERX_SUB@'$SCENTERX'@g' \
 -e 's@SUB_SPHERECENTERY_SUB@'$SCENTERY'@g' \
 -e 's@SUB_SPHERECENTERZ_SUB@'$SCENTERZ'@g' \
 -e 's@SUB_BOXCENTERX_SUB@'$BOXCENTER'@g' \
 -e 's@SUB_BOXCENTERY_SUB@'$BOXCENTER'@g' \
 -e 's@SUB_BOXCENTERZ_SUB@'$BOXCENTER'@g' \
 -e 's@SUB_VOIMASKTHRESH_SUB@'$VOIMASKTHRESH'@g' \
 -e 's@SUB_VOIMASKTYPE_SUB@'$VOIMASKTYPE'@g' \
 -e 's@SUB_BOXDIM_SUB@'$BOXDIMX'@g' \
 -e 's@SUB_BOXDIM_SUB@'$BOXDIMY'@g' \
 -e 's@SUB_BOXDIM_SUB@'$BOXDIMZ'@g' \
 -e 's@SUB_SUBJECT_SUB@'$SUBJ'@g' <$i> $OUTDIR/PPI_ALLFACES.m
 done
 
# Change to output directory and run matlab on input script
cd $OUTDIR

# ------------------------------------------------------------------------------
#  Step 3: Preparing Virtual Display
# ------------------------------------------------------------------------------

#First we choose an int at random from 100-500, which will be the location in
#memory to allocate the display
RANDINT=$[( $RANDOM % ($[500 - 100] + 1)) + 100 ]
echo "the random integer for Xvfb is ${RANDINT}";

#Now we need to see if this number is already being used for Xvfb on the node.  We can
#tell because when it is active, it will have a "lock file"

while [ -e "/tmp/.X11-unix/X${RANDINT}" ]
do
      echo "lock file was already created for $RANDINT";
      echo "Trying a new number...";
      RANDINT=$[( $RANDOM % ($[500 - 100] + 1)) + 100 ]
      echo "the random integer for Xvfb is ${RANDINT}";
done

#Initialize Xvfb, put buffer output in TEMP directory
Xvfb :$RANDINT -fbdir $TMPDIR &
/usr/local/bin/matlab -display :$RANDINT < PPI_ALLFACES.m;

echo "Done running PPI_ALLFACES.m in matlab"

# If the lock was created, delete it
if [ -e "/tmp/.X11-unix/X${RANDINT}" ]
      then
      echo "lock file was created";
      echo "cleaning up my lock file";
      rm /tmp/.X${RANDINT}-lock;
      rm /tmp/.X11-unix/X${RANDINT};
      echo "lock file was deleted";
fi
fi

# -- END USER SCRIPT -- #

# **********************************************************
# -- BEGIN POST-USER -- 
echo "----JOB [$JOB_NAME.$JOB_ID] STOP [`date`]----" 
OUTDIR=${OUTDIR:-$EXPERIMENT/Analysis/SPM/Processed/$SUBJ}
mv $HOME/$JOB_NAME.$JOB_ID.out $OUTDIR/$JOB_NAME.$JOB_ID.out	 
RETURNCODE=${RETURNCODE:-0}
exit $RETURNCODE
fi
# -- END POST USER--