format-tree.pl - Format (and annotate) trees for printing
format-tree.pl <infiles> [optional arguments]
Substring(s) to strip from infile basenames before attempting to derive other infile (e.g., IDM files) and outfile names [default: none].
Suffix to append to (possibly stripped) infile basenames for deriving outfile names [default: none]. When not specified, outfile names are taken from infiles but original infiles are preserved by being appended a .bak suffix.
Sequence id mapping switch [default: no]. When specified, sequence ids are restored from the corresponding IDM files.
Path to an optional IDM file associating organism names to abbreviations (see
change-ids-ali.pl). When specified, ids to be restored from individual IDM files are first expanded using the long_org => abbr_org pairs listed in this global IDM file.
Final sequence id mapping switch [default: no]. When specified, final sequence ids are taken from additional IDM files named as *.final-idm.
A two-step mapping strategy allows annotating the tree by taxonomy while using custom sequence ids in the output tree. When both are specified, this argument takes precedence on the next one (
Auto final sequence id switch [default: no]. When specified, final sequence ids are automatically set to organism names fetched from the NCBI Taxonomy database on the basis of taxonomic information contained in the original sequence ids. This requires a local mirror of the NCBI Taxonomy database.
PHYLIP's consense import switch [default: no]. When specified, branch lengths of internal nodes are interpreted as statistical support values (e.g., BP). Note that the formatted tree will be devoid of branch lengths and should thus be displayed as a cladogram.
When specified, the tree is made ultrametric using the method of Britton et al. (2002), as implemented in
Direction of the node sorting operation [default: none]. The following directions are available: asc and desc.
When specified, a taxonomic analysis of all nodes is carried out and the nodes are named after their taxon at (or above) the specified taxonomic level. This requires a local mirror of the NCBI Taxonomy database.
Available levels are: superkingdom, kingdom, subkingdom, superphylum, phylum, subphylum, superclass, class, subclass, infraclass, superorder, order, suborder, infraorder, parvorder, superfamily, family, subfamily, tribe, subtribe, genus, subgenus, species group, species subgroup, species, subspecies, varietas, forma and 'no rank' (don't forget the quotes).
When specified, monophyletic nodes are collapsed exactly at the specified taxonomic level. This requires enabling taxonomic annotation.
Two special levels are also supported: label and color. With label, subtrees are collapsed on the various taxa of the CLS file (see
--colorizeoption just below), whereas with color, subtrees colored in the same color are collapsed. This allows collapsing nodes at various taxonomic levels and even non-monophyletic nodes composed of taxa identically colored on purpose.
When specified, branches of the tree are colored after their taxon using the specified CLS file. This requires enabling taxonomic annotation.
Path to local mirror of the NCBI Taxonomy database.
Output tree in MUST pseudo-Newick ARB format [default: no].
Output BP/PP support values in MUST pseudo-consense GRP format [default: no]. When specified, this option also generates companion NBS files.
Output tree in FigTree enhanced NEXUS format [default: no].
Output tree metadata for upload and vizualisation in iTOL [default: no].
Print the usual program information
Denis BAURAIN <email@example.com>
Valerian LUPO <firstname.lastname@example.org>
This software is copyright (c) 2013 by University of Liege / Unit of Eukaryotic Phylogenomics / Denis BAURAIN.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.