NAME

Bio::PhyloTastic::PhyloTastic - Perl clients for PhyloTastic

DESCRIPTION

PhyloTastic is an envisioned pipeline for pruning and annotating phylogenetic megatrees. This class is the superclass for several service client classes. The functionality of these client classes is most easily used on the command line, using the phylotastic command line utility that comes with this distribution.

The basic usage is:

$ phylotastic ModuleName <args>

Where ModuleName is part of the package name of one of the client classes (e.g. BabelPhysh). The command line arguments of these classes are somewhat variabel, though the typically take one or more --infile=filename arguments and an --outfile=filename argument. For the other arguments you can consult the usage message for each module as follows:

$ phylotastic ModuleName --help

The full documentation for each module (such as it is), can be viewed like this:

$ phylotastic ModuleName --man

SEE ALSO

The following client classes are currently available.

Bio::PhyloTastic::BabelPhysh

File translation.

Bio::PhyloTastic::DateLife

Divergence date estimation.

Bio::PhyloTastic::PhyleMerge

File merging.

Bio::PhyloTastic::PruneOMatic

Tree pruning.

Bio::PhyloTastic::TaxTractor

Extracts taxon labels from files.

Bio::PhyloTastic::TNRS

Taxonomic name resolution service.

In addition, work is under way to develop Galaxy config files that wrap these classes so they are available from within Galaxy (http://usegalaxy.org). These config files can be found here: https://github.com/phylotastic/arch-galaxy/tree/master/galaxy

METHODS

This distribution can actually also be used within scripts or modules. The basic idea is to invoke run on a service package name, with named arguments (i.e. key value pairs) that match those as required on the command line. The following example of this behaviour writes the input NeXML file $infile as NEXUS to $outfile:

 Bio::PhyloTastic::BabelPhysh->run(
	'-infile'       => $infile,
	'-deserializer' => 'nexml',
	'-outfile'      => $outfile,
	'-serializer'   => 'nexus',
 );

run

The run method is a static method, i.e. called on the package, like so:

Bio::PhyloTastic::ModuleName->run(%args);

The implementation in this superclass does argument checking and input file parsing before it dispatches the parsed data to an implementing method in the child class called _run. That implementing method returns a Bio::Phylo::Project object that is subsequently serialized here.