NAME

DESCRIPTION

first line

the number of species, a space, the number of characters

subsequent lines

ten-character species name, sequence

Here is an example of what the output might look like:

 4 2
 Species_1 AC
 Species_2 AG
 Species_3 GT
 Species_4 GG

To the unparse() function pass a matrix object or a project (whose first matrix will be serialized) as value of the '-phylo' argument. After serialization, any shortened phylip-specific names (which need to be 10 characters long) will have been assigned to the 'phylip_name' slot of set_generic. Example:

 my $phylip_string = unparse(
        -format => 'phylip',
        -phylo  => $matrix,
 );
 for my $seq ( @{ $matrix->get_entities } ) {
    # this returns the shortened name, which is unique to the matrix
        my $phylip_name = $seq->get_generic('phylip_name');
 }

This default behavior enforces strict compliance with the phylip rule for 10-character row names. It is possible to turn this off by passing in the optional "-relaxed" flag with a true value, e.g.:

 my $phylip_string = unparse(
        -format  => 'phylip',
        -phylo   => $matrix,
        -relaxed => 1,
 );

The phylip module is called by the Bio::Phylo::IO object, so look there to learn about parsing and serializing in general.

SEE ALSO

Bio::Phylo::IO

The phylip unparser is called by the Bio::Phylo::IO object. Look there to learn how to create phylip formatted files.

Bio::Phylo::Manual

Also see the manual: Bio::Phylo::Manual and <http://rutgervos.blogspot.com>.

CITATION

Rutger A Vos, Jason Caravas, Klaas Hartmann, Mark A Jensen and Chase Miller, 2011. Bio::Phylo - phyloinformatic analysis using Perl. BMC Bioinformatics 12:63. <http://dx.doi.org/10.1186/1471-2105-12-63>