{"id":3702,"date":"2019-07-24T12:44:43","date_gmt":"2019-07-24T11:44:43","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf3\/?page_id=3702"},"modified":"2020-08-07T12:17:37","modified_gmt":"2020-08-07T11:17:37","slug":"salmon","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/software\/applications\/salmon\/","title":{"rendered":"Salmon"},"content":{"rendered":"

Overview<\/h2>\n

Salmon<\/a> is a tool for fast transcript quantification from RNA-seq data. It requires a set of target transcripts (either from a reference or de-novo assembly) to quantify. All you need to run Salmon is a FASTA file containing your reference transcripts and a (set of) FASTA\/FASTQ file(s) containing your reads. Optionally, Salmon can make use of pre-computed alignments (in the form of a SAM\/BAM file) to the transcripts rather than the raw reads.<\/p>\n

Versions 0.14.1 and 1.3.0 are installed on the CSF.<\/p>\n

Restrictions on use<\/h2>\n

Details of the licence, restrictions, links to licence docs etc
\nThere are no restrictions on accessing this software on the CSF. It is release under the GNU GPL v3.0<\/a> license and all use must adhere to that license.<\/p>\n

The authors of the software request that you cite your usage of the software using the reference:<\/p>\n

Rob Patro, Geet Duggal, Michael I. Love, Rafael A. Irizarry, Carl Kingsford.\r\nSalmon provides fast and bias-aware quantification of transcript expression.\r\nNature Methods. 2017;14(4):417-419. doi: 10.1038\/nmeth.4197\r\n<\/pre>\n
Set up procedure<\/h2>\n
We now recommend loading modulefiles within your jobscript so that you have a full record of how the job was run. See the example jobscript below for how to do this. Alternatively, you may load modulefiles on the login node and let the job inherit these settings<\/abbr>.<\/p>\n
Load one of the following modulefiles:<\/p>\n
module load apps\/binapps\/salmon\/0.14.1<\/pre>\n
or<\/p>\n
module load apps\/binapps\/salmon\/1.3.0<\/pre>\n
Running the application<\/h2>\n
Please do not run salmon on the login node. Jobs should be submitted to the compute nodes via batch.<\/p>\n
You may run salmon -h<\/code> to get a list of commands<\/em> that can be used with salmon. For example:<\/p>\n
salmon -h\r\nsalmon v1.3.0\r\nUsage:  salmon -h|--help or \r\n        salmon -v|--version or \r\n        salmon -c|--cite or \r\n        salmon [--no-version-check] <\/command> [-h | options]\r\n\r\nCommands:\r\n     index Create a salmon index\r\n     quant Quantify a sample\r\n     alevin single cell analysis\r\n     swim  Perform super-secret operation\r\n     quantmerge Merge multiple quantifications into a single file\r\n<\/pre>\n
You should use one of the commands in your jobscript (see below).<\/p>\n
Serial batch job submission<\/h3>\n
Create a batch submission script (which will load the modulefile in the jobscript), for example:<\/p>\n
#!\/bin\/bash --login\r\n#$ -cwd             # Job will run from the current directory\r\n                    # NO -V line - we load modulefiles in the jobscript\r\n\r\n# We now recommend loading the modulefile in the jobscript. Choose your required version.\r\nmodule load apps\/binapps\/salmon\/1.3.0\r\n\r\n# Inform salmon how many cores it can use. For serial jobs $NSLOTS will be set to 1.\r\nexport OMP_NUM_THREADS=$NSLOTS\r\n\r\nsalmon command<\/em> files<\/em>\r\n        #\r\n        # See above for the list of commands that salmon uses.\r\n<\/pre>\n
Submit the jobscript using:<\/p>\n
qsub scriptname<\/em><\/pre>\n
where scriptname<\/em> is the name of your jobscript.<\/p>\n
Parallel batch job submission<\/h3>\n
Salmon can use multiple cores in a single compute node (in the smp.pe<\/code> parallel environment). Create a batch submission script (which will load the modulefile in the jobscript), for example:<\/p>\n
#!\/bin\/bash --login\r\n#$ -cwd             # Job will run from the current directory\r\n#$ -pe smp.pe 8     # Number of cores. Can be 2 -- 32.\r\n                    # NO -V line - we load modulefiles in the jobscript\r\n\r\n# We now recommend loading the modulefile in the jobscript. Choose your required version.\r\nmodule load apps\/binapps\/salmon\/1.3.0\r\n\r\n# Inform salmon how many cores it can use. $NSLOTS will be set automatically\r\n# to the number of cores requested above.\r\nexport OMP_NUM_THREADS=$NSLOTS\r\n\r\nsalmon command<\/em> files<\/em>\r\n        #\r\n        # See above for the list of commands that salmon uses.\r\n<\/pre>\n
Submit the jobscript using:<\/p>\n
qsub scriptname<\/em><\/pre>\n
where scriptname<\/em> is the name of your jobscript.<\/p>\n
Further info<\/h2>\n