Which FSL tools automatically use the cluster
The following programs/scripts are able to self-submit in an SGE-capable environment and should never be used in conjunction with fsl_sub.
FSL TOOLS | |
---|---|
Scripts that self-submit | |
FDT | bedpostx |
FEAT | feat feat_gm_prepare |
FIRST | run_first_all |
FSLVBM | fslvbm_2_template fslvbm_3_proc |
POSSUM | possumX |
RANDOMISE | randomise_parallel |
TBSS | tbss_2_reg |
GUIs that self-submit | |
FDT | FDT GUI ( probtrackx only ) |
FEAT | FEAT GUI |
FLIRT | FLIRT GUI |
POSSUM | POSSUM GUI |
Note that all other FSL GUIs will only run jobs on the local machine. To submit to a cluster you must use the equivalent command-line call in conjunction with fsl_sub (see below).
How to login to the PBIC Cluster
Login to the frontend machine for the cluster pbic.bham.ac.uk using VNC
How do I submit other FSL jobs to a cluster?
To submit all other tasks to a cluster use the fsl_sub command, which takes as input either a normal program call or a plain-text list of tasks:
fsl_sub fslmaths input -add 1 output
fsl_sub my_task_list
If you have an estimate of how long a job will take, you can specify the required job length in minutes with the -T option:
fsl_sub -T 30 fslmaths input -add 1 output
Or if you have a particular queue you want the job to run on use the -q option ( fsl_sub defaults to "long.q" ):
fsl_sub -q bigmem.q list_of_ram_intensive_jobs
Which jobs should be submitted to a cluster?
In general a script or program should be submitted to a cluster via fsl_sub if
1) It uses a large ( in time and/or voxel dimensions ) dataset.
2) The script or program performs a non-trivial processing task.
Typically the programs in fslutils ( fslmaths, fslstats, fslroi etc ) can be run locally, more sophisticated programs like bet and flirt should be submitted unless dealing with small images. A script involving a large amount of processing like tbss_3_postreg should always be submitted to a queue.