GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  BIO::NEXMLIO (3)

.ds Aq ’

NAME

Bio::NexmlIO - stream handler for NeXML documents

CONTENTS

SYNOPSIS



    #Instantiate a Bio::Nexml object and link it to a file
    my $in_nexml = Bio::Nexml->new(-file => nexml_doc.xml, -format => Nexml);

        #Read in some data
        my $bptree1 = $in_nexml->next_tree();
        my $bpaln1  = $in_nexml->next_aln();
        my $bpseq1  = $in_nexml->next_seq();

        #Use/manipulate data
        ...

        #Write data to nexml file
        my $out_nexml = Bio::Nexml->new(-file => >new_nexml_doc.xml, -format => Nexml);
        $out_nexml->to_xml();



DESCRIPTION

Bio::NexmlIO is an I/O handler for a NeXML document. A NeXML document can represent three different data types: simple sequences, alignments, and trees. NexmlIO has four main methods next_tree, next_seq, next_aln, and write. NexmlIO returns bioperl seq, tree, and aln objects which can be manipulated then passed to the write method of a new NexmlIO instance to allow the creation of a NeXML document.

Each bioperl object contains all the information necessary to recreate a Bio::Phylo::Taxa object, so each time a bioperl object is converted to a biophylo object, the bioperl object is checked to see if its associated taxa has already been created (against a hash using the NexmlIO_ID and Taxa_ID to create a unique string). If not, it is created; if so, that taxa object is used to link the Bio::Phylo tree or matrix.

For more information on the NeXML format, see <http://www.nexml.org>.

FEEDBACK

    Mailing Lists

User feedback is an integral part of the evolution of this and other Bioperl modules. Send your comments and suggestions preferably to one of the Bioperl mailing lists.

Your participation is much appreciated.



  bioperl-l@bioperl.org                  - General discussion
  http://bioperl.org/wiki/Mailing_lists  - About the mailing lists



    Support

Please direct usage questions or support issues to the mailing list:

bioperl-l@bioperl.org

rather than to the module maintainer directly. Many experienced and reponsive experts will be able look at the problem and quickly address it. Please include a thorough description of the problem with code and data examples if at all possible.

    Reporting Bugs

Report bugs to the Bioperl bug tracking system to help us keep track the bugs and their resolution. Bug reports can be submitted via the web:



  https://github.com/bioperl/bioperl-live/issues



AUTHOR - Chase Miller

Email chmille4@gmail.com

CONTRIBUTORS

Mark A. Jensen, maj -at- fortinbras -dot- com

APPENDIX

The rest of the documentation details each of the object methods. Internal methods are usually preceded with a _

CONSTRUCTOR

    new



 Title   : new
 Usage   : my $in_nexmlIO = Bio::NexmlIO->new(-file => data.nexml.xml);
 Function: Creates a L<Bio::NexmlIO> object linked to a stream
 Returns : a L<Bio::NexmlIO> object
 Args    : file name

 See L<Bio::Root::IO>



    doc



 Title   : doc
 Usage   : my $nexml_doc = $in_nexmlIO->doc();
 Function: returns a L<Bio::Phylo::Project> object that contains all the Bio::Phylo data objects parsed from the stream
 Returns : a L<Bio::Phylo::Project> object
 Args    : none



ITERATORS

    next_tree



 Title   : next_tree
 Usage   : $tree = $stream->next_tree
 Function: Reads the next tree object from the stream and returns it.
 Returns : a L<Bio::Tree::Tree> object
 Args    : none



See Bio::Root::IO, Bio::Tree::Tree

    next_seq



 Title   : next_seq
 Usage   : $seq = $stream->next_seq
 Function: Reads the next seq object from the stream and returns it.
 Returns : a L<Bio::Seq> object
 Args    : none



See Bio::Root::IO, Bio::Seq

    next_aln



 Title   : next_aln
 Usage   : $aln = $stream->next_aln
 Function: Reads the next aln object from the stream and returns it.
 Returns : a L<Bio::SimpleAlign> object
 Args    : none



See Bio::Root::IO, Bio::SimpleAlign

    rewind_seq



 Title   : rewind_seq
 Usage   : $stream->rewind_seq
 Function: Resets the stream for seqs
 Returns : none
 Args    : none



See Bio::Root::IO, Bio::Seq

    rewind_aln



 Title   : rewind_aln
 Usage   : $stream->rewind_aln
 Function: Resets the stream for alns
 Returns : none
 Args    : none



See Bio::Root::IO, Bio::Simple::Align

    rewind_tree



 Title   : rewind_tree
 Usage   : $stream->rewind_tree
 Function: Resets the stream for trees
 Returns : none
 Args    : none



See Bio::Root::IO, Bio::tree::tree

    write



 Title   : write
 Usage   : $stream->write(-alns => $alns,-seqs => $seqs,-trees => $trees)
 Function: converts BioPerl seq, tree, and aln objects into Bio::Phylo
           seq, tree, and aln objects, constructs a Bio::Phylo::Project
           object made up of the newly created Bio::Phylo objects, and
           writes the Bio::Phylo:Project object to the stream as a valid
           nexml document
 Returns : none
 Args    : \@L<Bio::Seq>, \@L<Bio::SimpleAlign>, \@L<Bio::Tree::Tree>



See Bio::Root::IO, Bio::tree::tree, Bio::Seq, Bio::SimpleAlign

    extract_seqs



 Title   : extract_seqs
 Usage   : $nexmlIO->extract_seqs(-file => ">$outfile", -format => $format)
 Function: converts BioPerl seqs stored in the NexmlIO object into the provided
                   format and writes it to the provided file. Uses L<Bio::SeqIO> to do
                   the conversion and writing.
 Returns : none
 Args    : file to write to, format to be converted to



See Bio::Seq, Bio::SeqIO

    extract_alns



 Title   : extract_alns
 Usage   : $nexmlIO->extract_alns(-file => ">$outfile", -format => $format)
 Function: converts BioPerl alns stored in the NexmlIO object into the provided
                   format and writes it to the provided file. Uses L<Bio::AlignIO> to do
                   the conversion and writing.
 Returns : none
 Args    : file to write to, format to be converted to



See Bio::SimpleAlign, Bio::AlignIO

    extract_trees



 Title   : extract_trees
 Usage   : $nexmlIO->extract_trees(-file => ">$outfile", -format => $format)
 Function: converts BioPerl trees stored in the NexmlIO object into the provided
                   format and writes it to the provided file. Uses L<Bio::TreeIO> to do
                   the conversion and writing.
 Returns : none
 Args    : file to write to, format to be converted to



See Bio::Tree::Tree, Bio::TreeIO

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 BIO::NEXMLIO (3) 2016-04-05

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.