{"id":4330,"date":"2019-12-11T11:13:44","date_gmt":"2019-12-11T11:13:44","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf3\/?page_id=4330"},"modified":"2025-06-05T15:32:44","modified_gmt":"2025-06-05T14:32:44","slug":"fasttree","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/software\/applications\/fasttree\/","title":{"rendered":"FastTree"},"content":{"rendered":"<h2>Overview<\/h2>\n<p><a href=\"http:\/\/www.microbesonline.org\/fasttree\">FastTree<\/a> is a program to infer approximately-maximum-likelihood phylogenetic trees from alignments of nucleotide or protein sequences. FastTree can handle alignments with up to a million of sequences in a reasonable amount of time and memory.<\/p>\n<p>Version 2.1.11 is installed on the CSF.<\/p>\n<h2>Restrictions on use<\/h2>\n<p>There are no restrictions on accessing the software on the CSF. It is released under the <a href=\"http:\/\/www.gnu.org\/copyleft\/gpl.html\">GNU GPL v2 license<\/a> and all usage must adhere to that license.<\/p>\n<h2>Set up procedure<\/h2>\n<p>We now recommend loading modulefiles within your jobscript so that you have a full record of how the job was run. Load the module file like this:<\/p>\n<pre>\r\nmodule load apps\/intel-18.0\/fasttree\/2.1.11          # Serial and multi-core versions\r\n<\/pre>\n<h2>Running the application<\/h2>\n<p>Please do not run <code>FastTree<\/code> on the login node. Jobs should be submitted to the compute nodes via batch.<\/p>\n<h3>Serial batch job submission<\/h3>\n<p>Create a batch submission script (which will load the modulefile in the jobscript), for example:<\/p>\n<pre class='slurm'>\r\n#!\/bin\/bash --login\r\n#SBATCH -p serial   # Partition is required. Runs on Intel hardware\r\n#SBATCH -t 1-0      # Wallclock limit (days-hours). Required!\r\n                    # Max permitted is 7 days (7-0).\r\n\r\n# Purge your environment and load the FastTree module\r\nmodule purge\r\nmodule load apps\/intel-18.0\/fasttree\/2.1.11\r\n\r\n# Serial version of the app (will use 1 CPU-core)\r\n\r\n# To infer a tree for a protein alignment with the JTT+CAT model, use\r\nFastTree alignment.file > tree_file \r\n\r\n# To infer a tree for a nucleotide alignment with the GTR+CAT model, use\r\nFastTree -gtr -nt alignment_file > tree_file\r\n<\/pre>\n<p>Submit the jobscript using: <\/p>\n<pre class='slurm'>sbatch <em>scriptname<\/em><\/pre>\n<p>where <em>scriptname<\/em> is the name of your jobscript.<\/p>\n<h3>Parallel batch job submission<\/h3>\n<p>FastTree can use multiple CPU cores in a single-compute node. The executable program is called <code>FastTreeMP<\/code>. Note that the FastTree website contains the following information about the multi-core version:<\/p>\n<ul>\n<li>As of version 2.1, <code>FastTreeMP<\/code> will not give exactly the same results as <code>FastTree<\/code> because the top-hits heuristics become non-deterministic (depending on which seed is reached first) and because the star topology test is turned off. However, in practice, the results are of the same quality.<\/li>\n<\/ul>\n<p>Create a batch submission script (which will load the modulefile in the jobscript), for example:<\/p>\n<pre class='slurm'>\r\n#!\/bin\/bash --login\r\n#SBATCH -p multicore  # Partition is required. Runs on an AMD Genoa hardware\r\n#SBATCH -n 4          # Number of cores, can be 2-168\r\n#SBATCH -t 1-0        # Wallclock limit (days-hours). Required!\r\n                      # Max permitted is 7 days (7-0).\r\n\r\n# Purge your environment and load the FastTree module\r\nmodule purge\r\nmodule load apps\/intel-18.0\/fasttree\/2.1.11\r\n\r\n# Inform FastTreeMP how many cores to use. $SLURM_NTASKS is set to the number of cores above.\r\nexport OMP_NUM_THREADS=$SLURM_NTASKS\r\n\r\n# To infer a tree for a protein alignment with the JTT+CAT model, use\r\nFastTreeMP alignment.file > tree_file \r\n\r\n# To infer a tree for a nucleotide alignment with the GTR+CAT model, use\r\nFastTreeMP -gtr -nt alignment_file > tree_file\r\n<\/pre>\n<p>Submit the jobscript using: <\/p>\n<pre class='slurm'>sbatch <em>scriptname<\/em><\/pre>\n<p>where <em>scriptname<\/em> is the name of your jobscript.<\/p>\n<h2>Further info<\/h2>\n<ul>\n<li><a href=\"https:\/\/morgannprice.github.io\/fasttree\/\">FastTree website<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Overview FastTree is a program to infer approximately-maximum-likelihood phylogenetic trees from alignments of nucleotide or protein sequences. FastTree can handle alignments with up to a million of sequences in a reasonable amount of time and memory. Version 2.1.11 is installed on the CSF. Restrictions on use There are no restrictions on accessing the software on the CSF. It is released under the GNU GPL v2 license and all usage must adhere to that license. Set.. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/software\/applications\/fasttree\/\">Read more &raquo;<\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"parent":86,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-4330","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/4330","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/comments?post=4330"}],"version-history":[{"count":9,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/4330\/revisions"}],"predecessor-version":[{"id":10297,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/4330\/revisions\/10297"}],"up":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/86"}],"wp:attachment":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/media?parent=4330"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}