NAME¶
Bio::SeqIO::agave - AGAVE sequence output stream.
SYNOPSIS¶
It is probably best not to use this object directly, but rather go through the
SeqIO handler system. Go:
$in = Bio::SeqIO->new('-file' => "$file_in",
'-format' => 'EMBL');
$out = Bio::SeqIO->new('-file' => ">$file_out",
'-format' => 'AGAVE');
while (my $seq = $in->next_seq){
$out->write_seq($seq);
}
DESCRIPTION¶
This object can transform Bio::Seq objects to agave xml file and vice-versa. I
(Simon) coded up this module because I needed a parser to extract data from
AGAVE xml to be utitlized by the GenQuire genome annotation system (See
http://www.bioinformatics.org/Genquire).
***NOTE*** At the moment, not all of the tags are implemented. In general, I
followed the output format for the XEMBL project
http://www.ebi.ac.uk/xembl/
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://redmine.open-bio.org/projects/bioperl/
AUTHOR - Simon K. Chan¶
Email:
APPENDIX¶
The rest of the documentation details each of the object methods. Internal
methods are usually preceded with a _
_process¶
Title : _process
Usage : $self->_process
Function : Parses the agave xml file.
Args : None.
Returns : Nothing.
Note : Method(s) that call(s) this method : _initialize
Method(s) that this method calls : _process_sciobj
FIRST/START sub.
_process_sciobj¶
Title : _process_sciobj
Usage : $self->_process_sciobj
Function : Parses the data between the <sciobj></sciobj> tags.
Args : The string that holds the attributes for <sciobj>.
Returns : Data structure holding the values parsed between
the <sciobj></sciobj> tags.
Note : Method(s) that call(s) this method : _process
Method(s) that this method calls :
_helper_store_attribute_list , _process_contig
_process_contig¶
Title : _process_contig
Usage : $self->_process_contig
Function : Parses the data between the <contig></contig> tags.
Args : 2 scalars:
- reference to a scalar holding the line to be parsed.
- scalar holding the attributes for the <contig> tag
to be parsed.
Returns : Data structure holding the values parsed between
the <contig></contig> tags.
Note : Method(s) that call(s) this method : _process_sciobj
Method(s) that this method calls :
_helper_store_attribute_list, _one_tag , _process_fragment_order
_process_fragment_order¶
Title : _process_fragment_order
Usage : $self->_process_fragment_order
Function : Parses the data between the <fragment_order></fragment_order> tags.
Args : 2 scalars:
- reference to a scalar holding the value of the line to be parsed.
- reference to a data structure to store the <fragment_order> data.
Returns : Nothing.
Note : Method(s) that call(s) this method : _process_contig
Method(s) that this method calls :
_helper_store_attribute_list , _process_fragment_orientation
_process_fragment_orientation¶
Title : _process_fragment_orientation
Usage : $self->_process_fragment_orientation
Function : Parses the data between the <fragment_orientation> and
</fragment_orientation> tags.
Args : 2 scalars:
- reference to a scalar holding the value of the line to be parsed.
- reference to a data structure to store the <fragment_orientation> data.
Returns : Nothing.
Note : Method(s) that call(s) this method : _process_fragment_order
Method(s) that this method calls : _helper_store_attribute_list ,
_process_bio_sequence
_process_bio_sequence¶
Title : _process_bio_sequence
Usage : $self->_process_bio_sequence
Function : Parses the data between the <bio_sequence></bio_sequence> tags.
Args : 2 scalars:
- reference to a scalar holding the value of the line to be parsed.
- scalar holding the value of the attributes for <bio_sequence>
Returns : data structure holding the values between <bio_sequence></bio_sequence>
Note : Method(s) that call(s) this method : _process_fragment_orientation
Method(s) that this method calls : _helper_store_attribute_list , _one_tag ,
_question_mark_tag , _star_tag , _process_alt_ids , _process_xrefs ,
_process_sequence_map
_process_xrefs¶
Title : _process_xrefs
Usage : $self->_process_xrefs
Function : Parse the data between the <xrefs></xrefs> tags.
Args : reference to a scalar holding the value of the line to be parsed.
Return : Nothing.
Note : Method(s) that call(s) this method: _process_bio_sequence
Method(s) that this method calls: _one_tag , _process_xref
_process_xref¶
Title : _process_xref
Usage : $self->_process_xref
Function : Parses the data between the <xref></xref> tags.
Args : 2 scalars:
- reference to a scalar holding the value of the line to be parsed.
- reference to a data structure to store the <xref> data.
Returns : Nothing.
Note : Method(s) that call(s) this method : _process_xrefs (note the 's' in 'xrefs')
Method(s) that this method calls : _helper_store_attribute_list , _star_tag
_process_sequence_map¶
Title : _process_sequence_map
Usage : $self->_process_sequence_map
Function : Parses the data between the <sequence_map></sequence_map> tags.
Args : Reference to scalar holding the line to be parsed.
Returns : Data structure that holds the values that were parsed.
Note : Method(s) that call(s) this method : _process_bio_sequence
Method(s) that this method calls : _helper_store_attribute_list ,
_question_mark_tag , _process_annotations
_process_annotations¶
Title : _process_annotations
Usage : $self->_process_annotations
Function : Parse the data between the <annotations></annotations> tags.
Args : Reference to scalar holding the line to be parsed.
Returns : Data structure that holds the values that were parsed.
Note : Method(s) that call(s) this method : _process_sequence_map
Method(s) that this method calls : _process_seq_feature
_process_seq_feature¶
Title : _process_seq_feature
Usage : $self->_process_seq_feature
Function : Parses the data between the <seq_feature></seq_feature> tag.
Args : 2 scalars:
- Reference to scalar holding the line to be parsed.
- Scalar holding the attributes for <seq_feature>.
Returns : Data structure holding the values parsed.
Note : Method(s) that call(s) this method: _process_annotations
Method(s) that this method calls: _helper_store_attribute_list ,
_process_classification , _question_mark_tag , _one_tag , _process_evidence ,
_process_qualifier , _process_seq_feature , _process_related_annot
_process_qualifier¶
Title : _process_qualifier
Usage : $self->_process_qualifier
Function : Parse the data between the <qualifier></qualifier> tags.
Args : 2 scalars:
- reference to a scalar holding the value of the line to be parsed.
- reference to a data structure to store the <qualifer> data.
Returns : Nothing.
Note : Method(s) that call(s) this method : _process_seq_feature
Method(s) that this method calls : _star_tag
_process_classification¶
Title : _process_classification
Usage : $self->_process_classification
Function: Parse the data between the <classification></classification> tags.
Args : 2 scalars:
- reference to a scalar holding the value of the line to be parsed.
- reference to a data structure to store the <qualifer> data.
Returns : Nothing.
Note : Method(s) that call(s) this method: _process_seq_feature
Method(s) that this method calls: _helper_store_attribute_list ,
_question_mark_tag , _star_tag, _process_evidence
_tag_processing_helper¶
Title : _tag_processing_helper
Usage : $self->_tag_processing_helper
Function : Stores the tag value within the data structure.
Also calls _helper_store_attribute_list to store the
attributes and their values in the data structure.
Args : 5 scalars:
- Scalar holding the value of the attributes
- Reference to a data structure to store the data for <$tag_name>
- Scalar holding the tag name.
- Scalar holding the value of the tag.
- Scalar holding the value of either 'star', 'plus',
or 'question mark' which specifies what type of method
called this method.
Returns : Nothing.
Note : Method(s) that call(s) this method:
Method(s) that this method calls: _helper_store_attribute_list
_one_tag¶
Title : _one_tag
Usage : $self->_one_tag
Function : A method to store data from tags that occurs just once.
Args : 2 scalars:
- reference to a scalar holding the value of the line to be parsed.
- reference to a data structure to store the data for <$tag_name>
Returns : Nothing.
Note : Method(s) that call(s) this method : many
Method(s) that this method calls : _tag_processing_helper
_question_mark_tag¶
Title : _question_mark_tag
Usage : $self->_question_mark_tag
Function : Parses values from tags that occurs zero or one time. ie: tag_name?
Args : 3 scalars:
- reference to a scalar holding the value of the line to be parsed.
- reference to a data structure to store the data for <$tag_name>
- scalar holding the name of the tag.
Returns : Nothing.
Note : Method(s) that call(s) this method : many.
Method(s) that this method calls : _tag_processing_helper
_star_tag¶
Title : _star_tag
Usage : $self->_star_tag
Function : Parses values from tags that occur zero or more times. ie: tag_name*
Args : 3 scalars:
- reference to a scalar holding the value of the line to be parsed.
- reference to a data structure to store the data for <$tag_name>
- scalar holding the name of the tag.
Returns : Nothing.
Note : Method(s) that call(s) this method : many.
Method(s) that this method calls : _tag_processing_helper
_plus_tag¶
Title : _plus_tag
Usage : $self->_plus_tag
Function : Handles 'plus' tags (tags that occur one or more times). tag_name+
Args : 3 scalars:
- reference to a scalar holding the value of the line to be parsed.
- reference to a data structure to store the data for <$tag_name>
- scalar holding the name of the tag.
Returns : Nothing.
Note : Method(s) that call(s) this method : many.
Method(s) that this method calls : _star_tag
_helper_store_attribute_list¶
Title : _helper_store_attribute_list
Usage : $self->_helper_store_attribute_list
Function : A helper method used to store the attributes from
the tags into the data structure.
Args : 2 scalars:
- scalar holding the attribute values to be parsed.
- reference to a data structure to store the data between the 2 tags.
Returns : Nothing.
Note : Method(s) that call(s) this method : Many.
Method(s) that this method call(s) : None.
_store_seqs¶
Title : _store_seqs
Usage : $self->_store_seqs
Function : This method is called once in the life time of the script.
It stores the data parsed from the agave xml file into
the Bio::Seq object.
Args : None.
Returns : Nothing.
Note : Method(s) that call(s) this method : next_seq
Method(s) that this method calls : None.
next_seq¶
Title : next_seq
Usage : $seq = $stream->next_seq()
Function : Returns the next sequence in the stream.
Args : None.
Returns : Bio::Seq object
Method is called from the script. Method(s) that this method calls: _store_seqs
(only once throughout the life time of script execution).
next_primary_seq¶
Title : next_primary_seq
Usage : $seq = $stream->next_primary_seq()
Function: returns the next primary sequence (ie no seq_features) in the stream
Returns : Bio::PrimarySeq object
Args : NONE
write_seq¶
Title : write_seq
Usage : Not Yet Implemented! $stream->write_seq(@seq)
Function: writes the $seq object into the stream
Returns : 1 for success and 0 for error
Args : Bio::Seq object
_write_each_record¶
Title : _write_each_record
Usage : $agave->_write_each_record( $seqI )
Function: change data into agave format
Returns : NONE
Args : Bio::SeqI object
_write_seqfeature¶
Usage : $agave->_write_each_record( $seqfeature, $write )
Function: change seeqfeature data into agave format
Returns : NONE
Args : Bio::SeqFeature object and XML::writer object
_filehandle¶
Title : _filehandle
Usage : $obj->_filehandle($newval)
Function:
Example :
Returns : value of _filehandle
Args : newvalue (optional)
throw¶
Title : throw
Usage : $self->throw;
Function : Throw's error message. Calls SeqIO's throw method.
Args : Array of string(s), holding error message(s).
Returns : Nothing.
Note : Method(s) that call(s) this method: many.
Method(s) that this method calls: Bio::SeqIO's throw method.