FastTree Dispatcher


FastTree infers approximately-maximum-likelihood phylogenetic trees from alignments of nucleotide or protein sequences. See


Fasttree(, file.path="",,, args=NULL,
         type="DNA", model=NULL, gamma=FALSE, stat=FALSE, print.curl=FALSE, 
         shared.username=NULL, suppress.Warnings=FALSE)


name of file to be evaluated on the Discovery Environment (DE), see details for supported input formats.


optional path to a user's subdirectory on the DE; default path is empty, which leads to the home directory

the name given to the output tree (default FastTree_OutTree.nwk)


Two options "PROTEIN" or "DNA". This defines the type of sequences in the file, either proteins or nucleotides.


Substitution model. For DNA the choices are GTRCAT, and JCCAT (default), the Jukes-Cantor + CAT model. For protein the choices are JTTCAT (default), and WAGCAT.


(-gamma) Use this option (about 5% slower) if you want to rescale the branch lengths and compute a Gamma20-based likelihood. Gamma likelihoods are more comparable across runs (default is FALSE).


(-log) This allows for statistical comparisons (when gamma=TRUE) of the likelihood of different topologies. The result file is ‘logfile’.

the name to give the job being submitted


Prints the curl statement that can be used in the terminal, if curl is installed on your computer


With iPlant you have the ability to share folders with other users. If someone has shared a folder with you and you want to run a job with them, enter their username for this input.


This will turn off the warnings, will speed up run time. Use with caution, if the inputs are incorrect they will not be caught.


Optional for arguments (i.e. flags). The Fasttree model has much additional functionality that is not fit into this wrapper function (, see details. This option allows users to add anything that is not included, see details.


The input file formats that are supported are fasta format or interleaved phylip format

Additional arguments, args, can be found at The args input is text with the flags and inputs for those flags in a string like on the command line.

Fasttree outputs trees in Newick format The placement of the root is not biologically meaningful. The local support values are given as names for the internal nodes, and range from 0 to 1, not from 0 to 100 or 0 to 1,000. If all sequences are unique, then the tree will be fully resolved (the root will have three children and other internal nodes will have two children). If there are multiple sequences that are identical to each other, then there will be a multifurcation. Also, there are no support values for the parent nodes of redundant sequences.


A list containing the job id and the job name is provided for jobs submitted. If an error, then a message stating the error should also be reported.

See Also

SubmitJob, Validate, UploadFile


## Not run: data(fasta_aa.aln)
## Not run: write.table(fasta_aa.aln, "fasta_aa.aln", quote=FALSE, row.names=FALSE, col.names=FALSE)
## Not run: Validate("username","password")
## Not run: UploadFile("fasta_aa.aln")
## Not run: myJobFaP <- Fasttree("phylip_interleaved_aa.aln","fasttreeAAphy")
comments powered by Disqus