| 1 | #----------------------------------------------------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 2 | # | ||||||||||||||||||||||||||||||||||||||||||
| 3 | # BioPerl module Bio::Search::HSP::PsiBlastHSP | ||||||||||||||||||||||||||||||||||||||||||
| 4 | # | ||||||||||||||||||||||||||||||||||||||||||
| 5 | # (This module was originally called Bio::Tools::Blast::HSP) | ||||||||||||||||||||||||||||||||||||||||||
| 6 | # | ||||||||||||||||||||||||||||||||||||||||||
| 7 | # Please direct questions and support issues to <bioperl-l@bioperl.org> | ||||||||||||||||||||||||||||||||||||||||||
| 8 | # | ||||||||||||||||||||||||||||||||||||||||||
| 9 | # Cared for by Steve Chervitz <sac@bioperl.org> | ||||||||||||||||||||||||||||||||||||||||||
| 10 | # | ||||||||||||||||||||||||||||||||||||||||||
| 11 | # You may distribute this module under the same terms as perl itself | ||||||||||||||||||||||||||||||||||||||||||
| 12 | #----------------------------------------------------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 13 | |||||||||||||||||||||||||||||||||||||||||||
| 14 | ## POD Documentation: | ||||||||||||||||||||||||||||||||||||||||||
| 15 | |||||||||||||||||||||||||||||||||||||||||||
| 16 | =head1 NAME | ||||||||||||||||||||||||||||||||||||||||||
| 17 | |||||||||||||||||||||||||||||||||||||||||||
| 18 | Bio::Search::HSP::PsiBlastHSP - Bioperl BLAST High-Scoring Pair object | ||||||||||||||||||||||||||||||||||||||||||
| 19 | |||||||||||||||||||||||||||||||||||||||||||
| 20 | =head1 SYNOPSIS | ||||||||||||||||||||||||||||||||||||||||||
| 21 | |||||||||||||||||||||||||||||||||||||||||||
| 22 | See L<Bio::Search::Hit::BlastHit>. | ||||||||||||||||||||||||||||||||||||||||||
| 23 | |||||||||||||||||||||||||||||||||||||||||||
| 24 | =head1 DESCRIPTION | ||||||||||||||||||||||||||||||||||||||||||
| 25 | |||||||||||||||||||||||||||||||||||||||||||
| 26 | A Bio::Search::HSP::PsiBlastHSP object provides an interface to data | ||||||||||||||||||||||||||||||||||||||||||
| 27 | obtained in a single alignment section of a Blast report (known as a | ||||||||||||||||||||||||||||||||||||||||||
| 28 | "High-scoring Segment Pair"). This is essentially a pairwise | ||||||||||||||||||||||||||||||||||||||||||
| 29 | alignment with score information. | ||||||||||||||||||||||||||||||||||||||||||
| 30 | |||||||||||||||||||||||||||||||||||||||||||
| 31 | PsiBlastHSP objects are accessed via L<Bio::Search::Hit::BlastHit> | ||||||||||||||||||||||||||||||||||||||||||
| 32 | objects after parsing a BLAST report using the L<Bio::SearchIO> | ||||||||||||||||||||||||||||||||||||||||||
| 33 | system. | ||||||||||||||||||||||||||||||||||||||||||
| 34 | |||||||||||||||||||||||||||||||||||||||||||
| 35 | The construction of PsiBlastHSP objects is performed by | ||||||||||||||||||||||||||||||||||||||||||
| 36 | Bio::Factory::BlastHitFactory in a process that is | ||||||||||||||||||||||||||||||||||||||||||
| 37 | orchestrated by the Blast parser (L<Bio::SearchIO::psiblast>). | ||||||||||||||||||||||||||||||||||||||||||
| 38 | The resulting PsiBlastHSPs are then accessed via | ||||||||||||||||||||||||||||||||||||||||||
| 39 | L<Bio::Search::Hit::BlastHit>). Therefore, you do not need to | ||||||||||||||||||||||||||||||||||||||||||
| 40 | use L<Bio::Search::HSP::PsiBlastHSP>) directly. If you need to construct | ||||||||||||||||||||||||||||||||||||||||||
| 41 | PsiBlastHSPs directly, see the new() function for details. | ||||||||||||||||||||||||||||||||||||||||||
| 42 | |||||||||||||||||||||||||||||||||||||||||||
| 43 | For L<Bio::SearchIO> BLAST parsing usage examples, see the | ||||||||||||||||||||||||||||||||||||||||||
| 44 | C<examples/search-blast> directory of the Bioperl distribution. | ||||||||||||||||||||||||||||||||||||||||||
| 45 | |||||||||||||||||||||||||||||||||||||||||||
| 46 | |||||||||||||||||||||||||||||||||||||||||||
| 47 | =head2 Start and End coordinates | ||||||||||||||||||||||||||||||||||||||||||
| 48 | |||||||||||||||||||||||||||||||||||||||||||
| 49 | Sequence endpoints are swapped so that start is always less than | ||||||||||||||||||||||||||||||||||||||||||
| 50 | end. This affects For TBLASTN/X hits on the minus strand. Strand | ||||||||||||||||||||||||||||||||||||||||||
| 51 | information can be recovered using the strand() method. This | ||||||||||||||||||||||||||||||||||||||||||
| 52 | normalization step is standard Bioperl practice. It also facilitates | ||||||||||||||||||||||||||||||||||||||||||
| 53 | use of range information by methods such as match(). | ||||||||||||||||||||||||||||||||||||||||||
| 54 | |||||||||||||||||||||||||||||||||||||||||||
| 55 | =over 1 | ||||||||||||||||||||||||||||||||||||||||||
| 56 | |||||||||||||||||||||||||||||||||||||||||||
| 57 | =item * Supports BLAST versions 1.x and 2.x, gapped and ungapped. | ||||||||||||||||||||||||||||||||||||||||||
| 58 | |||||||||||||||||||||||||||||||||||||||||||
| 59 | =back | ||||||||||||||||||||||||||||||||||||||||||
| 60 | |||||||||||||||||||||||||||||||||||||||||||
| 61 | Bio::Search::HSP::PsiBlastHSP.pm has the ability to extract a list of all | ||||||||||||||||||||||||||||||||||||||||||
| 62 | residue indices for identical and conservative matches along both | ||||||||||||||||||||||||||||||||||||||||||
| 63 | query and sbjct sequences. Since this degree of detail is not always | ||||||||||||||||||||||||||||||||||||||||||
| 64 | needed, this behavior does not occur during construction of the PsiBlastHSP | ||||||||||||||||||||||||||||||||||||||||||
| 65 | object. These data will automatically be collected as necessary as | ||||||||||||||||||||||||||||||||||||||||||
| 66 | the PsiBlastHSP.pm object is used. | ||||||||||||||||||||||||||||||||||||||||||
| 67 | |||||||||||||||||||||||||||||||||||||||||||
| 68 | =head1 DEPENDENCIES | ||||||||||||||||||||||||||||||||||||||||||
| 69 | |||||||||||||||||||||||||||||||||||||||||||
| 70 | Bio::Search::HSP::PsiBlastHSP.pm is a concrete class that inherits from | ||||||||||||||||||||||||||||||||||||||||||
| 71 | L<Bio::SeqFeature::SimilarityPair> and L<Bio::Search::HSP::HSPI>. | ||||||||||||||||||||||||||||||||||||||||||
| 72 | L<Bio::Seq> and L<Bio::SimpleAlign> are employed for creating | ||||||||||||||||||||||||||||||||||||||||||
| 73 | sequence and alignment objects, respectively. | ||||||||||||||||||||||||||||||||||||||||||
| 74 | |||||||||||||||||||||||||||||||||||||||||||
| 75 | =head2 Relationship to L<Bio::SimpleAlign> and L<Bio::Seq> | ||||||||||||||||||||||||||||||||||||||||||
| 76 | |||||||||||||||||||||||||||||||||||||||||||
| 77 | PsiBlastHSP.pm can provide the query or sbjct sequence as a L<Bio::Seq> | ||||||||||||||||||||||||||||||||||||||||||
| 78 | object via the L<seq()|seq> method. The PsiBlastHSP.pm object can also create a | ||||||||||||||||||||||||||||||||||||||||||
| 79 | two-sequence L<Bio::SimpleAlign> alignment object using the the query | ||||||||||||||||||||||||||||||||||||||||||
| 80 | and sbjct sequences via the L<get_aln()|get_aln> method. Creation of alignment | ||||||||||||||||||||||||||||||||||||||||||
| 81 | objects is not automatic when constructing the PsiBlastHSP.pm object since | ||||||||||||||||||||||||||||||||||||||||||
| 82 | this level of functionality is not always required and would generate | ||||||||||||||||||||||||||||||||||||||||||
| 83 | a lot of extra overhead when crunching many reports. | ||||||||||||||||||||||||||||||||||||||||||
| 84 | |||||||||||||||||||||||||||||||||||||||||||
| 85 | |||||||||||||||||||||||||||||||||||||||||||
| 86 | =head1 FEEDBACK | ||||||||||||||||||||||||||||||||||||||||||
| 87 | |||||||||||||||||||||||||||||||||||||||||||
| 88 | =head2 Mailing Lists | ||||||||||||||||||||||||||||||||||||||||||
| 89 | |||||||||||||||||||||||||||||||||||||||||||
| 90 | User feedback is an integral part of the evolution of this and other | ||||||||||||||||||||||||||||||||||||||||||
| 91 | Bioperl modules. Send your comments and suggestions preferably to one | ||||||||||||||||||||||||||||||||||||||||||
| 92 | of the Bioperl mailing lists. Your participation is much appreciated. | ||||||||||||||||||||||||||||||||||||||||||
| 93 | |||||||||||||||||||||||||||||||||||||||||||
| 94 | bioperl-l@bioperl.org - General discussion | ||||||||||||||||||||||||||||||||||||||||||
| 95 | http://bioperl.org/wiki/Mailing_lists - About the mailing lists | ||||||||||||||||||||||||||||||||||||||||||
| 96 | |||||||||||||||||||||||||||||||||||||||||||
| 97 | =head2 Support | ||||||||||||||||||||||||||||||||||||||||||
| 98 | |||||||||||||||||||||||||||||||||||||||||||
| 99 | Please direct usage questions or support issues to the mailing list: | ||||||||||||||||||||||||||||||||||||||||||
| 100 | |||||||||||||||||||||||||||||||||||||||||||
| 101 | I<bioperl-l@bioperl.org> | ||||||||||||||||||||||||||||||||||||||||||
| 102 | |||||||||||||||||||||||||||||||||||||||||||
| 103 | rather than to the module maintainer directly. Many experienced and | ||||||||||||||||||||||||||||||||||||||||||
| 104 | reponsive experts will be able look at the problem and quickly | ||||||||||||||||||||||||||||||||||||||||||
| 105 | address it. Please include a thorough description of the problem | ||||||||||||||||||||||||||||||||||||||||||
| 106 | with code and data examples if at all possible. | ||||||||||||||||||||||||||||||||||||||||||
| 107 | |||||||||||||||||||||||||||||||||||||||||||
| 108 | =head2 Reporting Bugs | ||||||||||||||||||||||||||||||||||||||||||
| 109 | |||||||||||||||||||||||||||||||||||||||||||
| 110 | Report bugs to the Bioperl bug tracking system to help us keep track | ||||||||||||||||||||||||||||||||||||||||||
| 111 | the bugs and their resolution. Bug reports can be submitted via the | ||||||||||||||||||||||||||||||||||||||||||
| 112 | web: | ||||||||||||||||||||||||||||||||||||||||||
| 113 | |||||||||||||||||||||||||||||||||||||||||||
| 114 | https://github.com/bioperl/bioperl-live/issues | ||||||||||||||||||||||||||||||||||||||||||
| 115 | |||||||||||||||||||||||||||||||||||||||||||
| 116 | =head1 AUTHOR | ||||||||||||||||||||||||||||||||||||||||||
| 117 | |||||||||||||||||||||||||||||||||||||||||||
| 118 | Steve Chervitz E<lt>sac-at-bioperl.orgE<gt> | ||||||||||||||||||||||||||||||||||||||||||
| 119 | |||||||||||||||||||||||||||||||||||||||||||
| 120 | See L<the FEEDBACK section | FEEDBACK> for where to send bug reports and comments. | ||||||||||||||||||||||||||||||||||||||||||
| 121 | |||||||||||||||||||||||||||||||||||||||||||
| 122 | =head1 ACKNOWLEDGEMENTS | ||||||||||||||||||||||||||||||||||||||||||
| 123 | |||||||||||||||||||||||||||||||||||||||||||
| 124 | This software was originally developed in the Department of Genetics | ||||||||||||||||||||||||||||||||||||||||||
| 125 | at Stanford University. I would also like to acknowledge my | ||||||||||||||||||||||||||||||||||||||||||
| 126 | colleagues at Affymetrix for useful feedback. | ||||||||||||||||||||||||||||||||||||||||||
| 127 | |||||||||||||||||||||||||||||||||||||||||||
| 128 | =head1 SEE ALSO | ||||||||||||||||||||||||||||||||||||||||||
| 129 | |||||||||||||||||||||||||||||||||||||||||||
| 130 | Bio::Search::Hit::BlastHit.pm - Blast hit object. | ||||||||||||||||||||||||||||||||||||||||||
| 131 | Bio::Search::Result::BlastResult.pm - Blast Result object. | ||||||||||||||||||||||||||||||||||||||||||
| 132 | Bio::Seq.pm - Biosequence object | ||||||||||||||||||||||||||||||||||||||||||
| 133 | |||||||||||||||||||||||||||||||||||||||||||
| 134 | =head2 Links: | ||||||||||||||||||||||||||||||||||||||||||
| 135 | |||||||||||||||||||||||||||||||||||||||||||
| 136 | http://bio.perl.org/ - Bioperl Project Homepage | ||||||||||||||||||||||||||||||||||||||||||
| 137 | |||||||||||||||||||||||||||||||||||||||||||
| 138 | =head1 COPYRIGHT | ||||||||||||||||||||||||||||||||||||||||||
| 139 | |||||||||||||||||||||||||||||||||||||||||||
| 140 | Copyright (c) 1996-2001 Steve Chervitz. All Rights Reserved. | ||||||||||||||||||||||||||||||||||||||||||
| 141 | |||||||||||||||||||||||||||||||||||||||||||
| 142 | =head1 DISCLAIMER | ||||||||||||||||||||||||||||||||||||||||||
| 143 | |||||||||||||||||||||||||||||||||||||||||||
| 144 | This software is provided "as is" without warranty of any kind. | ||||||||||||||||||||||||||||||||||||||||||
| 145 | |||||||||||||||||||||||||||||||||||||||||||
| 146 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 147 | |||||||||||||||||||||||||||||||||||||||||||
| 148 | |||||||||||||||||||||||||||||||||||||||||||
| 149 | # END of main POD documentation. | ||||||||||||||||||||||||||||||||||||||||||
| 150 | |||||||||||||||||||||||||||||||||||||||||||
| 151 | =head1 APPENDIX | ||||||||||||||||||||||||||||||||||||||||||
| 152 | |||||||||||||||||||||||||||||||||||||||||||
| 153 | The rest of the documentation details each of the object methods. | ||||||||||||||||||||||||||||||||||||||||||
| 154 | Internal methods are usually preceded with a _ | ||||||||||||||||||||||||||||||||||||||||||
| 155 | |||||||||||||||||||||||||||||||||||||||||||
| 156 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 157 | |||||||||||||||||||||||||||||||||||||||||||
| 158 | # Let the code begin... | ||||||||||||||||||||||||||||||||||||||||||
| 159 | |||||||||||||||||||||||||||||||||||||||||||
| 160 | package Bio::Search::HSP::PsiBlastHSP; | ||||||||||||||||||||||||||||||||||||||||||
| 161 | 1 | $Bio::Search::HSP::PsiBlastHSP::VERSION = '1.7.8'; | |||||||||||||||||||||||||||||||||||||||||
| 162 | 1 | ▶ | use strict; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 163 | 1 | ▶ | use Bio::SeqFeature::Similarity; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 164 | |||||||||||||||||||||||||||||||||||||||||||
| 165 | 1 | ▶ | use vars qw($GAP_SYMBOL %STRAND_SYMBOL); | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 166 | |||||||||||||||||||||||||||||||||||||||||||
| 167 | use overload | ||||||||||||||||||||||||||||||||||||||||||
| 168 | 1 | ▶ | '""' => \&to_string; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 169 | |||||||||||||||||||||||||||||||||||||||||||
| 170 | 1 | ▶ | use base qw(Bio::SeqFeature::SimilarityPair Bio::Search::HSP::HSPI); | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 171 | |||||||||||||||||||||||||||||||||||||||||||
| 172 | 1 | $GAP_SYMBOL = '-'; # Need a more general way to handle gap symbols. | |||||||||||||||||||||||||||||||||||||||||
| 173 | 1 | %STRAND_SYMBOL = ('Plus' => 1, 'Minus' => -1 ); | |||||||||||||||||||||||||||||||||||||||||
| 174 | |||||||||||||||||||||||||||||||||||||||||||
| 175 | |||||||||||||||||||||||||||||||||||||||||||
| 176 | =head2 new | ||||||||||||||||||||||||||||||||||||||||||
| 177 | |||||||||||||||||||||||||||||||||||||||||||
| 178 | Usage : $hsp = Bio::Search::HSP::PsiBlastHSP->new( %named_params ); | ||||||||||||||||||||||||||||||||||||||||||
| 179 | : Bio::Search::HSP::PsiBlastHSP.pm objects are constructed | ||||||||||||||||||||||||||||||||||||||||||
| 180 | : automatically by Bio::SearchIO::BlastHitFactory.pm, | ||||||||||||||||||||||||||||||||||||||||||
| 181 | : so there is no need for direct instantiation. | ||||||||||||||||||||||||||||||||||||||||||
| 182 | Purpose : Constructs a new PsiBlastHSP object and Initializes key variables | ||||||||||||||||||||||||||||||||||||||||||
| 183 | : for the HSP. | ||||||||||||||||||||||||||||||||||||||||||
| 184 | Returns : A Bio::Search::HSP::PsiBlastHSP object | ||||||||||||||||||||||||||||||||||||||||||
| 185 | Argument : Named parameters: | ||||||||||||||||||||||||||||||||||||||||||
| 186 | : Parameter keys are case-insensitive. | ||||||||||||||||||||||||||||||||||||||||||
| 187 | : -RAW_DATA => array ref containing raw BLAST report data for | ||||||||||||||||||||||||||||||||||||||||||
| 188 | : for a single HSP. This includes all lines | ||||||||||||||||||||||||||||||||||||||||||
| 189 | : of the HSP alignment from a traditional BLAST | ||||||||||||||||||||||||||||||||||||||||||
| 190 | or PSI-BLAST (non-XML) report, | ||||||||||||||||||||||||||||||||||||||||||
| 191 | : -RANK => integer (1..n). | ||||||||||||||||||||||||||||||||||||||||||
| 192 | : -PROGRAM => string ('TBLASTN', 'BLASTP', etc.). | ||||||||||||||||||||||||||||||||||||||||||
| 193 | : -QUERY_NAME => string, id of query sequence | ||||||||||||||||||||||||||||||||||||||||||
| 194 | : -HIT_NAME => string, id of hit sequence | ||||||||||||||||||||||||||||||||||||||||||
| 195 | : | ||||||||||||||||||||||||||||||||||||||||||
| 196 | Comments : Having the raw data allows this object to do lazy parsing of | ||||||||||||||||||||||||||||||||||||||||||
| 197 | : the raw HSP data (i.e., not parsed until needed). | ||||||||||||||||||||||||||||||||||||||||||
| 198 | : | ||||||||||||||||||||||||||||||||||||||||||
| 199 | : Note that there is a fair amount of basic parsing that is | ||||||||||||||||||||||||||||||||||||||||||
| 200 | : currently performed in this module that would be more appropriate | ||||||||||||||||||||||||||||||||||||||||||
| 201 | : to do within a separate factory object. | ||||||||||||||||||||||||||||||||||||||||||
| 202 | : This parsing code will likely be relocated and more initialization | ||||||||||||||||||||||||||||||||||||||||||
| 203 | : parameters will be added to new(). | ||||||||||||||||||||||||||||||||||||||||||
| 204 | : | ||||||||||||||||||||||||||||||||||||||||||
| 205 | See Also : L<Bio::SeqFeature::SimilarityPair::new()>, L<Bio::SeqFeature::Similarity::new()> | ||||||||||||||||||||||||||||||||||||||||||
| 206 | |||||||||||||||||||||||||||||||||||||||||||
| 207 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 208 | |||||||||||||||||||||||||||||||||||||||||||
| 209 | #---------------- | ||||||||||||||||||||||||||||||||||||||||||
| 210 | 0 | ▶ | sub new { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
new: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 211 | #---------------- | ||||||||||||||||||||||||||||||||||||||||||
| 212 | 0 | my ($class, @args ) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 213 | |||||||||||||||||||||||||||||||||||||||||||
| 214 | 0 | my $self = $class->SUPER::new( @args ); | |||||||||||||||||||||||||||||||||||||||||
| 215 | # Initialize placeholders | ||||||||||||||||||||||||||||||||||||||||||
| 216 | 0 | $self->{'_queryGaps'} = $self->{'_sbjctGaps'} = 0; | |||||||||||||||||||||||||||||||||||||||||
| 217 | 0 | my ($raw_data, $qname, $hname, $qlen, $hlen); | |||||||||||||||||||||||||||||||||||||||||
| 218 | |||||||||||||||||||||||||||||||||||||||||||
| 219 | 0 | ($self->{'_prog'}, $self->{'_rank'}, $raw_data, | |||||||||||||||||||||||||||||||||||||||||
| 220 | $qname, $hname) = | ||||||||||||||||||||||||||||||||||||||||||
| 221 | $self->_rearrange([qw( PROGRAM | ||||||||||||||||||||||||||||||||||||||||||
| 222 | RANK | ||||||||||||||||||||||||||||||||||||||||||
| 223 | RAW_DATA | ||||||||||||||||||||||||||||||||||||||||||
| 224 | QUERY_NAME | ||||||||||||||||||||||||||||||||||||||||||
| 225 | HIT_NAME | ||||||||||||||||||||||||||||||||||||||||||
| 226 | )], @args ); | ||||||||||||||||||||||||||||||||||||||||||
| 227 | |||||||||||||||||||||||||||||||||||||||||||
| 228 | # _set_data() does a fair amount of parsing. | ||||||||||||||||||||||||||||||||||||||||||
| 229 | # This will likely change (see comment above.) | ||||||||||||||||||||||||||||||||||||||||||
| 230 | 0 | $self->_set_data( @{$raw_data} ); | |||||||||||||||||||||||||||||||||||||||||
| 231 | # Store the aligned query as sequence feature | ||||||||||||||||||||||||||||||||||||||||||
| 232 | 0 | my ($qb, $hb) = ($self->start()); | |||||||||||||||||||||||||||||||||||||||||
| 233 | 0 | my ($qe, $he) = ($self->end()); | |||||||||||||||||||||||||||||||||||||||||
| 234 | 0 | my ($qs, $hs) = ($self->strand()); | |||||||||||||||||||||||||||||||||||||||||
| 235 | 0 | my ($qf,$hf) = ($self->query->frame(), | |||||||||||||||||||||||||||||||||||||||||
| 236 | $self->hit->frame); | ||||||||||||||||||||||||||||||||||||||||||
| 237 | |||||||||||||||||||||||||||||||||||||||||||
| 238 | $self->query( Bio::SeqFeature::Similarity->new (-start =>$qb, | ||||||||||||||||||||||||||||||||||||||||||
| 239 | -end =>$qe, | ||||||||||||||||||||||||||||||||||||||||||
| 240 | -strand =>$qs, | ||||||||||||||||||||||||||||||||||||||||||
| 241 | -bits =>$self->bits, | ||||||||||||||||||||||||||||||||||||||||||
| 242 | -score =>$self->score, | ||||||||||||||||||||||||||||||||||||||||||
| 243 | -frame =>$qf, | ||||||||||||||||||||||||||||||||||||||||||
| 244 | -seq_id => $qname, | ||||||||||||||||||||||||||||||||||||||||||
| 245 | 0 | -source =>$self->{'_prog'} )); | |||||||||||||||||||||||||||||||||||||||||
| 246 | |||||||||||||||||||||||||||||||||||||||||||
| 247 | $self->hit( Bio::SeqFeature::Similarity->new (-start =>$hb, | ||||||||||||||||||||||||||||||||||||||||||
| 248 | -end =>$he, | ||||||||||||||||||||||||||||||||||||||||||
| 249 | -strand =>$hs, | ||||||||||||||||||||||||||||||||||||||||||
| 250 | -bits =>$self->bits, | ||||||||||||||||||||||||||||||||||||||||||
| 251 | -score =>$self->score, | ||||||||||||||||||||||||||||||||||||||||||
| 252 | -frame =>$hf, | ||||||||||||||||||||||||||||||||||||||||||
| 253 | -seq_id => $hname, | ||||||||||||||||||||||||||||||||||||||||||
| 254 | 0 | -source =>$self->{'_prog'} )); | |||||||||||||||||||||||||||||||||||||||||
| 255 | |||||||||||||||||||||||||||||||||||||||||||
| 256 | # set lengths | ||||||||||||||||||||||||||||||||||||||||||
| 257 | 0 | $self->query->seqlength($qlen); # query | |||||||||||||||||||||||||||||||||||||||||
| 258 | 0 | $self->hit->seqlength($hlen); # subject | |||||||||||||||||||||||||||||||||||||||||
| 259 | |||||||||||||||||||||||||||||||||||||||||||
| 260 | 0 | $self->query->frac_identical($self->frac_identical('query')); | |||||||||||||||||||||||||||||||||||||||||
| 261 | 0 | $self->hit->frac_identical($self->frac_identical('hit')); | |||||||||||||||||||||||||||||||||||||||||
| 262 | 0 | return $self; | |||||||||||||||||||||||||||||||||||||||||
| 263 | } | ||||||||||||||||||||||||||||||||||||||||||
| 264 | |||||||||||||||||||||||||||||||||||||||||||
| 265 | #sub DESTROY { | ||||||||||||||||||||||||||||||||||||||||||
| 266 | # my $self = shift; | ||||||||||||||||||||||||||||||||||||||||||
| 267 | # #print STDERR "--->DESTROYING $self\n"; | ||||||||||||||||||||||||||||||||||||||||||
| 268 | #} | ||||||||||||||||||||||||||||||||||||||||||
| 269 | |||||||||||||||||||||||||||||||||||||||||||
| 270 | |||||||||||||||||||||||||||||||||||||||||||
| 271 | # Title : _id_str; | ||||||||||||||||||||||||||||||||||||||||||
| 272 | # Purpose : Intended for internal use only to provide a string for use | ||||||||||||||||||||||||||||||||||||||||||
| 273 | # within exception messages to help users figure out which | ||||||||||||||||||||||||||||||||||||||||||
| 274 | # query/hit caused the problem. | ||||||||||||||||||||||||||||||||||||||||||
| 275 | # Returns : Short string with name of query and hit seq | ||||||||||||||||||||||||||||||||||||||||||
| 276 | 0 | ▶ | sub _id_str { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
_id_str: not called CC=2 SCAR=17.9
| |||||||||||||||||||||||||||||||||||||||||||
| 277 | 0 | my $self = shift; | |||||||||||||||||||||||||||||||||||||||||
| 278 | 0 | ▶ | if( not defined $self->{'_id_str'}) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 279 | 0 | my $qname = $self->query->seqname; | |||||||||||||||||||||||||||||||||||||||||
| 280 | 0 | my $hname = $self->hit->seqname; | |||||||||||||||||||||||||||||||||||||||||
| 281 | 0 | $self->{'_id_str'} = "QUERY=\"$qname\" HIT=\"$hname\""; | |||||||||||||||||||||||||||||||||||||||||
| 282 | } | ||||||||||||||||||||||||||||||||||||||||||
| 283 | 0 | return $self->{'_id_str'}; | |||||||||||||||||||||||||||||||||||||||||
| 284 | } | ||||||||||||||||||||||||||||||||||||||||||
| 285 | |||||||||||||||||||||||||||||||||||||||||||
| 286 | #================================================= | ||||||||||||||||||||||||||||||||||||||||||
| 287 | # Begin Bio::Search::HSP::HSPI implementation | ||||||||||||||||||||||||||||||||||||||||||
| 288 | #================================================= | ||||||||||||||||||||||||||||||||||||||||||
| 289 | |||||||||||||||||||||||||||||||||||||||||||
| 290 | =head2 algorithm | ||||||||||||||||||||||||||||||||||||||||||
| 291 | |||||||||||||||||||||||||||||||||||||||||||
| 292 | Title : algorithm | ||||||||||||||||||||||||||||||||||||||||||
| 293 | Usage : $alg = $hsp->algorithm(); | ||||||||||||||||||||||||||||||||||||||||||
| 294 | Function: Gets the algorithm specification that was used to obtain the hsp | ||||||||||||||||||||||||||||||||||||||||||
| 295 | For BLAST, the algorithm denotes what type of sequence was aligned | ||||||||||||||||||||||||||||||||||||||||||
| 296 | against what (BLASTN: dna-dna, BLASTP prt-prt, BLASTX translated | ||||||||||||||||||||||||||||||||||||||||||
| 297 | dna-prt, TBLASTN prt-translated dna, TBLASTX translated | ||||||||||||||||||||||||||||||||||||||||||
| 298 | dna-translated dna). | ||||||||||||||||||||||||||||||||||||||||||
| 299 | Returns : a scalar string | ||||||||||||||||||||||||||||||||||||||||||
| 300 | Args : none | ||||||||||||||||||||||||||||||||||||||||||
| 301 | |||||||||||||||||||||||||||||||||||||||||||
| 302 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 303 | |||||||||||||||||||||||||||||||||||||||||||
| 304 | #---------------- | ||||||||||||||||||||||||||||||||||||||||||
| 305 | 0 | ▶ | sub algorithm { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
algorithm: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 306 | #---------------- | ||||||||||||||||||||||||||||||||||||||||||
| 307 | 0 | my ($self,@args) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 308 | 0 | return $self->{'_prog'}; | |||||||||||||||||||||||||||||||||||||||||
| 309 | } | ||||||||||||||||||||||||||||||||||||||||||
| 310 | |||||||||||||||||||||||||||||||||||||||||||
| 311 | |||||||||||||||||||||||||||||||||||||||||||
| 312 | |||||||||||||||||||||||||||||||||||||||||||
| 313 | |||||||||||||||||||||||||||||||||||||||||||
| 314 | =head2 signif() | ||||||||||||||||||||||||||||||||||||||||||
| 315 | |||||||||||||||||||||||||||||||||||||||||||
| 316 | Usage : $hsp_obj->signif() | ||||||||||||||||||||||||||||||||||||||||||
| 317 | Purpose : Get the P-value or Expect value for the HSP. | ||||||||||||||||||||||||||||||||||||||||||
| 318 | Returns : Float (0.001 or 1.3e-43) | ||||||||||||||||||||||||||||||||||||||||||
| 319 | : Returns P-value if it is defined, otherwise, Expect value. | ||||||||||||||||||||||||||||||||||||||||||
| 320 | Argument : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 321 | Throws : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 322 | Comments : Provided for consistency with BlastHit::signif() | ||||||||||||||||||||||||||||||||||||||||||
| 323 | : Support for returning the significance data in different | ||||||||||||||||||||||||||||||||||||||||||
| 324 | : formats (e.g., exponent only), is not provided for HSP objects. | ||||||||||||||||||||||||||||||||||||||||||
| 325 | : This is only available for the BlastHit or Blast object. | ||||||||||||||||||||||||||||||||||||||||||
| 326 | |||||||||||||||||||||||||||||||||||||||||||
| 327 | See Also : L</p>, L</expect>, L<Bio::Search::Hit::BlastHit::signif()|Bio::Search::Hit::BlastHit> | ||||||||||||||||||||||||||||||||||||||||||
| 328 | |||||||||||||||||||||||||||||||||||||||||||
| 329 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 330 | |||||||||||||||||||||||||||||||||||||||||||
| 331 | #----------- | ||||||||||||||||||||||||||||||||||||||||||
| 332 | 0 | ▶ | sub signif { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
signif: not called CC=3 SCAR=24.8
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 333 | #----------- | ||||||||||||||||||||||||||||||||||||||||||
| 334 | 0 | my $self = shift; | |||||||||||||||||||||||||||||||||||||||||
| 335 | 0 | ▶ | my $val ||= defined($self->{'_p'}) ? $self->{'_p'} : $self->{'_expect'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
my $val ||= defined $self->{"_p"} ? $self->{"_p"} : $self->{"_expect"}
MC/DC0%0/2
my $val ||= defined $self->{"_p"} ? $self->{"_p"} : $self->{"_expect"}
my $val
defined $self->{"_p"} ? $self->{"_p"} : $self->{"_expect"}
Truth table0%0/3
A ||= B
A= my $valB= defined $self->{"_p"} ? $self->{"_p"} : $self->{"_expect"}
| |||||||||||||||||||||||||||||||||||||||||||
| 336 | 0 | $val; | |||||||||||||||||||||||||||||||||||||||||
| 337 | } | ||||||||||||||||||||||||||||||||||||||||||
| 338 | |||||||||||||||||||||||||||||||||||||||||||
| 339 | |||||||||||||||||||||||||||||||||||||||||||
| 340 | |||||||||||||||||||||||||||||||||||||||||||
| 341 | =head2 evalue | ||||||||||||||||||||||||||||||||||||||||||
| 342 | |||||||||||||||||||||||||||||||||||||||||||
| 343 | Usage : $hsp_obj->evalue() | ||||||||||||||||||||||||||||||||||||||||||
| 344 | Purpose : Get the Expect value for the HSP. | ||||||||||||||||||||||||||||||||||||||||||
| 345 | Returns : Float (0.001 or 1.3e-43) | ||||||||||||||||||||||||||||||||||||||||||
| 346 | Argument : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 347 | Throws : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 348 | Comments : Support for returning the expectation data in different | ||||||||||||||||||||||||||||||||||||||||||
| 349 | : formats (e.g., exponent only), is not provided for HSP objects. | ||||||||||||||||||||||||||||||||||||||||||
| 350 | : This is only available for the BlastHit or Blast object. | ||||||||||||||||||||||||||||||||||||||||||
| 351 | |||||||||||||||||||||||||||||||||||||||||||
| 352 | See Also : L</p> | ||||||||||||||||||||||||||||||||||||||||||
| 353 | |||||||||||||||||||||||||||||||||||||||||||
| 354 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 355 | |||||||||||||||||||||||||||||||||||||||||||
| 356 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 357 | 0 | ▶ | sub evalue { shift->{'_expect'} } | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
evalue: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 358 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 359 | |||||||||||||||||||||||||||||||||||||||||||
| 360 | |||||||||||||||||||||||||||||||||||||||||||
| 361 | =head2 p | ||||||||||||||||||||||||||||||||||||||||||
| 362 | |||||||||||||||||||||||||||||||||||||||||||
| 363 | Usage : $hsp_obj->p() | ||||||||||||||||||||||||||||||||||||||||||
| 364 | Purpose : Get the P-value for the HSP. | ||||||||||||||||||||||||||||||||||||||||||
| 365 | Returns : Float (0.001 or 1.3e-43) or undef if not defined. | ||||||||||||||||||||||||||||||||||||||||||
| 366 | Argument : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 367 | Throws : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 368 | Comments : P-value is not defined with NCBI Blast2 reports. | ||||||||||||||||||||||||||||||||||||||||||
| 369 | : Support for returning the expectation data in different | ||||||||||||||||||||||||||||||||||||||||||
| 370 | : formats (e.g., exponent only) is not provided for HSP objects. | ||||||||||||||||||||||||||||||||||||||||||
| 371 | : This is only available for the BlastHit or Blast object. | ||||||||||||||||||||||||||||||||||||||||||
| 372 | |||||||||||||||||||||||||||||||||||||||||||
| 373 | See Also : L</expect> | ||||||||||||||||||||||||||||||||||||||||||
| 374 | |||||||||||||||||||||||||||||||||||||||||||
| 375 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 376 | |||||||||||||||||||||||||||||||||||||||||||
| 377 | #----- | ||||||||||||||||||||||||||||||||||||||||||
| 378 | 0 | ▶ | sub p { my $self = shift; $self->{'_p'}; } | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
p: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 379 | #----- | ||||||||||||||||||||||||||||||||||||||||||
| 380 | |||||||||||||||||||||||||||||||||||||||||||
| 381 | # alias | ||||||||||||||||||||||||||||||||||||||||||
| 382 | 0 | ▶ | sub pvalue { shift->p(@_); } | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
pvalue: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 383 | |||||||||||||||||||||||||||||||||||||||||||
| 384 | =head2 length | ||||||||||||||||||||||||||||||||||||||||||
| 385 | |||||||||||||||||||||||||||||||||||||||||||
| 386 | Usage : $hsp->length( [seq_type] ) | ||||||||||||||||||||||||||||||||||||||||||
| 387 | Purpose : Get the length of the aligned portion of the query or sbjct. | ||||||||||||||||||||||||||||||||||||||||||
| 388 | Example : $hsp->length('query') | ||||||||||||||||||||||||||||||||||||||||||
| 389 | Returns : integer | ||||||||||||||||||||||||||||||||||||||||||
| 390 | Argument : seq_type: 'query' | 'hit' or 'sbjct' | 'total' (default = 'total') | ||||||||||||||||||||||||||||||||||||||||||
| 391 | ('sbjct' is synonymous with 'hit') | ||||||||||||||||||||||||||||||||||||||||||
| 392 | Throws : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 393 | Comments : 'total' length is the full length of the alignment | ||||||||||||||||||||||||||||||||||||||||||
| 394 | : as reported in the denominators in the alignment section: | ||||||||||||||||||||||||||||||||||||||||||
| 395 | : "Identical = 34/120 Positives = 67/120". | ||||||||||||||||||||||||||||||||||||||||||
| 396 | |||||||||||||||||||||||||||||||||||||||||||
| 397 | See Also : L</gaps> | ||||||||||||||||||||||||||||||||||||||||||
| 398 | |||||||||||||||||||||||||||||||||||||||||||
| 399 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 400 | |||||||||||||||||||||||||||||||||||||||||||
| 401 | #----------- | ||||||||||||||||||||||||||||||||||||||||||
| 402 | 0 | ▶ | sub length { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
length: not called CC=5 SCAR=34.0
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 403 | #----------- | ||||||||||||||||||||||||||||||||||||||||||
| 404 | ## Developer note: when using the built-in length function within | ||||||||||||||||||||||||||||||||||||||||||
| 405 | ## this module, call it as CORE::length(). | ||||||||||||||||||||||||||||||||||||||||||
| 406 | 0 | my( $self, $seqType ) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 407 | 0 | ▶ | $seqType ||= 'total'; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$seqType ||= "total"
MC/DC0%0/1
$seqType ||= "total"
$seqType
Truth table0%0/2
A
A= $seqType
| |||||||||||||||||||||||||||||||||||||||||||
| 408 | 0 | ▶ | $seqType = 'sbjct' if $seqType eq 'hit'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 409 | |||||||||||||||||||||||||||||||||||||||||||
| 410 | 0 | ▶ | $seqType ne 'total' and $self->_set_seq_data() unless $self->{'_set_seq_data'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/6
$self->{'_set_seq_data'} || $seqType ne 'total' && $self->_set_seq_data
$seqType ne "total" and $self->_set_seq_data
MC/DC0%0/3
$self->{'_set_seq_data'} || $seqType ne 'total' && $self->_set_seq_data
$self->{'_set_seq_data'}
$seqType ne "total"
$self->_set_seq_data
Truth table0%0/4
A || B and C
A= $self->{'_set_seq_data'}B= $seqType ne "total"C= $self->_set_seq_data
| |||||||||||||||||||||||||||||||||||||||||||
| 411 | |||||||||||||||||||||||||||||||||||||||||||
| 412 | ## Sensitive to member name format. | ||||||||||||||||||||||||||||||||||||||||||
| 413 | 0 | $seqType = "_\L$seqType\E"; | |||||||||||||||||||||||||||||||||||||||||
| 414 | 0 | $self->{$seqType.'Length'}; | |||||||||||||||||||||||||||||||||||||||||
| 415 | } | ||||||||||||||||||||||||||||||||||||||||||
| 416 | |||||||||||||||||||||||||||||||||||||||||||
| 417 | |||||||||||||||||||||||||||||||||||||||||||
| 418 | |||||||||||||||||||||||||||||||||||||||||||
| 419 | =head2 gaps | ||||||||||||||||||||||||||||||||||||||||||
| 420 | |||||||||||||||||||||||||||||||||||||||||||
| 421 | Usage : $hsp->gaps( [seq_type] ) | ||||||||||||||||||||||||||||||||||||||||||
| 422 | Purpose : Get the number of gap characters in the query, sbjct, or total alignment. | ||||||||||||||||||||||||||||||||||||||||||
| 423 | : Also can return query gap chars and sbjct gap chars as a two-element list | ||||||||||||||||||||||||||||||||||||||||||
| 424 | : when in array context. | ||||||||||||||||||||||||||||||||||||||||||
| 425 | Example : $total_gaps = $hsp->gaps(); | ||||||||||||||||||||||||||||||||||||||||||
| 426 | : ($qgaps, $sgaps) = $hsp->gaps(); | ||||||||||||||||||||||||||||||||||||||||||
| 427 | : $qgaps = $hsp->gaps('query'); | ||||||||||||||||||||||||||||||||||||||||||
| 428 | Returns : scalar context: integer | ||||||||||||||||||||||||||||||||||||||||||
| 429 | : array context without args: (int, int) = ('queryGaps', 'sbjctGaps') | ||||||||||||||||||||||||||||||||||||||||||
| 430 | Argument : seq_type: 'query' or 'hit' or 'sbjct' or 'total' | ||||||||||||||||||||||||||||||||||||||||||
| 431 | : ('sbjct' is synonymous with 'hit') | ||||||||||||||||||||||||||||||||||||||||||
| 432 | : (default = 'total', scalar context) | ||||||||||||||||||||||||||||||||||||||||||
| 433 | : Array context can be "induced" by providing an argument of 'list' or 'array'. | ||||||||||||||||||||||||||||||||||||||||||
| 434 | Throws : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 435 | |||||||||||||||||||||||||||||||||||||||||||
| 436 | See Also : L</length>, L</matches> | ||||||||||||||||||||||||||||||||||||||||||
| 437 | |||||||||||||||||||||||||||||||||||||||||||
| 438 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 439 | |||||||||||||||||||||||||||||||||||||||||||
| 440 | #--------- | ||||||||||||||||||||||||||||||||||||||||||
| 441 | 0 | ▶ | sub gaps { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
gaps: not called CC=11 SCAR=48.8
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 442 | #--------- | ||||||||||||||||||||||||||||||||||||||||||
| 443 | 0 | my( $self, $seqType ) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 444 | |||||||||||||||||||||||||||||||||||||||||||
| 445 | 0 | ▶ | $self->_set_seq_data() unless $self->{'_set_seq_data'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 446 | |||||||||||||||||||||||||||||||||||||||||||
| 447 | 0 | ▶ | $seqType ||= (wantarray ? 'list' : 'total'); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$seqType ||= wantarray ? "list" : "total"
MC/DC0%0/2
$seqType ||= wantarray ? "list" : "total"
$seqType
wantarray ? "list" : "total"
Truth table0%0/3
A ||= B
A= $seqTypeB= wantarray ? "list" : "total"
| |||||||||||||||||||||||||||||||||||||||||||
| 448 | 0 | ▶ | $seqType = 'sbjct' if $seqType eq 'hit'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 449 | |||||||||||||||||||||||||||||||||||||||||||
| 450 | 0 | ▶ | if($seqType =~ /list|array/i) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 451 | 0 | ▶ | return (($self->{'_queryGaps'} || 0), ($self->{'_sbjctGaps'} || 0)); | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/4
$self->{'_queryGaps'} || 0
$self->{'_sbjctGaps'} || 0
MC/DC0%0/1
$self->{'_queryGaps'} || 0
$self->{'_queryGaps'}
MC/DC0%0/1
$self->{'_sbjctGaps'} || 0
$self->{'_sbjctGaps'}
Truth table0%0/2
A
A= $self->{'_queryGaps'}
Truth table0%0/2
A
A= $self->{'_sbjctGaps'}
| |||||||||||||||||||||||||||||||||||||||||||
| 452 | } | ||||||||||||||||||||||||||||||||||||||||||
| 453 | |||||||||||||||||||||||||||||||||||||||||||
| 454 | 0 | ▶ | if($seqType eq 'total') { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 455 | 0 | ▶ | return ($self->{'_queryGaps'} + $self->{'_sbjctGaps'}) || 0; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$self->{'_queryGaps'} + $self->{'_sbjctGaps'} || 0
MC/DC0%0/1
$self->{'_queryGaps'} + $self->{'_sbjctGaps'} || 0
$self->{'_queryGaps'} + $self->{'_sbjctGaps'}
Truth table0%0/2
A
A= $self->{'_queryGaps'} + $self->{'_sbjctGaps'}
| |||||||||||||||||||||||||||||||||||||||||||
| 456 | } else { | ||||||||||||||||||||||||||||||||||||||||||
| 457 | ## Sensitive to member name format. | ||||||||||||||||||||||||||||||||||||||||||
| 458 | 0 | $seqType = "_\L$seqType\E"; | |||||||||||||||||||||||||||||||||||||||||
| 459 | 0 | ▶ | return $self->{$seqType.'Gaps'} || 0; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$$self{$seqType . 'Gaps'} || 0
MC/DC0%0/1
$$self{$seqType . 'Gaps'} || 0
$$self{$seqType . 'Gaps'}
Truth table0%0/2
A
A= $$self{$seqType . 'Gaps'}
| |||||||||||||||||||||||||||||||||||||||||||
| 460 | } | ||||||||||||||||||||||||||||||||||||||||||
| 461 | } | ||||||||||||||||||||||||||||||||||||||||||
| 462 | |||||||||||||||||||||||||||||||||||||||||||
| 463 | |||||||||||||||||||||||||||||||||||||||||||
| 464 | =head2 frac_identical | ||||||||||||||||||||||||||||||||||||||||||
| 465 | |||||||||||||||||||||||||||||||||||||||||||
| 466 | Usage : $hsp_object->frac_identical( [seq_type] ); | ||||||||||||||||||||||||||||||||||||||||||
| 467 | Purpose : Get the fraction of identical positions within the given HSP. | ||||||||||||||||||||||||||||||||||||||||||
| 468 | Example : $frac_iden = $hsp_object->frac_identical('query'); | ||||||||||||||||||||||||||||||||||||||||||
| 469 | Returns : Float (2-decimal precision, e.g., 0.75). | ||||||||||||||||||||||||||||||||||||||||||
| 470 | Argument : seq_type: 'query' or 'hit' or 'sbjct' or 'total' | ||||||||||||||||||||||||||||||||||||||||||
| 471 | : ('sbjct' is synonymous with 'hit') | ||||||||||||||||||||||||||||||||||||||||||
| 472 | : default = 'total' (but see comments below). | ||||||||||||||||||||||||||||||||||||||||||
| 473 | Throws : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 474 | Comments : Different versions of Blast report different values for the total | ||||||||||||||||||||||||||||||||||||||||||
| 475 | : length of the alignment. This is the number reported in the | ||||||||||||||||||||||||||||||||||||||||||
| 476 | : denominators in the stats section: | ||||||||||||||||||||||||||||||||||||||||||
| 477 | : "Identical = 34/120 Positives = 67/120". | ||||||||||||||||||||||||||||||||||||||||||
| 478 | : NCBI-BLAST uses the total length of the alignment (with gaps) | ||||||||||||||||||||||||||||||||||||||||||
| 479 | : WU-BLAST uses the length of the query sequence (without gaps). | ||||||||||||||||||||||||||||||||||||||||||
| 480 | : Therefore, when called without an argument or an argument of 'total', | ||||||||||||||||||||||||||||||||||||||||||
| 481 | : this method will report different values depending on the | ||||||||||||||||||||||||||||||||||||||||||
| 482 | : version of BLAST used. | ||||||||||||||||||||||||||||||||||||||||||
| 483 | : | ||||||||||||||||||||||||||||||||||||||||||
| 484 | : To get the fraction identical among only the aligned residues, | ||||||||||||||||||||||||||||||||||||||||||
| 485 | : ignoring the gaps, call this method with an argument of 'query' | ||||||||||||||||||||||||||||||||||||||||||
| 486 | : or 'sbjct' ('sbjct' is synonymous with 'hit'). | ||||||||||||||||||||||||||||||||||||||||||
| 487 | |||||||||||||||||||||||||||||||||||||||||||
| 488 | See Also : L</frac_conserved>, L</num_identical>, L</matches> | ||||||||||||||||||||||||||||||||||||||||||
| 489 | |||||||||||||||||||||||||||||||||||||||||||
| 490 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 491 | |||||||||||||||||||||||||||||||||||||||||||
| 492 | #------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 493 | 0 | ▶ | sub frac_identical { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
frac_identical: not called CC=5 SCAR=34.0
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 494 | #------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 495 | # The value is calculated as opposed to storing it from the parsed results. | ||||||||||||||||||||||||||||||||||||||||||
| 496 | # This saves storage and also permits flexibility in determining for which | ||||||||||||||||||||||||||||||||||||||||||
| 497 | # sequence (query or sbjct) the figure is to be calculated. | ||||||||||||||||||||||||||||||||||||||||||
| 498 | |||||||||||||||||||||||||||||||||||||||||||
| 499 | 0 | my( $self, $seqType ) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 500 | 0 | ▶ | $seqType ||= 'total'; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$seqType ||= "total"
MC/DC0%0/1
$seqType ||= "total"
$seqType
Truth table0%0/2
A
A= $seqType
| |||||||||||||||||||||||||||||||||||||||||||
| 501 | 0 | ▶ | $seqType = 'sbjct' if $seqType eq 'hit'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 502 | |||||||||||||||||||||||||||||||||||||||||||
| 503 | 0 | ▶ | if($seqType ne 'total') { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 504 | 0 | ▶ | $self->_set_seq_data() unless $self->{'_set_seq_data'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 505 | } | ||||||||||||||||||||||||||||||||||||||||||
| 506 | ## Sensitive to member name format. | ||||||||||||||||||||||||||||||||||||||||||
| 507 | 0 | $seqType = "_\L$seqType\E"; | |||||||||||||||||||||||||||||||||||||||||
| 508 | |||||||||||||||||||||||||||||||||||||||||||
| 509 | 0 | sprintf( "%.2f", $self->{'_numIdentical'}/$self->{$seqType.'Length'}); | |||||||||||||||||||||||||||||||||||||||||
| 510 | } | ||||||||||||||||||||||||||||||||||||||||||
| 511 | |||||||||||||||||||||||||||||||||||||||||||
| 512 | |||||||||||||||||||||||||||||||||||||||||||
| 513 | =head2 frac_conserved | ||||||||||||||||||||||||||||||||||||||||||
| 514 | |||||||||||||||||||||||||||||||||||||||||||
| 515 | Usage : $hsp_object->frac_conserved( [seq_type] ); | ||||||||||||||||||||||||||||||||||||||||||
| 516 | Purpose : Get the fraction of conserved positions within the given HSP. | ||||||||||||||||||||||||||||||||||||||||||
| 517 | : (Note: 'conservative' positions are called 'positives' in the | ||||||||||||||||||||||||||||||||||||||||||
| 518 | : Blast report.) | ||||||||||||||||||||||||||||||||||||||||||
| 519 | Example : $frac_cons = $hsp_object->frac_conserved('query'); | ||||||||||||||||||||||||||||||||||||||||||
| 520 | Returns : Float (2-decimal precision, e.g., 0.75). | ||||||||||||||||||||||||||||||||||||||||||
| 521 | Argument : seq_type: 'query' or 'hit' or 'sbjct' or 'total' | ||||||||||||||||||||||||||||||||||||||||||
| 522 | : ('sbjct' is synonymous with 'hit') | ||||||||||||||||||||||||||||||||||||||||||
| 523 | : default = 'total' (but see comments below). | ||||||||||||||||||||||||||||||||||||||||||
| 524 | Throws : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 525 | Comments : Different versions of Blast report different values for the total | ||||||||||||||||||||||||||||||||||||||||||
| 526 | : length of the alignment. This is the number reported in the | ||||||||||||||||||||||||||||||||||||||||||
| 527 | : denominators in the stats section: | ||||||||||||||||||||||||||||||||||||||||||
| 528 | : "Identical = 34/120 Positives = 67/120". | ||||||||||||||||||||||||||||||||||||||||||
| 529 | : NCBI-BLAST uses the total length of the alignment (with gaps) | ||||||||||||||||||||||||||||||||||||||||||
| 530 | : WU-BLAST uses the length of the query sequence (without gaps). | ||||||||||||||||||||||||||||||||||||||||||
| 531 | : Therefore, when called without an argument or an argument of 'total', | ||||||||||||||||||||||||||||||||||||||||||
| 532 | : this method will report different values depending on the | ||||||||||||||||||||||||||||||||||||||||||
| 533 | : version of BLAST used. | ||||||||||||||||||||||||||||||||||||||||||
| 534 | : | ||||||||||||||||||||||||||||||||||||||||||
| 535 | : To get the fraction conserved among only the aligned residues, | ||||||||||||||||||||||||||||||||||||||||||
| 536 | : ignoring the gaps, call this method with an argument of 'query' | ||||||||||||||||||||||||||||||||||||||||||
| 537 | : or 'sbjct'. | ||||||||||||||||||||||||||||||||||||||||||
| 538 | |||||||||||||||||||||||||||||||||||||||||||
| 539 | See Also : L</frac_conserved>, L</num_conserved>, L</matches> | ||||||||||||||||||||||||||||||||||||||||||
| 540 | |||||||||||||||||||||||||||||||||||||||||||
| 541 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 542 | |||||||||||||||||||||||||||||||||||||||||||
| 543 | #-------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 544 | 0 | ▶ | sub frac_conserved { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
frac_conserved: not called CC=5 SCAR=34.0
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 545 | #-------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 546 | # The value is calculated as opposed to storing it from the parsed results. | ||||||||||||||||||||||||||||||||||||||||||
| 547 | # This saves storage and also permits flexibility in determining for which | ||||||||||||||||||||||||||||||||||||||||||
| 548 | # sequence (query or sbjct) the figure is to be calculated. | ||||||||||||||||||||||||||||||||||||||||||
| 549 | |||||||||||||||||||||||||||||||||||||||||||
| 550 | 0 | my( $self, $seqType ) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 551 | 0 | ▶ | $seqType ||= 'total'; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$seqType ||= "total"
MC/DC0%0/1
$seqType ||= "total"
$seqType
Truth table0%0/2
A
A= $seqType
| |||||||||||||||||||||||||||||||||||||||||||
| 552 | 0 | ▶ | $seqType = 'sbjct' if $seqType eq 'hit'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 553 | |||||||||||||||||||||||||||||||||||||||||||
| 554 | 0 | ▶ | if($seqType ne 'total') { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 555 | 0 | ▶ | $self->_set_seq_data() unless $self->{'_set_seq_data'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 556 | } | ||||||||||||||||||||||||||||||||||||||||||
| 557 | |||||||||||||||||||||||||||||||||||||||||||
| 558 | ## Sensitive to member name format. | ||||||||||||||||||||||||||||||||||||||||||
| 559 | 0 | $seqType = "_\L$seqType\E"; | |||||||||||||||||||||||||||||||||||||||||
| 560 | |||||||||||||||||||||||||||||||||||||||||||
| 561 | 0 | sprintf( "%.2f", $self->{'_numConserved'}/$self->{$seqType.'Length'}); | |||||||||||||||||||||||||||||||||||||||||
| 562 | } | ||||||||||||||||||||||||||||||||||||||||||
| 563 | |||||||||||||||||||||||||||||||||||||||||||
| 564 | =head2 query_string | ||||||||||||||||||||||||||||||||||||||||||
| 565 | |||||||||||||||||||||||||||||||||||||||||||
| 566 | Title : query_string | ||||||||||||||||||||||||||||||||||||||||||
| 567 | Usage : my $qseq = $hsp->query_string; | ||||||||||||||||||||||||||||||||||||||||||
| 568 | Function: Retrieves the query sequence of this HSP as a string | ||||||||||||||||||||||||||||||||||||||||||
| 569 | Returns : string | ||||||||||||||||||||||||||||||||||||||||||
| 570 | Args : none | ||||||||||||||||||||||||||||||||||||||||||
| 571 | |||||||||||||||||||||||||||||||||||||||||||
| 572 | |||||||||||||||||||||||||||||||||||||||||||
| 573 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 574 | |||||||||||||||||||||||||||||||||||||||||||
| 575 | #---------------- | ||||||||||||||||||||||||||||||||||||||||||
| 576 | 0 | ▶ | sub query_string{ shift->seq_str('query'); } | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
query_string: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 577 | #---------------- | ||||||||||||||||||||||||||||||||||||||||||
| 578 | |||||||||||||||||||||||||||||||||||||||||||
| 579 | =head2 hit_string | ||||||||||||||||||||||||||||||||||||||||||
| 580 | |||||||||||||||||||||||||||||||||||||||||||
| 581 | Title : hit_string | ||||||||||||||||||||||||||||||||||||||||||
| 582 | Usage : my $hseq = $hsp->hit_string; | ||||||||||||||||||||||||||||||||||||||||||
| 583 | Function: Retrieves the hit sequence of this HSP as a string | ||||||||||||||||||||||||||||||||||||||||||
| 584 | Returns : string | ||||||||||||||||||||||||||||||||||||||||||
| 585 | Args : none | ||||||||||||||||||||||||||||||||||||||||||
| 586 | |||||||||||||||||||||||||||||||||||||||||||
| 587 | |||||||||||||||||||||||||||||||||||||||||||
| 588 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 589 | |||||||||||||||||||||||||||||||||||||||||||
| 590 | #---------------- | ||||||||||||||||||||||||||||||||||||||||||
| 591 | 0 | ▶ | sub hit_string{ shift->seq_str('hit'); } | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
hit_string: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 592 | #---------------- | ||||||||||||||||||||||||||||||||||||||||||
| 593 | |||||||||||||||||||||||||||||||||||||||||||
| 594 | |||||||||||||||||||||||||||||||||||||||||||
| 595 | =head2 homology_string | ||||||||||||||||||||||||||||||||||||||||||
| 596 | |||||||||||||||||||||||||||||||||||||||||||
| 597 | Title : homology_string | ||||||||||||||||||||||||||||||||||||||||||
| 598 | Usage : my $homo_string = $hsp->homology_string; | ||||||||||||||||||||||||||||||||||||||||||
| 599 | Function: Retrieves the homology sequence for this HSP as a string. | ||||||||||||||||||||||||||||||||||||||||||
| 600 | : The homology sequence is the string of symbols in between the | ||||||||||||||||||||||||||||||||||||||||||
| 601 | : query and hit sequences in the alignment indicating the degree | ||||||||||||||||||||||||||||||||||||||||||
| 602 | : of conservation (e.g., identical, similar, not similar). | ||||||||||||||||||||||||||||||||||||||||||
| 603 | Returns : string | ||||||||||||||||||||||||||||||||||||||||||
| 604 | Args : none | ||||||||||||||||||||||||||||||||||||||||||
| 605 | |||||||||||||||||||||||||||||||||||||||||||
| 606 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 607 | |||||||||||||||||||||||||||||||||||||||||||
| 608 | #---------------- | ||||||||||||||||||||||||||||||||||||||||||
| 609 | 0 | ▶ | sub homology_string{ shift->seq_str('match'); } | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
homology_string: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 610 | #---------------- | ||||||||||||||||||||||||||||||||||||||||||
| 611 | |||||||||||||||||||||||||||||||||||||||||||
| 612 | #================================================= | ||||||||||||||||||||||||||||||||||||||||||
| 613 | # End Bio::Search::HSP::HSPI implementation | ||||||||||||||||||||||||||||||||||||||||||
| 614 | #================================================= | ||||||||||||||||||||||||||||||||||||||||||
| 615 | |||||||||||||||||||||||||||||||||||||||||||
| 616 | # Older method delegating to method defined in HSPI. | ||||||||||||||||||||||||||||||||||||||||||
| 617 | |||||||||||||||||||||||||||||||||||||||||||
| 618 | =head2 expect | ||||||||||||||||||||||||||||||||||||||||||
| 619 | |||||||||||||||||||||||||||||||||||||||||||
| 620 | See L<Bio::Search::HSP::HSPI::expect()|Bio::Search::HSP::HSPI> | ||||||||||||||||||||||||||||||||||||||||||
| 621 | |||||||||||||||||||||||||||||||||||||||||||
| 622 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 623 | |||||||||||||||||||||||||||||||||||||||||||
| 624 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 625 | 0 | ▶ | sub expect { shift->evalue( @_ ); } | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
expect: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 626 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 627 | |||||||||||||||||||||||||||||||||||||||||||
| 628 | |||||||||||||||||||||||||||||||||||||||||||
| 629 | =head2 rank | ||||||||||||||||||||||||||||||||||||||||||
| 630 | |||||||||||||||||||||||||||||||||||||||||||
| 631 | Usage : $hsp->rank( [string] ); | ||||||||||||||||||||||||||||||||||||||||||
| 632 | Purpose : Get the rank of the HSP within a given Blast hit. | ||||||||||||||||||||||||||||||||||||||||||
| 633 | Example : $rank = $hsp->rank; | ||||||||||||||||||||||||||||||||||||||||||
| 634 | Returns : Integer (1..n) corresponding to the order in which the HSP | ||||||||||||||||||||||||||||||||||||||||||
| 635 | appears in the BLAST report. | ||||||||||||||||||||||||||||||||||||||||||
| 636 | |||||||||||||||||||||||||||||||||||||||||||
| 637 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 638 | |||||||||||||||||||||||||||||||||||||||||||
| 639 | #' | ||||||||||||||||||||||||||||||||||||||||||
| 640 | |||||||||||||||||||||||||||||||||||||||||||
| 641 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 642 | 0 | ▶ | sub rank { shift->{'_rank'} } | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
rank: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 643 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 644 | |||||||||||||||||||||||||||||||||||||||||||
| 645 | # For backward compatibility | ||||||||||||||||||||||||||||||||||||||||||
| 646 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 647 | 0 | ▶ | sub name { shift->rank } | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
name: not called CC=1 SCAR=6.9
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 648 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 649 | |||||||||||||||||||||||||||||||||||||||||||
| 650 | =head2 to_string | ||||||||||||||||||||||||||||||||||||||||||
| 651 | |||||||||||||||||||||||||||||||||||||||||||
| 652 | Title : to_string | ||||||||||||||||||||||||||||||||||||||||||
| 653 | Usage : print $hsp->to_string; | ||||||||||||||||||||||||||||||||||||||||||
| 654 | Function: Returns a string representation for the Blast HSP. | ||||||||||||||||||||||||||||||||||||||||||
| 655 | Primarily intended for debugging purposes. | ||||||||||||||||||||||||||||||||||||||||||
| 656 | Example : see usage | ||||||||||||||||||||||||||||||||||||||||||
| 657 | Returns : A string of the form: | ||||||||||||||||||||||||||||||||||||||||||
| 658 | [PsiBlastHSP] <rank> | ||||||||||||||||||||||||||||||||||||||||||
| 659 | e.g.: | ||||||||||||||||||||||||||||||||||||||||||
| 660 | [BlastHit] 1 | ||||||||||||||||||||||||||||||||||||||||||
| 661 | Args : None | ||||||||||||||||||||||||||||||||||||||||||
| 662 | |||||||||||||||||||||||||||||||||||||||||||
| 663 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 664 | |||||||||||||||||||||||||||||||||||||||||||
| 665 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 666 | 0 | ▶ | sub to_string { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
to_string: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 667 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 668 | 0 | my $self = shift; | |||||||||||||||||||||||||||||||||||||||||
| 669 | 0 | return "[PsiBlastHSP] " . $self->rank(); | |||||||||||||||||||||||||||||||||||||||||
| 670 | } | ||||||||||||||||||||||||||||||||||||||||||
| 671 | |||||||||||||||||||||||||||||||||||||||||||
| 672 | |||||||||||||||||||||||||||||||||||||||||||
| 673 | =head2 _set_data | ||||||||||||||||||||||||||||||||||||||||||
| 674 | |||||||||||||||||||||||||||||||||||||||||||
| 675 | Usage : called automatically during object construction. | ||||||||||||||||||||||||||||||||||||||||||
| 676 | Purpose : Parses the raw HSP section from a flat BLAST report and | ||||||||||||||||||||||||||||||||||||||||||
| 677 | sets the query sequence, sbjct sequence, and the "match" data | ||||||||||||||||||||||||||||||||||||||||||
| 678 | : which consists of the symbols between the query and sbjct lines | ||||||||||||||||||||||||||||||||||||||||||
| 679 | : in the alignment. | ||||||||||||||||||||||||||||||||||||||||||
| 680 | Argument : Array (all lines for a single, complete HSP, from a raw, | ||||||||||||||||||||||||||||||||||||||||||
| 681 | flat (i.e., non-XML) BLAST report) | ||||||||||||||||||||||||||||||||||||||||||
| 682 | Throws : Propagates any exceptions from the methods called ("See Also") | ||||||||||||||||||||||||||||||||||||||||||
| 683 | |||||||||||||||||||||||||||||||||||||||||||
| 684 | See Also : L</_set_seq>, L</_set_score_stats>, L</_set_match_stats> | ||||||||||||||||||||||||||||||||||||||||||
| 685 | |||||||||||||||||||||||||||||||||||||||||||
| 686 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 687 | |||||||||||||||||||||||||||||||||||||||||||
| 688 | #-------------- | ||||||||||||||||||||||||||||||||||||||||||
| 689 | 0 | ▶ | sub _set_data { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
_set_data: not called CC=13 SCAR=52.0
| |||||||||||||||||||||||||||||||||||||||||||
| 690 | #-------------- | ||||||||||||||||||||||||||||||||||||||||||
| 691 | 0 | my $self = shift; | |||||||||||||||||||||||||||||||||||||||||
| 692 | 0 | my @data = @_; | |||||||||||||||||||||||||||||||||||||||||
| 693 | 0 | my @queryList = (); # 'Query' = SEQUENCE USED TO QUERY THE DATABASE. | |||||||||||||||||||||||||||||||||||||||||
| 694 | 0 | my @sbjctList = (); # 'Sbjct' = HOMOLOGOUS SEQUENCE FOUND IN THE DATABASE. | |||||||||||||||||||||||||||||||||||||||||
| 695 | 0 | my @matchList = (); | |||||||||||||||||||||||||||||||||||||||||
| 696 | 0 | my $matchLine = 0; # Alternating boolean: when true, load 'match' data. | |||||||||||||||||||||||||||||||||||||||||
| 697 | 0 | my @linedat = (); | |||||||||||||||||||||||||||||||||||||||||
| 698 | |||||||||||||||||||||||||||||||||||||||||||
| 699 | #print STDERR "PsiBlastHSP: set_data()\n"; | ||||||||||||||||||||||||||||||||||||||||||
| 700 | |||||||||||||||||||||||||||||||||||||||||||
| 701 | 0 | my($line, $aln_row_len, $length_diff); | |||||||||||||||||||||||||||||||||||||||||
| 702 | 0 | $length_diff = 0; | |||||||||||||||||||||||||||||||||||||||||
| 703 | |||||||||||||||||||||||||||||||||||||||||||
| 704 | # Collecting data for all lines in the alignment | ||||||||||||||||||||||||||||||||||||||||||
| 705 | # and then storing the collections for possible processing later. | ||||||||||||||||||||||||||||||||||||||||||
| 706 | # | ||||||||||||||||||||||||||||||||||||||||||
| 707 | # Note that "match" lines may not be properly padded with spaces. | ||||||||||||||||||||||||||||||||||||||||||
| 708 | # This loop now properly handles such cases: | ||||||||||||||||||||||||||||||||||||||||||
| 709 | # Query: 1141 PSLVELTIRDCPRLEVGPMIRSLPKFPMLKKLDLAVANIIEEDLDVIGSLEELVIXXXXX 1200 | ||||||||||||||||||||||||||||||||||||||||||
| 710 | # PSLVELTIRDCPRLEVGPMIRSLPKFPMLKKLDLAVANIIEEDLDVIGSLEELVI | ||||||||||||||||||||||||||||||||||||||||||
| 711 | # Sbjct: 1141 PSLVELTIRDCPRLEVGPMIRSLPKFPMLKKLDLAVANIIEEDLDVIGSLEELVILSLKL 1200 | ||||||||||||||||||||||||||||||||||||||||||
| 712 | |||||||||||||||||||||||||||||||||||||||||||
| 713 | 0 | foreach $line( @data ) { | |||||||||||||||||||||||||||||||||||||||||
| 714 | 0 | ▶ | next if $line =~ /^\s*$/; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 715 | |||||||||||||||||||||||||||||||||||||||||||
| 716 | 0 | ▶ | if( $line =~ /^ ?Score/ ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 6 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 717 | 0 | $self->_set_score_stats( $line ); | |||||||||||||||||||||||||||||||||||||||||
| 718 | } elsif( $line =~ /^ ?(Identities|Positives|Strand)/ ) { | ||||||||||||||||||||||||||||||||||||||||||
| 719 | 0 | $self->_set_match_stats( $line ); | |||||||||||||||||||||||||||||||||||||||||
| 720 | } elsif( $line =~ /^ ?Frame = ([\d+-]+)/ ) { | ||||||||||||||||||||||||||||||||||||||||||
| 721 | # Version 2.0.8 has Frame information on a separate line. | ||||||||||||||||||||||||||||||||||||||||||
| 722 | # Storing frame according to SeqFeature::Generic::frame() | ||||||||||||||||||||||||||||||||||||||||||
| 723 | # which does not contain strand info (use strand()). | ||||||||||||||||||||||||||||||||||||||||||
| 724 | 0 | my $frame = abs($1) - 1; | |||||||||||||||||||||||||||||||||||||||||
| 725 | 0 | $self->frame( $frame ); | |||||||||||||||||||||||||||||||||||||||||
| 726 | } elsif( $line =~ /^(Query:?[\s\d]+)([^\s\d]+)/ ) { | ||||||||||||||||||||||||||||||||||||||||||
| 727 | 0 | push @queryList, $line; | |||||||||||||||||||||||||||||||||||||||||
| 728 | 0 | $self->{'_match_indent'} = CORE::length $1; | |||||||||||||||||||||||||||||||||||||||||
| 729 | 0 | $aln_row_len = (CORE::length $1) + (CORE::length $2); | |||||||||||||||||||||||||||||||||||||||||
| 730 | 0 | $matchLine = 1; | |||||||||||||||||||||||||||||||||||||||||
| 731 | } elsif( $matchLine ) { | ||||||||||||||||||||||||||||||||||||||||||
| 732 | # Pad the match line with spaces if necessary. | ||||||||||||||||||||||||||||||||||||||||||
| 733 | 0 | $length_diff = $aln_row_len - CORE::length $line; | |||||||||||||||||||||||||||||||||||||||||
| 734 | 0 | ▶ | $length_diff and $line .= ' 'x $length_diff; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 735 | 0 | push @matchList, $line; | |||||||||||||||||||||||||||||||||||||||||
| 736 | 0 | $matchLine = 0; | |||||||||||||||||||||||||||||||||||||||||
| 737 | } elsif( $line =~ /^Sbjct/ ) { | ||||||||||||||||||||||||||||||||||||||||||
| 738 | 0 | push @sbjctList, $line; | |||||||||||||||||||||||||||||||||||||||||
| 739 | } | ||||||||||||||||||||||||||||||||||||||||||
| 740 | } | ||||||||||||||||||||||||||||||||||||||||||
| 741 | # Storing the query and sbjct lists in case they are needed later. | ||||||||||||||||||||||||||||||||||||||||||
| 742 | # We could make this conditional to save memory. | ||||||||||||||||||||||||||||||||||||||||||
| 743 | 0 | $self->{'_queryList'} = \@queryList; | |||||||||||||||||||||||||||||||||||||||||
| 744 | 0 | $self->{'_sbjctList'} = \@sbjctList; | |||||||||||||||||||||||||||||||||||||||||
| 745 | |||||||||||||||||||||||||||||||||||||||||||
| 746 | # Storing the match list in case it is needed later. | ||||||||||||||||||||||||||||||||||||||||||
| 747 | 0 | $self->{'_matchList'} = \@matchList; | |||||||||||||||||||||||||||||||||||||||||
| 748 | |||||||||||||||||||||||||||||||||||||||||||
| 749 | 0 | ▶ | if(not defined ($self->{'_numIdentical'})) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 750 | 0 | my $id_str = $self->_id_str; | |||||||||||||||||||||||||||||||||||||||||
| 751 | 0 | $self->throw( -text => "Can't parse match statistics. Possibly a new or unrecognized Blast format. ($id_str)"); | |||||||||||||||||||||||||||||||||||||||||
| 752 | } | ||||||||||||||||||||||||||||||||||||||||||
| 753 | |||||||||||||||||||||||||||||||||||||||||||
| 754 | 0 | ▶ | if(!scalar @queryList or !scalar @sbjctList) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
scalar @queryList && scalar @sbjctList
MC/DC0%0/2
scalar @queryList && scalar @sbjctList
scalar @queryList
scalar @sbjctList
Truth table0%0/3
A && B
A= scalar @queryListB= scalar @sbjctList
| |||||||||||||||||||||||||||||||||||||||||||
| 755 | 0 | my $id_str = $self->_id_str; | |||||||||||||||||||||||||||||||||||||||||
| 756 | 0 | $self->throw( "Can't find query or sbjct alignment lines. Possibly unrecognized Blast format. ($id_str)"); | |||||||||||||||||||||||||||||||||||||||||
| 757 | } | ||||||||||||||||||||||||||||||||||||||||||
| 758 | } | ||||||||||||||||||||||||||||||||||||||||||
| 759 | |||||||||||||||||||||||||||||||||||||||||||
| 760 | |||||||||||||||||||||||||||||||||||||||||||
| 761 | =head2 _set_score_stats | ||||||||||||||||||||||||||||||||||||||||||
| 762 | |||||||||||||||||||||||||||||||||||||||||||
| 763 | Usage : called automatically by _set_data() | ||||||||||||||||||||||||||||||||||||||||||
| 764 | Purpose : Sets various score statistics obtained from the HSP listing. | ||||||||||||||||||||||||||||||||||||||||||
| 765 | Argument : String with any of the following formats: | ||||||||||||||||||||||||||||||||||||||||||
| 766 | : blast2: Score = 30.1 bits (66), Expect = 9.2 | ||||||||||||||||||||||||||||||||||||||||||
| 767 | : blast2: Score = 158.2 bits (544), Expect(2) = e-110 | ||||||||||||||||||||||||||||||||||||||||||
| 768 | : blast1: Score = 410 (144.3 bits), Expect = 1.7e-40, P = 1.7e-40 | ||||||||||||||||||||||||||||||||||||||||||
| 769 | : blast1: Score = 55 (19.4 bits), Expect = 5.3, Sum P(3) = 0.99 | ||||||||||||||||||||||||||||||||||||||||||
| 770 | Throws : Exception if the stats cannot be parsed, probably due to a change | ||||||||||||||||||||||||||||||||||||||||||
| 771 | : in the Blast report format. | ||||||||||||||||||||||||||||||||||||||||||
| 772 | |||||||||||||||||||||||||||||||||||||||||||
| 773 | See Also : L</_set_data> | ||||||||||||||||||||||||||||||||||||||||||
| 774 | |||||||||||||||||||||||||||||||||||||||||||
| 775 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 776 | |||||||||||||||||||||||||||||||||||||||||||
| 777 | #-------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 778 | 0 | ▶ | sub _set_score_stats { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
_set_score_stats: not called CC=10 SCAR=47.0
| |||||||||||||||||||||||||||||||||||||||||||
| 779 | #-------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 780 | 0 | my ($self, $data) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 781 | |||||||||||||||||||||||||||||||||||||||||||
| 782 | 0 | my ($expect, $p); | |||||||||||||||||||||||||||||||||||||||||
| 783 | |||||||||||||||||||||||||||||||||||||||||||
| 784 | 0 | ▶ | if($data =~ /Score = +([\d.e+-]+) bits \(([\d.e+-]+)\), +Expect = +([\d.e+-]+)/) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 4 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 785 | # blast2 format n = 1 | ||||||||||||||||||||||||||||||||||||||||||
| 786 | 0 | $self->bits($1); | |||||||||||||||||||||||||||||||||||||||||
| 787 | 0 | $self->score($2); | |||||||||||||||||||||||||||||||||||||||||
| 788 | 0 | $expect = $3; | |||||||||||||||||||||||||||||||||||||||||
| 789 | } elsif($data =~ /Score = +([\d.e+-]+) bits \(([\d.e+-]+)\), +Expect\((\d+)\) = +([\d.e+-]+)/) { | ||||||||||||||||||||||||||||||||||||||||||
| 790 | # blast2 format n > 1 | ||||||||||||||||||||||||||||||||||||||||||
| 791 | 0 | $self->bits($1); | |||||||||||||||||||||||||||||||||||||||||
| 792 | 0 | $self->score($2); | |||||||||||||||||||||||||||||||||||||||||
| 793 | 0 | $self->{'_n'} = $3; | |||||||||||||||||||||||||||||||||||||||||
| 794 | 0 | $expect = $4; | |||||||||||||||||||||||||||||||||||||||||
| 795 | |||||||||||||||||||||||||||||||||||||||||||
| 796 | } elsif($data =~ /Score = +([\d.e+-]+) \(([\d.e+-]+) bits\), +Expect = +([\d.e+-]+), P = +([\d.e-]+)/) { | ||||||||||||||||||||||||||||||||||||||||||
| 797 | # blast1 format, n = 1 | ||||||||||||||||||||||||||||||||||||||||||
| 798 | 0 | $self->score($1); | |||||||||||||||||||||||||||||||||||||||||
| 799 | 0 | $self->bits($2); | |||||||||||||||||||||||||||||||||||||||||
| 800 | 0 | $expect = $3; | |||||||||||||||||||||||||||||||||||||||||
| 801 | 0 | $p = $4; | |||||||||||||||||||||||||||||||||||||||||
| 802 | |||||||||||||||||||||||||||||||||||||||||||
| 803 | } elsif($data =~ /Score = +([\d.e+-]+) \(([\d.e+-]+) bits\), +Expect = +([\d.e+-]+), +Sum P\((\d+)\) = +([\d.e-]+)/) { | ||||||||||||||||||||||||||||||||||||||||||
| 804 | # blast1 format, n > 1 | ||||||||||||||||||||||||||||||||||||||||||
| 805 | 0 | $self->score($1); | |||||||||||||||||||||||||||||||||||||||||
| 806 | 0 | $self->bits($2); | |||||||||||||||||||||||||||||||||||||||||
| 807 | 0 | $expect = $3; | |||||||||||||||||||||||||||||||||||||||||
| 808 | 0 | $self->{'_n'} = $4; | |||||||||||||||||||||||||||||||||||||||||
| 809 | 0 | $p = $5; | |||||||||||||||||||||||||||||||||||||||||
| 810 | |||||||||||||||||||||||||||||||||||||||||||
| 811 | } else { | ||||||||||||||||||||||||||||||||||||||||||
| 812 | 0 | my $id_str = $self->_id_str; | |||||||||||||||||||||||||||||||||||||||||
| 813 | 0 | $self->throw(-class => 'Bio::Root::Exception', | |||||||||||||||||||||||||||||||||||||||||
| 814 | -text => "Can't parse score statistics: unrecognized format. ($id_str)", | ||||||||||||||||||||||||||||||||||||||||||
| 815 | -value => $data); | ||||||||||||||||||||||||||||||||||||||||||
| 816 | } | ||||||||||||||||||||||||||||||||||||||||||
| 817 | 0 | ▶ | $expect = "1$expect" if $expect =~ /^e/i; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 818 | 0 | ▶ | $p = "1$p" if defined $p and $p=~ /^e/i; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
defined $p and $p =~ /^e/i
MC/DC0%0/2
defined $p and $p =~ /^e/i
defined $p
$p =~ /^e/i
Truth table0%0/3
A and B
A= defined $pB= $p =~ /^e/i
| |||||||||||||||||||||||||||||||||||||||||||
| 819 | |||||||||||||||||||||||||||||||||||||||||||
| 820 | 0 | $self->{'_expect'} = $expect; | |||||||||||||||||||||||||||||||||||||||||
| 821 | 0 | ▶ | $self->{'_p'} = $p || undef; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$p || undef
MC/DC0%0/1
$p || undef
$p
Truth table0%0/2
A
A= $p
| |||||||||||||||||||||||||||||||||||||||||||
| 822 | 0 | ▶ | $self->significance( $p || $expect ); | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/3
$p || $expect
MC/DC0%0/2
$p || $expect
$p
$expect
Truth table0%0/3
A || B
A= $pB= $expect
| |||||||||||||||||||||||||||||||||||||||||||
| 823 | } | ||||||||||||||||||||||||||||||||||||||||||
| 824 | |||||||||||||||||||||||||||||||||||||||||||
| 825 | |||||||||||||||||||||||||||||||||||||||||||
| 826 | =head2 _set_match_stats | ||||||||||||||||||||||||||||||||||||||||||
| 827 | |||||||||||||||||||||||||||||||||||||||||||
| 828 | Usage : Private method; called automatically by _set_data() | ||||||||||||||||||||||||||||||||||||||||||
| 829 | Purpose : Sets various matching statistics obtained from the HSP listing. | ||||||||||||||||||||||||||||||||||||||||||
| 830 | Argument : blast2: Identities = 23/74 (31%), Positives = 29/74 (39%), Gaps = 17/74 (22%) | ||||||||||||||||||||||||||||||||||||||||||
| 831 | : blast2: Identities = 57/98 (58%), Positives = 74/98 (75%) | ||||||||||||||||||||||||||||||||||||||||||
| 832 | : blast1: Identities = 87/204 (42%), Positives = 126/204 (61%) | ||||||||||||||||||||||||||||||||||||||||||
| 833 | : blast1: Identities = 87/204 (42%), Positives = 126/204 (61%), Frame = -3 | ||||||||||||||||||||||||||||||||||||||||||
| 834 | : WU-blast: Identities = 310/553 (56%), Positives = 310/553 (56%), Strand = Minus / Plus | ||||||||||||||||||||||||||||||||||||||||||
| 835 | Throws : Exception if the stats cannot be parsed, probably due to a change | ||||||||||||||||||||||||||||||||||||||||||
| 836 | : in the Blast report format. | ||||||||||||||||||||||||||||||||||||||||||
| 837 | Comments : The "Gaps = " data in the HSP header has a different meaning depending | ||||||||||||||||||||||||||||||||||||||||||
| 838 | : on the type of Blast: for BLASTP, this number is the total number of | ||||||||||||||||||||||||||||||||||||||||||
| 839 | : gaps in query+sbjct; for TBLASTN, it is the number of gaps in the | ||||||||||||||||||||||||||||||||||||||||||
| 840 | : query sequence only. Thus, it is safer to collect the data | ||||||||||||||||||||||||||||||||||||||||||
| 841 | : separately by examining the actual sequence strings as is done | ||||||||||||||||||||||||||||||||||||||||||
| 842 | : in _set_seq(). | ||||||||||||||||||||||||||||||||||||||||||
| 843 | |||||||||||||||||||||||||||||||||||||||||||
| 844 | See Also : L</_set_data>, L</_set_seq> | ||||||||||||||||||||||||||||||||||||||||||
| 845 | |||||||||||||||||||||||||||||||||||||||||||
| 846 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 847 | |||||||||||||||||||||||||||||||||||||||||||
| 848 | #-------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 849 | 0 | ▶ | sub _set_match_stats { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
_set_match_stats: not called CC=5 SCAR=34.0
| |||||||||||||||||||||||||||||||||||||||||||
| 850 | #-------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 851 | 0 | my ($self, $data) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 852 | |||||||||||||||||||||||||||||||||||||||||||
| 853 | 0 | ▶ | if($data =~ m!Identities = (\d+)/(\d+)!) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 854 | # blast1 or 2 format | ||||||||||||||||||||||||||||||||||||||||||
| 855 | 0 | $self->{'_numIdentical'} = $1; | |||||||||||||||||||||||||||||||||||||||||
| 856 | 0 | $self->{'_totalLength'} = $2; | |||||||||||||||||||||||||||||||||||||||||
| 857 | } | ||||||||||||||||||||||||||||||||||||||||||
| 858 | |||||||||||||||||||||||||||||||||||||||||||
| 859 | 0 | ▶ | if($data =~ m!Positives = (\d+)/(\d+)!) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 860 | # blast1 or 2 format | ||||||||||||||||||||||||||||||||||||||||||
| 861 | 0 | $self->{'_numConserved'} = $1; | |||||||||||||||||||||||||||||||||||||||||
| 862 | 0 | $self->{'_totalLength'} = $2; | |||||||||||||||||||||||||||||||||||||||||
| 863 | } | ||||||||||||||||||||||||||||||||||||||||||
| 864 | |||||||||||||||||||||||||||||||||||||||||||
| 865 | 0 | ▶ | if($data =~ m!Frame = ([\d+-]+)!) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 866 | 0 | $self->frame($1); | |||||||||||||||||||||||||||||||||||||||||
| 867 | } | ||||||||||||||||||||||||||||||||||||||||||
| 868 | |||||||||||||||||||||||||||||||||||||||||||
| 869 | # Strand data is not always present in this line. | ||||||||||||||||||||||||||||||||||||||||||
| 870 | # _set_seq() will also set strand information. | ||||||||||||||||||||||||||||||||||||||||||
| 871 | 0 | ▶ | if($data =~ m!Strand = (\w+) / (\w+)!) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 872 | 0 | $self->{'_queryStrand'} = $1; | |||||||||||||||||||||||||||||||||||||||||
| 873 | 0 | $self->{'_sbjctStrand'} = $2; | |||||||||||||||||||||||||||||||||||||||||
| 874 | } | ||||||||||||||||||||||||||||||||||||||||||
| 875 | |||||||||||||||||||||||||||||||||||||||||||
| 876 | # if($data =~ m!Gaps = (\d+)/(\d+)!) { | ||||||||||||||||||||||||||||||||||||||||||
| 877 | # $self->{'_totalGaps'} = $1; | ||||||||||||||||||||||||||||||||||||||||||
| 878 | # } else { | ||||||||||||||||||||||||||||||||||||||||||
| 879 | # $self->{'_totalGaps'} = 0; | ||||||||||||||||||||||||||||||||||||||||||
| 880 | # } | ||||||||||||||||||||||||||||||||||||||||||
| 881 | } | ||||||||||||||||||||||||||||||||||||||||||
| 882 | |||||||||||||||||||||||||||||||||||||||||||
| 883 | |||||||||||||||||||||||||||||||||||||||||||
| 884 | |||||||||||||||||||||||||||||||||||||||||||
| 885 | =head2 _set_seq_data | ||||||||||||||||||||||||||||||||||||||||||
| 886 | |||||||||||||||||||||||||||||||||||||||||||
| 887 | Usage : called automatically when sequence data is requested. | ||||||||||||||||||||||||||||||||||||||||||
| 888 | Purpose : Sets the HSP sequence data for both query and sbjct sequences. | ||||||||||||||||||||||||||||||||||||||||||
| 889 | : Includes: start, stop, length, gaps, and raw sequence. | ||||||||||||||||||||||||||||||||||||||||||
| 890 | Argument : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 891 | Throws : Propagates any exception thrown by _set_match_seq() | ||||||||||||||||||||||||||||||||||||||||||
| 892 | Comments : Uses raw data stored by _set_data() during object construction. | ||||||||||||||||||||||||||||||||||||||||||
| 893 | : These data are not always needed, so it is conditionally | ||||||||||||||||||||||||||||||||||||||||||
| 894 | : executed only upon demand by methods such as gaps(), _set_residues(), | ||||||||||||||||||||||||||||||||||||||||||
| 895 | : etc. _set_seq() does the dirty work. | ||||||||||||||||||||||||||||||||||||||||||
| 896 | |||||||||||||||||||||||||||||||||||||||||||
| 897 | See Also : L</_set_seq> | ||||||||||||||||||||||||||||||||||||||||||
| 898 | |||||||||||||||||||||||||||||||||||||||||||
| 899 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 900 | |||||||||||||||||||||||||||||||||||||||||||
| 901 | #----------------- | ||||||||||||||||||||||||||||||||||||||||||
| 902 | 0 | ▶ | sub _set_seq_data { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
_set_seq_data: not called CC=1 SCAR=6.9
| |||||||||||||||||||||||||||||||||||||||||||
| 903 | #----------------- | ||||||||||||||||||||||||||||||||||||||||||
| 904 | 0 | my $self = shift; | |||||||||||||||||||||||||||||||||||||||||
| 905 | |||||||||||||||||||||||||||||||||||||||||||
| 906 | 0 | $self->_set_seq('query', @{$self->{'_queryList'}}); | |||||||||||||||||||||||||||||||||||||||||
| 907 | 0 | $self->_set_seq('sbjct', @{$self->{'_sbjctList'}}); | |||||||||||||||||||||||||||||||||||||||||
| 908 | |||||||||||||||||||||||||||||||||||||||||||
| 909 | # Liberate some memory. | ||||||||||||||||||||||||||||||||||||||||||
| 910 | 0 | @{$self->{'_queryList'}} = @{$self->{'_sbjctList'}} = (); | |||||||||||||||||||||||||||||||||||||||||
| 911 | 0 | undef $self->{'_queryList'}; | |||||||||||||||||||||||||||||||||||||||||
| 912 | 0 | undef $self->{'_sbjctList'}; | |||||||||||||||||||||||||||||||||||||||||
| 913 | |||||||||||||||||||||||||||||||||||||||||||
| 914 | 0 | $self->{'_set_seq_data'} = 1; | |||||||||||||||||||||||||||||||||||||||||
| 915 | } | ||||||||||||||||||||||||||||||||||||||||||
| 916 | |||||||||||||||||||||||||||||||||||||||||||
| 917 | |||||||||||||||||||||||||||||||||||||||||||
| 918 | |||||||||||||||||||||||||||||||||||||||||||
| 919 | =head2 _set_seq | ||||||||||||||||||||||||||||||||||||||||||
| 920 | |||||||||||||||||||||||||||||||||||||||||||
| 921 | Usage : called automatically by _set_seq_data() | ||||||||||||||||||||||||||||||||||||||||||
| 922 | : $hsp_obj->($seq_type, @data); | ||||||||||||||||||||||||||||||||||||||||||
| 923 | Purpose : Sets sequence information for both the query and sbjct sequences. | ||||||||||||||||||||||||||||||||||||||||||
| 924 | : Directly counts the number of gaps in each sequence (if gapped Blast). | ||||||||||||||||||||||||||||||||||||||||||
| 925 | Argument : $seq_type = 'query' or 'sbjct' | ||||||||||||||||||||||||||||||||||||||||||
| 926 | : @data = all seq lines with the form: | ||||||||||||||||||||||||||||||||||||||||||
| 927 | : Query: 61 SPHNVKDRKEQNGSINNAISPTATANTSGSQQINIDSALRDRSSNVAAQPSLSDASSGSN 120 | ||||||||||||||||||||||||||||||||||||||||||
| 928 | Throws : Exception if data strings cannot be parsed, probably due to a change | ||||||||||||||||||||||||||||||||||||||||||
| 929 | : in the Blast report format. | ||||||||||||||||||||||||||||||||||||||||||
| 930 | Comments : Uses first argument to determine which data members to set | ||||||||||||||||||||||||||||||||||||||||||
| 931 | : making this method sensitive data member name changes. | ||||||||||||||||||||||||||||||||||||||||||
| 932 | : Behavior is dependent on the type of BLAST analysis (TBLASTN, BLASTP, etc). | ||||||||||||||||||||||||||||||||||||||||||
| 933 | Warning : Sequence endpoints are normalized so that start < end. This affects HSPs | ||||||||||||||||||||||||||||||||||||||||||
| 934 | : for TBLASTN/X hits on the minus strand. Normalization facilitates use | ||||||||||||||||||||||||||||||||||||||||||
| 935 | : of range information by methods such as match(). | ||||||||||||||||||||||||||||||||||||||||||
| 936 | |||||||||||||||||||||||||||||||||||||||||||
| 937 | See Also : L</_set_seq_data>, L</matches>, L</range>, L</start>, L</end> | ||||||||||||||||||||||||||||||||||||||||||
| 938 | |||||||||||||||||||||||||||||||||||||||||||
| 939 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 940 | |||||||||||||||||||||||||||||||||||||||||||
| 941 | #------------- | ||||||||||||||||||||||||||||||||||||||||||
| 942 | 0 | ▶ | sub _set_seq { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
_set_seq: not called CC=16 SCAR=56.1
| |||||||||||||||||||||||||||||||||||||||||||
| 943 | #------------- | ||||||||||||||||||||||||||||||||||||||||||
| 944 | 0 | my $self = shift; | |||||||||||||||||||||||||||||||||||||||||
| 945 | 0 | my $seqType = shift; | |||||||||||||||||||||||||||||||||||||||||
| 946 | 0 | my @data = @_; | |||||||||||||||||||||||||||||||||||||||||
| 947 | 0 | my @ranges = (); | |||||||||||||||||||||||||||||||||||||||||
| 948 | 0 | my @sequence = (); | |||||||||||||||||||||||||||||||||||||||||
| 949 | 0 | my $numGaps = 0; | |||||||||||||||||||||||||||||||||||||||||
| 950 | |||||||||||||||||||||||||||||||||||||||||||
| 951 | 0 | foreach( @data ) { | |||||||||||||||||||||||||||||||||||||||||
| 952 | 0 | ▶ | if( m/(\d+) *([^\d\s]+) *(\d+)/) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 953 | 0 | push @ranges, ( $1, $3 ) ; | |||||||||||||||||||||||||||||||||||||||||
| 954 | 0 | push @sequence, $2; | |||||||||||||||||||||||||||||||||||||||||
| 955 | #print STDERR "_set_seq found sequence \"$2\"\n"; | ||||||||||||||||||||||||||||||||||||||||||
| 956 | } else { | ||||||||||||||||||||||||||||||||||||||||||
| 957 | 0 | $self->warn("Bad sequence data: $_"); | |||||||||||||||||||||||||||||||||||||||||
| 958 | } | ||||||||||||||||||||||||||||||||||||||||||
| 959 | } | ||||||||||||||||||||||||||||||||||||||||||
| 960 | |||||||||||||||||||||||||||||||||||||||||||
| 961 | 0 | ▶ | if( !(scalar(@sequence) and scalar(@ranges))) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/2
scalar @sequence and scalar @ranges
MC/DC0%0/1
scalar @sequence and scalar @ranges
scalar @sequence
Truth table0%0/2
A
A= scalar @sequence
| |||||||||||||||||||||||||||||||||||||||||||
| 962 | 0 | my $id_str = $self->_id_str; | |||||||||||||||||||||||||||||||||||||||||
| 963 | 0 | $self->throw("Can't set sequence: missing data. Possibly unrecognized Blast format. ($id_str)"); | |||||||||||||||||||||||||||||||||||||||||
| 964 | } | ||||||||||||||||||||||||||||||||||||||||||
| 965 | |||||||||||||||||||||||||||||||||||||||||||
| 966 | # Sensitive to member name changes. | ||||||||||||||||||||||||||||||||||||||||||
| 967 | 0 | $seqType = "_\L$seqType\E"; | |||||||||||||||||||||||||||||||||||||||||
| 968 | 0 | $self->{$seqType.'Start'} = $ranges[0]; | |||||||||||||||||||||||||||||||||||||||||
| 969 | 0 | $self->{$seqType.'Stop'} = $ranges[ $#ranges ]; | |||||||||||||||||||||||||||||||||||||||||
| 970 | 0 | $self->{$seqType.'Seq'} = \@sequence; | |||||||||||||||||||||||||||||||||||||||||
| 971 | |||||||||||||||||||||||||||||||||||||||||||
| 972 | 0 | $self->{$seqType.'Length'} = abs($ranges[ $#ranges ] - $ranges[0]) + 1; | |||||||||||||||||||||||||||||||||||||||||
| 973 | |||||||||||||||||||||||||||||||||||||||||||
| 974 | # Adjust lengths for BLASTX, TBLASTN, TBLASTX sequences | ||||||||||||||||||||||||||||||||||||||||||
| 975 | # Converting nucl coords to amino acid coords. | ||||||||||||||||||||||||||||||||||||||||||
| 976 | |||||||||||||||||||||||||||||||||||||||||||
| 977 | 0 | my $prog = $self->algorithm; | |||||||||||||||||||||||||||||||||||||||||
| 978 | 0 | ▶ | if($prog eq 'TBLASTN' and $seqType eq '_sbjct') { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 3 branches
Condition0%0/3
$prog eq "TBLASTN" and $seqType eq "_sbjct"
MC/DC0%0/2
$prog eq "TBLASTN" and $seqType eq "_sbjct"
$prog eq "TBLASTN"
$seqType eq "_sbjct"
Truth table0%0/3
A and B
A= $prog eq "TBLASTN"B= $seqType eq "_sbjct"
| |||||||||||||||||||||||||||||||||||||||||||
| 979 | 0 | $self->{$seqType.'Length'} /= 3; | |||||||||||||||||||||||||||||||||||||||||
| 980 | ▶ | } elsif($prog eq 'BLASTX' and $seqType eq '_query') { | |||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/3
$prog eq "BLASTX" and $seqType eq "_query"
MC/DC0%0/2
$prog eq "BLASTX" and $seqType eq "_query"
$prog eq "BLASTX"
$seqType eq "_query"
Truth table0%0/3
A and B
A= $prog eq "BLASTX"B= $seqType eq "_query"
| |||||||||||||||||||||||||||||||||||||||||||
| 981 | 0 | $self->{$seqType.'Length'} /= 3; | |||||||||||||||||||||||||||||||||||||||||
| 982 | } elsif($prog eq 'TBLASTX') { | ||||||||||||||||||||||||||||||||||||||||||
| 983 | 0 | $self->{$seqType.'Length'} /= 3; | |||||||||||||||||||||||||||||||||||||||||
| 984 | } | ||||||||||||||||||||||||||||||||||||||||||
| 985 | |||||||||||||||||||||||||||||||||||||||||||
| 986 | 0 | ▶ | if( $prog ne 'BLASTP' ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 987 | 0 | ▶ | $self->{$seqType.'Strand'} = 'Plus' if $prog =~ /BLASTN/; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 988 | 0 | ▶ | $self->{$seqType.'Strand'} = 'Plus' if ($prog =~ /BLASTX/ and $seqType eq '_query'); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$prog =~ /BLASTX/ and $seqType eq "_query"
MC/DC0%0/2
$prog =~ /BLASTX/ and $seqType eq "_query"
$prog =~ /BLASTX/
$seqType eq "_query"
Truth table0%0/3
A and B
A= $prog =~ /BLASTX/B= $seqType eq "_query"
| |||||||||||||||||||||||||||||||||||||||||||
| 989 | # Normalize sequence endpoints so that start < end. | ||||||||||||||||||||||||||||||||||||||||||
| 990 | # Reverse complement or 'minus strand' HSPs get flipped here. | ||||||||||||||||||||||||||||||||||||||||||
| 991 | 0 | ▶ | if($self->{$seqType.'Start'} > $self->{$seqType.'Stop'}) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 992 | ($self->{$seqType.'Start'}, $self->{$seqType.'Stop'}) = | ||||||||||||||||||||||||||||||||||||||||||
| 993 | 0 | ($self->{$seqType.'Stop'}, $self->{$seqType.'Start'}); | |||||||||||||||||||||||||||||||||||||||||
| 994 | 0 | $self->{$seqType.'Strand'} = 'Minus'; | |||||||||||||||||||||||||||||||||||||||||
| 995 | } | ||||||||||||||||||||||||||||||||||||||||||
| 996 | } | ||||||||||||||||||||||||||||||||||||||||||
| 997 | |||||||||||||||||||||||||||||||||||||||||||
| 998 | ## Count number of gaps in each seq. Only need to do this for gapped Blasts. | ||||||||||||||||||||||||||||||||||||||||||
| 999 | # if($self->{'_gapped'}) { | ||||||||||||||||||||||||||||||||||||||||||
| 1000 | 0 | my $seqstr = join('', @sequence); | |||||||||||||||||||||||||||||||||||||||||
| 1001 | 0 | $seqstr =~ s/\s//g; | |||||||||||||||||||||||||||||||||||||||||
| 1002 | 0 | my $num_gaps = CORE::length($seqstr) - $self->{$seqType.'Length'}; | |||||||||||||||||||||||||||||||||||||||||
| 1003 | 0 | ▶ | $self->{$seqType.'Gaps'} = $num_gaps if $num_gaps > 0; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1004 | # } | ||||||||||||||||||||||||||||||||||||||||||
| 1005 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1006 | |||||||||||||||||||||||||||||||||||||||||||
| 1007 | |||||||||||||||||||||||||||||||||||||||||||
| 1008 | =head2 _set_residues | ||||||||||||||||||||||||||||||||||||||||||
| 1009 | |||||||||||||||||||||||||||||||||||||||||||
| 1010 | Usage : called automatically when residue data is requested. | ||||||||||||||||||||||||||||||||||||||||||
| 1011 | Purpose : Sets the residue numbers representing the identical and | ||||||||||||||||||||||||||||||||||||||||||
| 1012 | : conserved positions. These data are obtained by analyzing the | ||||||||||||||||||||||||||||||||||||||||||
| 1013 | : symbols between query and sbjct lines of the alignments. | ||||||||||||||||||||||||||||||||||||||||||
| 1014 | Argument : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 1015 | Throws : Propagates any exception thrown by _set_seq_data() and _set_match_seq(). | ||||||||||||||||||||||||||||||||||||||||||
| 1016 | Comments : These data are not always needed, so it is conditionally | ||||||||||||||||||||||||||||||||||||||||||
| 1017 | : executed only upon demand by methods such as seq_inds(). | ||||||||||||||||||||||||||||||||||||||||||
| 1018 | : Behavior is dependent on the type of BLAST analysis (TBLASTN, BLASTP, etc). | ||||||||||||||||||||||||||||||||||||||||||
| 1019 | |||||||||||||||||||||||||||||||||||||||||||
| 1020 | See Also : L</_set_seq_data>, L</_set_match_seq>, L</seq_inds> | ||||||||||||||||||||||||||||||||||||||||||
| 1021 | |||||||||||||||||||||||||||||||||||||||||||
| 1022 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 1023 | |||||||||||||||||||||||||||||||||||||||||||
| 1024 | #------------------ | ||||||||||||||||||||||||||||||||||||||||||
| 1025 | 0 | ▶ | sub _set_residues { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
_set_residues: not called CC=15 SCAR=54.8
| |||||||||||||||||||||||||||||||||||||||||||
| 1026 | #------------------ | ||||||||||||||||||||||||||||||||||||||||||
| 1027 | 0 | my $self = shift; | |||||||||||||||||||||||||||||||||||||||||
| 1028 | 0 | my @sequence = (); | |||||||||||||||||||||||||||||||||||||||||
| 1029 | |||||||||||||||||||||||||||||||||||||||||||
| 1030 | 0 | ▶ | $self->_set_seq_data() unless $self->{'_set_seq_data'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1031 | |||||||||||||||||||||||||||||||||||||||||||
| 1032 | # Using hashes to avoid saving duplicate residue numbers. | ||||||||||||||||||||||||||||||||||||||||||
| 1033 | 0 | my %identicalList_query = (); | |||||||||||||||||||||||||||||||||||||||||
| 1034 | 0 | my %identicalList_sbjct = (); | |||||||||||||||||||||||||||||||||||||||||
| 1035 | 0 | my %conservedList_query = (); | |||||||||||||||||||||||||||||||||||||||||
| 1036 | 0 | my %conservedList_sbjct = (); | |||||||||||||||||||||||||||||||||||||||||
| 1037 | |||||||||||||||||||||||||||||||||||||||||||
| 1038 | 0 | ▶ | my $aref = $self->_set_match_seq() if not ref $self->{'_matchSeq'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1039 | 0 | ▶ | $aref ||= $self->{'_matchSeq'}; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/3
$aref ||= $self->{"_matchSeq"}
MC/DC0%0/2
$aref ||= $self->{"_matchSeq"}
$aref
$self->{"_matchSeq"}
Truth table0%0/3
A ||= B
A= $arefB= $self->{"_matchSeq"}
| |||||||||||||||||||||||||||||||||||||||||||
| 1040 | 0 | my $seqString = join('', @$aref ); | |||||||||||||||||||||||||||||||||||||||||
| 1041 | |||||||||||||||||||||||||||||||||||||||||||
| 1042 | 0 | my $qseq = join('',@{$self->{'_querySeq'}}); | |||||||||||||||||||||||||||||||||||||||||
| 1043 | 0 | my $sseq = join('',@{$self->{'_sbjctSeq'}}); | |||||||||||||||||||||||||||||||||||||||||
| 1044 | 0 | ▶ | my $resCount_query = $self->{'_queryStop'} || 0; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$self->{'_queryStop'} || 0
MC/DC0%0/1
$self->{'_queryStop'} || 0
$self->{'_queryStop'}
Truth table0%0/2
A
A= $self->{'_queryStop'}
| |||||||||||||||||||||||||||||||||||||||||||
| 1045 | 0 | ▶ | my $resCount_sbjct = $self->{'_sbjctStop'} || 0; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$self->{'_sbjctStop'} || 0
MC/DC0%0/1
$self->{'_sbjctStop'} || 0
$self->{'_sbjctStop'}
Truth table0%0/2
A
A= $self->{'_sbjctStop'}
| |||||||||||||||||||||||||||||||||||||||||||
| 1046 | |||||||||||||||||||||||||||||||||||||||||||
| 1047 | 0 | my $prog = $self->algorithm; | |||||||||||||||||||||||||||||||||||||||||
| 1048 | 0 | ▶ | if($prog !~ /^BLASTP|^BLASTN/) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1049 | 0 | ▶ | if($prog eq 'TBLASTN') { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 3 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 1050 | 0 | $resCount_sbjct /= 3; | |||||||||||||||||||||||||||||||||||||||||
| 1051 | } elsif($prog eq 'BLASTX') { | ||||||||||||||||||||||||||||||||||||||||||
| 1052 | 0 | $resCount_query /= 3; | |||||||||||||||||||||||||||||||||||||||||
| 1053 | } elsif($prog eq 'TBLASTX') { | ||||||||||||||||||||||||||||||||||||||||||
| 1054 | 0 | $resCount_query /= 3; | |||||||||||||||||||||||||||||||||||||||||
| 1055 | 0 | $resCount_sbjct /= 3; | |||||||||||||||||||||||||||||||||||||||||
| 1056 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1057 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1058 | |||||||||||||||||||||||||||||||||||||||||||
| 1059 | 0 | my ($mchar, $schar, $qchar); | |||||||||||||||||||||||||||||||||||||||||
| 1060 | 0 | ▶ | while( $mchar = chop($seqString) ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1061 | 0 | ($qchar, $schar) = (chop($qseq), chop($sseq)); | |||||||||||||||||||||||||||||||||||||||||
| 1062 | 0 | ▶ | if( $mchar eq '+' ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 2 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 1063 | 0 | $conservedList_query{ $resCount_query } = 1; | |||||||||||||||||||||||||||||||||||||||||
| 1064 | 0 | $conservedList_sbjct{ $resCount_sbjct } = 1; | |||||||||||||||||||||||||||||||||||||||||
| 1065 | } elsif( $mchar ne ' ' ) { | ||||||||||||||||||||||||||||||||||||||||||
| 1066 | 0 | $identicalList_query{ $resCount_query } = 1; | |||||||||||||||||||||||||||||||||||||||||
| 1067 | 0 | $identicalList_sbjct{ $resCount_sbjct } = 1; | |||||||||||||||||||||||||||||||||||||||||
| 1068 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1069 | 0 | ▶ | $resCount_query-- if $qchar ne $GAP_SYMBOL; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1070 | 0 | ▶ | $resCount_sbjct-- if $schar ne $GAP_SYMBOL; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1071 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1072 | 0 | $self->{'_identicalRes_query'} = \%identicalList_query; | |||||||||||||||||||||||||||||||||||||||||
| 1073 | 0 | $self->{'_conservedRes_query'} = \%conservedList_query; | |||||||||||||||||||||||||||||||||||||||||
| 1074 | 0 | $self->{'_identicalRes_sbjct'} = \%identicalList_sbjct; | |||||||||||||||||||||||||||||||||||||||||
| 1075 | 0 | $self->{'_conservedRes_sbjct'} = \%conservedList_sbjct; | |||||||||||||||||||||||||||||||||||||||||
| 1076 | |||||||||||||||||||||||||||||||||||||||||||
| 1077 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1078 | |||||||||||||||||||||||||||||||||||||||||||
| 1079 | |||||||||||||||||||||||||||||||||||||||||||
| 1080 | |||||||||||||||||||||||||||||||||||||||||||
| 1081 | |||||||||||||||||||||||||||||||||||||||||||
| 1082 | =head2 _set_match_seq | ||||||||||||||||||||||||||||||||||||||||||
| 1083 | |||||||||||||||||||||||||||||||||||||||||||
| 1084 | Usage : $hsp_obj->_set_match_seq() | ||||||||||||||||||||||||||||||||||||||||||
| 1085 | Purpose : Set the 'match' sequence for the current HSP (symbols in between | ||||||||||||||||||||||||||||||||||||||||||
| 1086 | : the query and sbjct lines.) | ||||||||||||||||||||||||||||||||||||||||||
| 1087 | Returns : Array reference holding the match sequences lines. | ||||||||||||||||||||||||||||||||||||||||||
| 1088 | Argument : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 1089 | Throws : Exception if the _matchList field is not set. | ||||||||||||||||||||||||||||||||||||||||||
| 1090 | Comments : The match information is not always necessary. This method | ||||||||||||||||||||||||||||||||||||||||||
| 1091 | : allows it to be conditionally prepared. | ||||||||||||||||||||||||||||||||||||||||||
| 1092 | : Called by _set_residues>() and seq_str(). | ||||||||||||||||||||||||||||||||||||||||||
| 1093 | |||||||||||||||||||||||||||||||||||||||||||
| 1094 | See Also : L</_set_residues>, L</seq_str> | ||||||||||||||||||||||||||||||||||||||||||
| 1095 | |||||||||||||||||||||||||||||||||||||||||||
| 1096 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 1097 | |||||||||||||||||||||||||||||||||||||||||||
| 1098 | #------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 1099 | 0 | ▶ | sub _set_match_seq { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
_set_match_seq: not called CC=3 SCAR=24.8
| |||||||||||||||||||||||||||||||||||||||||||
| 1100 | #------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 1101 | 0 | my $self = shift; | |||||||||||||||||||||||||||||||||||||||||
| 1102 | |||||||||||||||||||||||||||||||||||||||||||
| 1103 | 0 | ▶ | if( ! ref($self->{'_matchList'}) ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1104 | 0 | my $id_str = $self->_id_str; | |||||||||||||||||||||||||||||||||||||||||
| 1105 | 0 | $self->throw("Can't set HSP match sequence: No data ($id_str)"); | |||||||||||||||||||||||||||||||||||||||||
| 1106 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1107 | |||||||||||||||||||||||||||||||||||||||||||
| 1108 | 0 | my @data = @{$self->{'_matchList'}}; | |||||||||||||||||||||||||||||||||||||||||
| 1109 | |||||||||||||||||||||||||||||||||||||||||||
| 1110 | 0 | my(@sequence); | |||||||||||||||||||||||||||||||||||||||||
| 1111 | 0 | foreach( @data ) { | |||||||||||||||||||||||||||||||||||||||||
| 1112 | 0 | chomp($_); | |||||||||||||||||||||||||||||||||||||||||
| 1113 | ## Remove leading spaces; (note: aln may begin with a space | ||||||||||||||||||||||||||||||||||||||||||
| 1114 | ## which is why we can't use s/^ +//). | ||||||||||||||||||||||||||||||||||||||||||
| 1115 | 0 | s/^ {$self->{'_match_indent'}}//; | |||||||||||||||||||||||||||||||||||||||||
| 1116 | 0 | push @sequence, $_; | |||||||||||||||||||||||||||||||||||||||||
| 1117 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1118 | # Liberate some memory. | ||||||||||||||||||||||||||||||||||||||||||
| 1119 | 0 | @{$self->{'_matchList'}} = undef; | |||||||||||||||||||||||||||||||||||||||||
| 1120 | 0 | $self->{'_matchList'} = undef; | |||||||||||||||||||||||||||||||||||||||||
| 1121 | |||||||||||||||||||||||||||||||||||||||||||
| 1122 | 0 | $self->{'_matchSeq'} = \@sequence; | |||||||||||||||||||||||||||||||||||||||||
| 1123 | |||||||||||||||||||||||||||||||||||||||||||
| 1124 | 0 | return $self->{'_matchSeq'}; | |||||||||||||||||||||||||||||||||||||||||
| 1125 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1126 | |||||||||||||||||||||||||||||||||||||||||||
| 1127 | |||||||||||||||||||||||||||||||||||||||||||
| 1128 | =head2 n | ||||||||||||||||||||||||||||||||||||||||||
| 1129 | |||||||||||||||||||||||||||||||||||||||||||
| 1130 | Usage : $hsp_obj->n() | ||||||||||||||||||||||||||||||||||||||||||
| 1131 | Purpose : Get the N value (num HSPs on which P/Expect is based). | ||||||||||||||||||||||||||||||||||||||||||
| 1132 | : This value is not defined with NCBI Blast2 with gapping. | ||||||||||||||||||||||||||||||||||||||||||
| 1133 | Returns : Integer or null string if not defined. | ||||||||||||||||||||||||||||||||||||||||||
| 1134 | Argument : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 1135 | Throws : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 1136 | Comments : The 'N' value is listed in parenthesis with P/Expect value: | ||||||||||||||||||||||||||||||||||||||||||
| 1137 | : e.g., P(3) = 1.2e-30 ---> (N = 3). | ||||||||||||||||||||||||||||||||||||||||||
| 1138 | : Not defined in NCBI Blast2 with gaps. | ||||||||||||||||||||||||||||||||||||||||||
| 1139 | : This typically is equal to the number of HSPs but not always. | ||||||||||||||||||||||||||||||||||||||||||
| 1140 | : To obtain the number of HSPs, use Bio::Search::Hit::BlastHit::num_hsps(). | ||||||||||||||||||||||||||||||||||||||||||
| 1141 | |||||||||||||||||||||||||||||||||||||||||||
| 1142 | See Also : L<Bio::SeqFeature::SimilarityPair::score()|Bio::SeqFeature::SimilarityPair> | ||||||||||||||||||||||||||||||||||||||||||
| 1143 | |||||||||||||||||||||||||||||||||||||||||||
| 1144 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 1145 | |||||||||||||||||||||||||||||||||||||||||||
| 1146 | #----- | ||||||||||||||||||||||||||||||||||||||||||
| 1147 | 0 | ▶ | sub n { my $self = shift; $self->{'_n'} || ''; } | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
n: not called CC=2 SCAR=17.9
Pod
documented
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1148 | #----- | ||||||||||||||||||||||||||||||||||||||||||
| 1149 | |||||||||||||||||||||||||||||||||||||||||||
| 1150 | |||||||||||||||||||||||||||||||||||||||||||
| 1151 | =head2 matches | ||||||||||||||||||||||||||||||||||||||||||
| 1152 | |||||||||||||||||||||||||||||||||||||||||||
| 1153 | Usage : $hsp->matches([seq_type], [start], [stop]); | ||||||||||||||||||||||||||||||||||||||||||
| 1154 | Purpose : Get the total number of identical and conservative matches | ||||||||||||||||||||||||||||||||||||||||||
| 1155 | : in the query or sbjct sequence for the given HSP. Optionally can | ||||||||||||||||||||||||||||||||||||||||||
| 1156 | : report data within a defined interval along the seq. | ||||||||||||||||||||||||||||||||||||||||||
| 1157 | : (Note: 'conservative' matches are called 'positives' in the | ||||||||||||||||||||||||||||||||||||||||||
| 1158 | : Blast report.) | ||||||||||||||||||||||||||||||||||||||||||
| 1159 | Example : ($id,$cons) = $hsp_object->matches('hit'); | ||||||||||||||||||||||||||||||||||||||||||
| 1160 | : ($id,$cons) = $hsp_object->matches('query',300,400); | ||||||||||||||||||||||||||||||||||||||||||
| 1161 | Returns : 2-element array of integers | ||||||||||||||||||||||||||||||||||||||||||
| 1162 | Argument : (1) seq_type = 'query' or 'hit' or 'sbjct' (default = query) | ||||||||||||||||||||||||||||||||||||||||||
| 1163 | : ('sbjct' is synonymous with 'hit') | ||||||||||||||||||||||||||||||||||||||||||
| 1164 | : (2) start = Starting coordinate (optional) | ||||||||||||||||||||||||||||||||||||||||||
| 1165 | : (3) stop = Ending coordinate (optional) | ||||||||||||||||||||||||||||||||||||||||||
| 1166 | Throws : Exception if the supplied coordinates are out of range. | ||||||||||||||||||||||||||||||||||||||||||
| 1167 | Comments : Relies on seq_str('match') to get the string of alignment symbols | ||||||||||||||||||||||||||||||||||||||||||
| 1168 | : between the query and sbjct lines which are used for determining | ||||||||||||||||||||||||||||||||||||||||||
| 1169 | : the number of identical and conservative matches. | ||||||||||||||||||||||||||||||||||||||||||
| 1170 | |||||||||||||||||||||||||||||||||||||||||||
| 1171 | See Also : L</length>, L</gaps>, L</seq_str>, L<Bio::Search::Hit::BlastHit::_adjust_contigs()|Bio::Search::Hit::BlastHit> | ||||||||||||||||||||||||||||||||||||||||||
| 1172 | |||||||||||||||||||||||||||||||||||||||||||
| 1173 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 1174 | |||||||||||||||||||||||||||||||||||||||||||
| 1175 | #----------- | ||||||||||||||||||||||||||||||||||||||||||
| 1176 | 0 | ▶ | sub matches { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
matches: not called CC=16 SCAR=56.1
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1177 | #----------- | ||||||||||||||||||||||||||||||||||||||||||
| 1178 | 0 | my( $self, %param ) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1179 | 0 | my(@data); | |||||||||||||||||||||||||||||||||||||||||
| 1180 | 0 | my($seqType, $beg, $end) = ($param{-SEQ}, $param{-START}, $param{-STOP}); | |||||||||||||||||||||||||||||||||||||||||
| 1181 | 0 | ▶ | $seqType ||= 'query'; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$seqType ||= "query"
MC/DC0%0/1
$seqType ||= "query"
$seqType
Truth table0%0/2
A
A= $seqType
| |||||||||||||||||||||||||||||||||||||||||||
| 1182 | 0 | ▶ | $seqType = 'sbjct' if $seqType eq 'hit'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1183 | |||||||||||||||||||||||||||||||||||||||||||
| 1184 | 0 | my($start,$stop); | |||||||||||||||||||||||||||||||||||||||||
| 1185 | |||||||||||||||||||||||||||||||||||||||||||
| 1186 | 0 | ▶ | if(!defined $beg && !defined $end) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
defined $beg || defined $end
MC/DC0%0/2
defined $beg || defined $end
defined $beg
defined $end
Truth table0%0/3
A || B
A= defined $begB= defined $end
| |||||||||||||||||||||||||||||||||||||||||||
| 1187 | ## Get data for the whole alignment. | ||||||||||||||||||||||||||||||||||||||||||
| 1188 | 0 | push @data, ($self->{'_numIdentical'}, $self->{'_numConserved'}); | |||||||||||||||||||||||||||||||||||||||||
| 1189 | } else { | ||||||||||||||||||||||||||||||||||||||||||
| 1190 | ## Get the substring representing the desired sub-section of aln. | ||||||||||||||||||||||||||||||||||||||||||
| 1191 | 0 | ▶ | $beg ||= 0; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$beg ||= 0
MC/DC0%0/1
$beg ||= 0
$beg
Truth table0%0/2
A
A= $beg
| |||||||||||||||||||||||||||||||||||||||||||
| 1192 | 0 | ▶ | $end ||= 0; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$end ||= 0
MC/DC0%0/1
$end ||= 0
$end
Truth table0%0/2
A
A= $end
| |||||||||||||||||||||||||||||||||||||||||||
| 1193 | 0 | ($start,$stop) = $self->range($seqType); | |||||||||||||||||||||||||||||||||||||||||
| 1194 | 0 | ▶ | if($beg == 0) { $beg = $start; $end = $beg+$end; } | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 2 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 1195 | 0 | elsif($end == 0) { $end = $stop; $beg = $end-$beg; } | |||||||||||||||||||||||||||||||||||||||||
| 1196 | |||||||||||||||||||||||||||||||||||||||||||
| 1197 | 0 | ▶ | if($end >= $stop) { $end = $stop; } ##ML changed from if (end >stop) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1198 | 0 | else { $end += 1;} ##ML moved from commented position below, makes | |||||||||||||||||||||||||||||||||||||||||
| 1199 | ##more sense here | ||||||||||||||||||||||||||||||||||||||||||
| 1200 | # if($end > $stop) { $end = $stop; } | ||||||||||||||||||||||||||||||||||||||||||
| 1201 | 0 | ▶ | if($beg < $start) { $beg = $start; } | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1202 | # else { $end += 1;} | ||||||||||||||||||||||||||||||||||||||||||
| 1203 | |||||||||||||||||||||||||||||||||||||||||||
| 1204 | # my $seq = substr($self->seq_str('match'), $beg-$start, ($end-$beg)); | ||||||||||||||||||||||||||||||||||||||||||
| 1205 | |||||||||||||||||||||||||||||||||||||||||||
| 1206 | ## ML: START fix for substr out of range error ------------------ | ||||||||||||||||||||||||||||||||||||||||||
| 1207 | 0 | my $seq = ""; | |||||||||||||||||||||||||||||||||||||||||
| 1208 | 0 | my $prog = $self->algorithm; | |||||||||||||||||||||||||||||||||||||||||
| 1209 | 0 | ▶ | if (($prog eq 'TBLASTN') and ($seqType eq 'sbjct')) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 2 branches
Condition0%0/3
$prog eq "TBLASTN" and $seqType eq "sbjct"
MC/DC0%0/2
$prog eq "TBLASTN" and $seqType eq "sbjct"
$prog eq "TBLASTN"
$seqType eq "sbjct"
Truth table0%0/3
A and B
A= $prog eq "TBLASTN"B= $seqType eq "sbjct"
| |||||||||||||||||||||||||||||||||||||||||||
| 1210 | { | ||||||||||||||||||||||||||||||||||||||||||
| 1211 | 0 | $seq = substr($self->seq_str('match'), | |||||||||||||||||||||||||||||||||||||||||
| 1212 | int(($beg-$start)/3), int(($end-$beg+1)/3)); | ||||||||||||||||||||||||||||||||||||||||||
| 1213 | |||||||||||||||||||||||||||||||||||||||||||
| 1214 | ▶ | } elsif (($prog eq 'BLASTX') and ($seqType eq 'query')) | |||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/3
$prog eq "BLASTX" and $seqType eq "query"
MC/DC0%0/2
$prog eq "BLASTX" and $seqType eq "query"
$prog eq "BLASTX"
$seqType eq "query"
Truth table0%0/3
A and B
A= $prog eq "BLASTX"B= $seqType eq "query"
| |||||||||||||||||||||||||||||||||||||||||||
| 1215 | { | ||||||||||||||||||||||||||||||||||||||||||
| 1216 | 0 | $seq = substr($self->seq_str('match'), | |||||||||||||||||||||||||||||||||||||||||
| 1217 | int(($beg-$start)/3), int(($end-$beg+1)/3)); | ||||||||||||||||||||||||||||||||||||||||||
| 1218 | } else { | ||||||||||||||||||||||||||||||||||||||||||
| 1219 | 0 | $seq = substr($self->seq_str('match'), | |||||||||||||||||||||||||||||||||||||||||
| 1220 | $beg-$start, ($end-$beg)); | ||||||||||||||||||||||||||||||||||||||||||
| 1221 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1222 | ## ML: End of fix for substr out of range error ----------------- | ||||||||||||||||||||||||||||||||||||||||||
| 1223 | |||||||||||||||||||||||||||||||||||||||||||
| 1224 | |||||||||||||||||||||||||||||||||||||||||||
| 1225 | ## ML: debugging code | ||||||||||||||||||||||||||||||||||||||||||
| 1226 | ## This is where we get our exception. Try printing out the values going | ||||||||||||||||||||||||||||||||||||||||||
| 1227 | ## into this: | ||||||||||||||||||||||||||||||||||||||||||
| 1228 | ## | ||||||||||||||||||||||||||||||||||||||||||
| 1229 | # print STDERR | ||||||||||||||||||||||||||||||||||||||||||
| 1230 | # qq(*------------MY EXCEPTION --------------------\nSeq: ") , | ||||||||||||||||||||||||||||||||||||||||||
| 1231 | # $self->seq_str("$seqType"), qq("\n),$self->rank,",( index:"; | ||||||||||||||||||||||||||||||||||||||||||
| 1232 | # print STDERR $beg-$start, ", len: ", $end-$beg," ), (HSPRealLen:", | ||||||||||||||||||||||||||||||||||||||||||
| 1233 | # CORE::length $self->seq_str("$seqType"); | ||||||||||||||||||||||||||||||||||||||||||
| 1234 | # print STDERR ", HSPCalcLen: ", $stop - $start +1 ," ), | ||||||||||||||||||||||||||||||||||||||||||
| 1235 | # ( beg: $beg, end: $end ), ( start: $start, stop: stop )\n"; | ||||||||||||||||||||||||||||||||||||||||||
| 1236 | ## ML: END DEBUGGING CODE---------- | ||||||||||||||||||||||||||||||||||||||||||
| 1237 | |||||||||||||||||||||||||||||||||||||||||||
| 1238 | 0 | ▶ | if(!CORE::length $seq) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1239 | 0 | my $id_str = $self->_id_str; | |||||||||||||||||||||||||||||||||||||||||
| 1240 | 0 | $self->throw("Undefined $seqType sub-sequence ($beg,$end). Valid range = $start - $stop ($id_str)"); | |||||||||||||||||||||||||||||||||||||||||
| 1241 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1242 | ## Get data for a substring. | ||||||||||||||||||||||||||||||||||||||||||
| 1243 | # printf "Collecting HSP subsection data: beg,end = %d,%d; start,stop = %d,%d\n%s<---\n", $beg, $end, $start, $stop, $seq; | ||||||||||||||||||||||||||||||||||||||||||
| 1244 | # printf "Original match seq:\n%s\n",$self->seq_str('match'); | ||||||||||||||||||||||||||||||||||||||||||
| 1245 | 0 | $seq =~ s/ //g; # remove space (no info). | |||||||||||||||||||||||||||||||||||||||||
| 1246 | 0 | my $len_cons = CORE::length $seq; | |||||||||||||||||||||||||||||||||||||||||
| 1247 | 0 | $seq =~ s/\+//g; # remove '+' characters (conservative substitutions) | |||||||||||||||||||||||||||||||||||||||||
| 1248 | 0 | my $len_id = CORE::length $seq; | |||||||||||||||||||||||||||||||||||||||||
| 1249 | 0 | push @data, ($len_id, $len_cons); | |||||||||||||||||||||||||||||||||||||||||
| 1250 | # printf " HSP = %s\n id = %d; cons = %d\n", $self->rank, $len_id, $len_cons; <STDIN>; | ||||||||||||||||||||||||||||||||||||||||||
| 1251 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1252 | 0 | @data; | |||||||||||||||||||||||||||||||||||||||||
| 1253 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1254 | |||||||||||||||||||||||||||||||||||||||||||
| 1255 | |||||||||||||||||||||||||||||||||||||||||||
| 1256 | =head2 num_identical | ||||||||||||||||||||||||||||||||||||||||||
| 1257 | |||||||||||||||||||||||||||||||||||||||||||
| 1258 | Usage : $hsp_object->num_identical(); | ||||||||||||||||||||||||||||||||||||||||||
| 1259 | Purpose : Get the number of identical positions within the given HSP. | ||||||||||||||||||||||||||||||||||||||||||
| 1260 | Example : $num_iden = $hsp_object->num_identical(); | ||||||||||||||||||||||||||||||||||||||||||
| 1261 | Returns : integer | ||||||||||||||||||||||||||||||||||||||||||
| 1262 | Argument : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 1263 | Throws : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 1264 | |||||||||||||||||||||||||||||||||||||||||||
| 1265 | See Also : L</num_conserved>, L</frac_identical> | ||||||||||||||||||||||||||||||||||||||||||
| 1266 | |||||||||||||||||||||||||||||||||||||||||||
| 1267 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 1268 | |||||||||||||||||||||||||||||||||||||||||||
| 1269 | #------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 1270 | 0 | ▶ | sub num_identical { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
num_identical: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1271 | #------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 1272 | 0 | my( $self) = shift; | |||||||||||||||||||||||||||||||||||||||||
| 1273 | |||||||||||||||||||||||||||||||||||||||||||
| 1274 | 0 | $self->{'_numIdentical'}; | |||||||||||||||||||||||||||||||||||||||||
| 1275 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1276 | |||||||||||||||||||||||||||||||||||||||||||
| 1277 | |||||||||||||||||||||||||||||||||||||||||||
| 1278 | =head2 num_conserved | ||||||||||||||||||||||||||||||||||||||||||
| 1279 | |||||||||||||||||||||||||||||||||||||||||||
| 1280 | Usage : $hsp_object->num_conserved(); | ||||||||||||||||||||||||||||||||||||||||||
| 1281 | Purpose : Get the number of conserved positions within the given HSP. | ||||||||||||||||||||||||||||||||||||||||||
| 1282 | Example : $num_iden = $hsp_object->num_conserved(); | ||||||||||||||||||||||||||||||||||||||||||
| 1283 | Returns : integer | ||||||||||||||||||||||||||||||||||||||||||
| 1284 | Argument : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 1285 | Throws : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 1286 | |||||||||||||||||||||||||||||||||||||||||||
| 1287 | See Also : L</num_identical>, L</frac_conserved> | ||||||||||||||||||||||||||||||||||||||||||
| 1288 | |||||||||||||||||||||||||||||||||||||||||||
| 1289 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 1290 | |||||||||||||||||||||||||||||||||||||||||||
| 1291 | #------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 1292 | 0 | ▶ | sub num_conserved { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
num_conserved: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1293 | #------------------- | ||||||||||||||||||||||||||||||||||||||||||
| 1294 | 0 | my( $self) = shift; | |||||||||||||||||||||||||||||||||||||||||
| 1295 | |||||||||||||||||||||||||||||||||||||||||||
| 1296 | 0 | $self->{'_numConserved'}; | |||||||||||||||||||||||||||||||||||||||||
| 1297 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1298 | |||||||||||||||||||||||||||||||||||||||||||
| 1299 | |||||||||||||||||||||||||||||||||||||||||||
| 1300 | |||||||||||||||||||||||||||||||||||||||||||
| 1301 | =head2 range | ||||||||||||||||||||||||||||||||||||||||||
| 1302 | |||||||||||||||||||||||||||||||||||||||||||
| 1303 | Usage : $hsp->range( [seq_type] ); | ||||||||||||||||||||||||||||||||||||||||||
| 1304 | Purpose : Gets the (start, end) coordinates for the query or sbjct sequence | ||||||||||||||||||||||||||||||||||||||||||
| 1305 | : in the HSP alignment. | ||||||||||||||||||||||||||||||||||||||||||
| 1306 | Example : ($query_beg, $query_end) = $hsp->range('query'); | ||||||||||||||||||||||||||||||||||||||||||
| 1307 | : ($hit_beg, $hit_end) = $hsp->range('hit'); | ||||||||||||||||||||||||||||||||||||||||||
| 1308 | Returns : Two-element array of integers | ||||||||||||||||||||||||||||||||||||||||||
| 1309 | Argument : seq_type = string, 'query' or 'hit' or 'sbjct' (default = 'query') | ||||||||||||||||||||||||||||||||||||||||||
| 1310 | : ('sbjct' is synonymous with 'hit') | ||||||||||||||||||||||||||||||||||||||||||
| 1311 | Throws : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 1312 | |||||||||||||||||||||||||||||||||||||||||||
| 1313 | See Also : L</start>, L</end> | ||||||||||||||||||||||||||||||||||||||||||
| 1314 | |||||||||||||||||||||||||||||||||||||||||||
| 1315 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 1316 | |||||||||||||||||||||||||||||||||||||||||||
| 1317 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 1318 | 0 | ▶ | sub range { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
range: not called CC=4 SCAR=30.0
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1319 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 1320 | 0 | my ($self, $seqType) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1321 | |||||||||||||||||||||||||||||||||||||||||||
| 1322 | 0 | ▶ | $self->_set_seq_data() unless $self->{'_set_seq_data'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1323 | |||||||||||||||||||||||||||||||||||||||||||
| 1324 | 0 | ▶ | $seqType ||= 'query'; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$seqType ||= "query"
MC/DC0%0/1
$seqType ||= "query"
$seqType
Truth table0%0/2
A
A= $seqType
| |||||||||||||||||||||||||||||||||||||||||||
| 1325 | 0 | ▶ | $seqType = 'sbjct' if $seqType eq 'hit'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1326 | |||||||||||||||||||||||||||||||||||||||||||
| 1327 | ## Sensitive to member name changes. | ||||||||||||||||||||||||||||||||||||||||||
| 1328 | 0 | $seqType = "_\L$seqType\E"; | |||||||||||||||||||||||||||||||||||||||||
| 1329 | |||||||||||||||||||||||||||||||||||||||||||
| 1330 | 0 | return ($self->{$seqType.'Start'},$self->{$seqType.'Stop'}); | |||||||||||||||||||||||||||||||||||||||||
| 1331 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1332 | |||||||||||||||||||||||||||||||||||||||||||
| 1333 | =head2 start | ||||||||||||||||||||||||||||||||||||||||||
| 1334 | |||||||||||||||||||||||||||||||||||||||||||
| 1335 | Usage : $hsp->start( [seq_type] ); | ||||||||||||||||||||||||||||||||||||||||||
| 1336 | Purpose : Gets the start coordinate for the query, sbjct, or both sequences | ||||||||||||||||||||||||||||||||||||||||||
| 1337 | : in the HSP alignment. | ||||||||||||||||||||||||||||||||||||||||||
| 1338 | : NOTE: Start will always be less than end. | ||||||||||||||||||||||||||||||||||||||||||
| 1339 | : To determine strand, use $hsp->strand() | ||||||||||||||||||||||||||||||||||||||||||
| 1340 | Example : $query_beg = $hsp->start('query'); | ||||||||||||||||||||||||||||||||||||||||||
| 1341 | : $hit_beg = $hsp->start('hit'); | ||||||||||||||||||||||||||||||||||||||||||
| 1342 | : ($query_beg, $hit_beg) = $hsp->start(); | ||||||||||||||||||||||||||||||||||||||||||
| 1343 | Returns : scalar context: integer | ||||||||||||||||||||||||||||||||||||||||||
| 1344 | : array context without args: list of two integers | ||||||||||||||||||||||||||||||||||||||||||
| 1345 | Argument : In scalar context: seq_type = 'query' or 'hit' or 'sbjct' (default= 'query') | ||||||||||||||||||||||||||||||||||||||||||
| 1346 | : ('sbjct' is synonymous with 'hit') | ||||||||||||||||||||||||||||||||||||||||||
| 1347 | : Array context can be "induced" by providing an argument of 'list' or 'array'. | ||||||||||||||||||||||||||||||||||||||||||
| 1348 | Throws : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 1349 | |||||||||||||||||||||||||||||||||||||||||||
| 1350 | See Also : L</end>, L</range> | ||||||||||||||||||||||||||||||||||||||||||
| 1351 | |||||||||||||||||||||||||||||||||||||||||||
| 1352 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 1353 | |||||||||||||||||||||||||||||||||||||||||||
| 1354 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 1355 | 0 | ▶ | sub start { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
start: not called CC=6 SCAR=37.4
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1356 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 1357 | 0 | my ($self, $seqType) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1358 | |||||||||||||||||||||||||||||||||||||||||||
| 1359 | 0 | ▶ | $seqType ||= (wantarray ? 'list' : 'query'); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$seqType ||= wantarray ? "list" : "query"
MC/DC0%0/2
$seqType ||= wantarray ? "list" : "query"
$seqType
wantarray ? "list" : "query"
Truth table0%0/3
A ||= B
A= $seqTypeB= wantarray ? "list" : "query"
| |||||||||||||||||||||||||||||||||||||||||||
| 1360 | 0 | ▶ | $seqType = 'sbjct' if $seqType eq 'hit'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1361 | |||||||||||||||||||||||||||||||||||||||||||
| 1362 | 0 | ▶ | $self->_set_seq_data() unless $self->{'_set_seq_data'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1363 | |||||||||||||||||||||||||||||||||||||||||||
| 1364 | 0 | ▶ | if($seqType =~ /list|array/i) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1365 | 0 | return ($self->{'_queryStart'}, $self->{'_sbjctStart'}); | |||||||||||||||||||||||||||||||||||||||||
| 1366 | } else { | ||||||||||||||||||||||||||||||||||||||||||
| 1367 | ## Sensitive to member name changes. | ||||||||||||||||||||||||||||||||||||||||||
| 1368 | 0 | $seqType = "_\L$seqType\E"; | |||||||||||||||||||||||||||||||||||||||||
| 1369 | 0 | return $self->{$seqType.'Start'}; | |||||||||||||||||||||||||||||||||||||||||
| 1370 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1371 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1372 | |||||||||||||||||||||||||||||||||||||||||||
| 1373 | =head2 end | ||||||||||||||||||||||||||||||||||||||||||
| 1374 | |||||||||||||||||||||||||||||||||||||||||||
| 1375 | Usage : $hsp->end( [seq_type] ); | ||||||||||||||||||||||||||||||||||||||||||
| 1376 | Purpose : Gets the end coordinate for the query, sbjct, or both sequences | ||||||||||||||||||||||||||||||||||||||||||
| 1377 | : in the HSP alignment. | ||||||||||||||||||||||||||||||||||||||||||
| 1378 | : NOTE: Start will always be less than end. | ||||||||||||||||||||||||||||||||||||||||||
| 1379 | : To determine strand, use $hsp->strand() | ||||||||||||||||||||||||||||||||||||||||||
| 1380 | Example : $query_end = $hsp->end('query'); | ||||||||||||||||||||||||||||||||||||||||||
| 1381 | : $hit_end = $hsp->end('hit'); | ||||||||||||||||||||||||||||||||||||||||||
| 1382 | : ($query_end, $hit_end) = $hsp->end(); | ||||||||||||||||||||||||||||||||||||||||||
| 1383 | Returns : scalar context: integer | ||||||||||||||||||||||||||||||||||||||||||
| 1384 | : array context without args: list of two integers | ||||||||||||||||||||||||||||||||||||||||||
| 1385 | Argument : In scalar context: seq_type = 'query' or 'hit' or 'sbjct' (default= 'query') | ||||||||||||||||||||||||||||||||||||||||||
| 1386 | : ('sbjct' is synonymous with 'hit') | ||||||||||||||||||||||||||||||||||||||||||
| 1387 | : Array context can be "induced" by providing an argument of 'list' or 'array'. | ||||||||||||||||||||||||||||||||||||||||||
| 1388 | Throws : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 1389 | |||||||||||||||||||||||||||||||||||||||||||
| 1390 | See Also : L</start>, L</range>, L</strand> | ||||||||||||||||||||||||||||||||||||||||||
| 1391 | |||||||||||||||||||||||||||||||||||||||||||
| 1392 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 1393 | |||||||||||||||||||||||||||||||||||||||||||
| 1394 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 1395 | 0 | ▶ | sub end { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
end: not called CC=6 SCAR=37.4
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1396 | #---------- | ||||||||||||||||||||||||||||||||||||||||||
| 1397 | 0 | my ($self, $seqType) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1398 | |||||||||||||||||||||||||||||||||||||||||||
| 1399 | 0 | ▶ | $seqType ||= (wantarray ? 'list' : 'query'); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$seqType ||= wantarray ? "list" : "query"
MC/DC0%0/2
$seqType ||= wantarray ? "list" : "query"
$seqType
wantarray ? "list" : "query"
Truth table0%0/3
A ||= B
A= $seqTypeB= wantarray ? "list" : "query"
| |||||||||||||||||||||||||||||||||||||||||||
| 1400 | 0 | ▶ | $seqType = 'sbjct' if $seqType eq 'hit'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1401 | |||||||||||||||||||||||||||||||||||||||||||
| 1402 | 0 | ▶ | $self->_set_seq_data() unless $self->{'_set_seq_data'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1403 | |||||||||||||||||||||||||||||||||||||||||||
| 1404 | 0 | ▶ | if($seqType =~ /list|array/i) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1405 | 0 | return ($self->{'_queryStop'}, $self->{'_sbjctStop'}); | |||||||||||||||||||||||||||||||||||||||||
| 1406 | } else { | ||||||||||||||||||||||||||||||||||||||||||
| 1407 | ## Sensitive to member name changes. | ||||||||||||||||||||||||||||||||||||||||||
| 1408 | 0 | $seqType = "_\L$seqType\E"; | |||||||||||||||||||||||||||||||||||||||||
| 1409 | 0 | return $self->{$seqType.'Stop'}; | |||||||||||||||||||||||||||||||||||||||||
| 1410 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1411 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1412 | |||||||||||||||||||||||||||||||||||||||||||
| 1413 | |||||||||||||||||||||||||||||||||||||||||||
| 1414 | |||||||||||||||||||||||||||||||||||||||||||
| 1415 | =head2 strand | ||||||||||||||||||||||||||||||||||||||||||
| 1416 | |||||||||||||||||||||||||||||||||||||||||||
| 1417 | Usage : $hsp_object->strand( [seq_type] ) | ||||||||||||||||||||||||||||||||||||||||||
| 1418 | Purpose : Get the strand of the query or sbjct sequence. | ||||||||||||||||||||||||||||||||||||||||||
| 1419 | Example : print $hsp->strand('query'); | ||||||||||||||||||||||||||||||||||||||||||
| 1420 | : ($query_strand, $hit_strand) = $hsp->strand(); | ||||||||||||||||||||||||||||||||||||||||||
| 1421 | Returns : -1, 0, or 1 | ||||||||||||||||||||||||||||||||||||||||||
| 1422 | : -1 = Minus strand, +1 = Plus strand | ||||||||||||||||||||||||||||||||||||||||||
| 1423 | : Returns 0 if strand is not defined, which occurs | ||||||||||||||||||||||||||||||||||||||||||
| 1424 | : for BLASTP reports, and the query of TBLASTN | ||||||||||||||||||||||||||||||||||||||||||
| 1425 | : as well as the hit if BLASTX reports. | ||||||||||||||||||||||||||||||||||||||||||
| 1426 | : In scalar context without arguments, returns queryStrand value. | ||||||||||||||||||||||||||||||||||||||||||
| 1427 | : In array context without arguments, returns a two-element list | ||||||||||||||||||||||||||||||||||||||||||
| 1428 | : of strings (queryStrand, sbjctStrand). | ||||||||||||||||||||||||||||||||||||||||||
| 1429 | : Array context can be "induced" by providing an argument of 'list' or 'array'. | ||||||||||||||||||||||||||||||||||||||||||
| 1430 | Argument : seq_type: 'query' or 'hit' or 'sbjct' or undef | ||||||||||||||||||||||||||||||||||||||||||
| 1431 | : ('sbjct' is synonymous with 'hit') | ||||||||||||||||||||||||||||||||||||||||||
| 1432 | Throws : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 1433 | |||||||||||||||||||||||||||||||||||||||||||
| 1434 | See Also : L</_set_seq>, L</_set_match_stats> | ||||||||||||||||||||||||||||||||||||||||||
| 1435 | |||||||||||||||||||||||||||||||||||||||||||
| 1436 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 1437 | |||||||||||||||||||||||||||||||||||||||||||
| 1438 | #----------- | ||||||||||||||||||||||||||||||||||||||||||
| 1439 | 0 | ▶ | sub strand { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
strand: not called CC=15 SCAR=54.8
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1440 | #----------- | ||||||||||||||||||||||||||||||||||||||||||
| 1441 | 0 | my( $self, $seqType ) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1442 | |||||||||||||||||||||||||||||||||||||||||||
| 1443 | 0 | ▶ | $seqType ||= (wantarray ? 'list' : 'query'); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$seqType ||= wantarray ? "list" : "query"
MC/DC0%0/2
$seqType ||= wantarray ? "list" : "query"
$seqType
wantarray ? "list" : "query"
Truth table0%0/3
A ||= B
A= $seqTypeB= wantarray ? "list" : "query"
| |||||||||||||||||||||||||||||||||||||||||||
| 1444 | 0 | ▶ | $seqType = 'sbjct' if $seqType eq 'hit'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1445 | |||||||||||||||||||||||||||||||||||||||||||
| 1446 | ## Sensitive to member name format. | ||||||||||||||||||||||||||||||||||||||||||
| 1447 | 0 | $seqType = "_\L$seqType\E"; | |||||||||||||||||||||||||||||||||||||||||
| 1448 | |||||||||||||||||||||||||||||||||||||||||||
| 1449 | # $seqType could be '_list'. | ||||||||||||||||||||||||||||||||||||||||||
| 1450 | 0 | ▶ | $self->{'_queryStrand'} or $self->_set_seq_data() unless $self->{'_set_seq_data'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/6
$self->{'_set_seq_data'} || ($self->{'_queryStrand'} || $self->_set_seq_data)
$self->{"_queryStrand"} or $self->_set_seq_data
MC/DC0%0/3
$self->{'_set_seq_data'} || ($self->{'_queryStrand'} || $self->_set_seq_data)
$self->{'_set_seq_data'}
$self->{"_queryStrand"}
$self->_set_seq_data
Truth table0%0/4
A || B or C
A= $self->{'_set_seq_data'}B= $self->{"_queryStrand"}C= $self->_set_seq_data
| |||||||||||||||||||||||||||||||||||||||||||
| 1451 | |||||||||||||||||||||||||||||||||||||||||||
| 1452 | 0 | my $prog = $self->algorithm; | |||||||||||||||||||||||||||||||||||||||||
| 1453 | |||||||||||||||||||||||||||||||||||||||||||
| 1454 | 0 | ▶ | if($seqType =~ /list|array/i) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1455 | 0 | my ($qstr, $hstr); | |||||||||||||||||||||||||||||||||||||||||
| 1456 | 0 | ▶ | if( $prog eq 'BLASTP') { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 3 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 1457 | 0 | $qstr = 0; | |||||||||||||||||||||||||||||||||||||||||
| 1458 | 0 | $hstr = 0; | |||||||||||||||||||||||||||||||||||||||||
| 1459 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1460 | elsif( $prog eq 'TBLASTN') { | ||||||||||||||||||||||||||||||||||||||||||
| 1461 | 0 | $qstr = 0; | |||||||||||||||||||||||||||||||||||||||||
| 1462 | 0 | $hstr = $STRAND_SYMBOL{$self->{'_sbjctStrand'}}; | |||||||||||||||||||||||||||||||||||||||||
| 1463 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1464 | elsif( $prog eq 'BLASTX') { | ||||||||||||||||||||||||||||||||||||||||||
| 1465 | 0 | $qstr = $STRAND_SYMBOL{$self->{'_queryStrand'}}; | |||||||||||||||||||||||||||||||||||||||||
| 1466 | 0 | $hstr = 0; | |||||||||||||||||||||||||||||||||||||||||
| 1467 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1468 | else { | ||||||||||||||||||||||||||||||||||||||||||
| 1469 | 0 | ▶ | $qstr = $STRAND_SYMBOL{$self->{'_queryStrand'}} if defined $self->{'_queryStrand'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1470 | 0 | ▶ | $hstr = $STRAND_SYMBOL{$self->{'_sbjctStrand'}} if defined $self->{'_sbjctStrand'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1471 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1472 | 0 | ▶ | $qstr ||= 0; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$qstr ||= 0
MC/DC0%0/1
$qstr ||= 0
$qstr
Truth table0%0/2
A
A= $qstr
| |||||||||||||||||||||||||||||||||||||||||||
| 1473 | 0 | ▶ | $hstr ||= 0; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$hstr ||= 0
MC/DC0%0/1
$hstr ||= 0
$hstr
Truth table0%0/2
A
A= $hstr
| |||||||||||||||||||||||||||||||||||||||||||
| 1474 | 0 | return ($qstr, $hstr); | |||||||||||||||||||||||||||||||||||||||||
| 1475 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1476 | 0 | local $^W = 0; | |||||||||||||||||||||||||||||||||||||||||
| 1477 | 0 | ▶ | $STRAND_SYMBOL{$self->{$seqType.'Strand'}} || 0; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1478 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1479 | |||||||||||||||||||||||||||||||||||||||||||
| 1480 | |||||||||||||||||||||||||||||||||||||||||||
| 1481 | =head2 seq | ||||||||||||||||||||||||||||||||||||||||||
| 1482 | |||||||||||||||||||||||||||||||||||||||||||
| 1483 | Usage : $hsp->seq( [seq_type] ); | ||||||||||||||||||||||||||||||||||||||||||
| 1484 | Purpose : Get the query or sbjct sequence as a Bio::Seq.pm object. | ||||||||||||||||||||||||||||||||||||||||||
| 1485 | Example : $seqObj = $hsp->seq('query'); | ||||||||||||||||||||||||||||||||||||||||||
| 1486 | Returns : Object reference for a Bio::Seq.pm object. | ||||||||||||||||||||||||||||||||||||||||||
| 1487 | Argument : seq_type = 'query' or 'hit' or 'sbjct' (default = 'query'). | ||||||||||||||||||||||||||||||||||||||||||
| 1488 | : ('sbjct' is synonymous with 'hit') | ||||||||||||||||||||||||||||||||||||||||||
| 1489 | Throws : Propagates any exception that occurs during construction | ||||||||||||||||||||||||||||||||||||||||||
| 1490 | : of the Bio::Seq.pm object. | ||||||||||||||||||||||||||||||||||||||||||
| 1491 | Comments : The sequence is returned in an array of strings corresponding | ||||||||||||||||||||||||||||||||||||||||||
| 1492 | : to the strings in the original format of the Blast alignment. | ||||||||||||||||||||||||||||||||||||||||||
| 1493 | : (i.e., same spacing). | ||||||||||||||||||||||||||||||||||||||||||
| 1494 | |||||||||||||||||||||||||||||||||||||||||||
| 1495 | See Also : L</seq_str>, L</seq_inds>, L<Bio::Seq> | ||||||||||||||||||||||||||||||||||||||||||
| 1496 | |||||||||||||||||||||||||||||||||||||||||||
| 1497 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 1498 | |||||||||||||||||||||||||||||||||||||||||||
| 1499 | #------- | ||||||||||||||||||||||||||||||||||||||||||
| 1500 | 0 | ▶ | sub seq { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
seq: not called CC=3 SCAR=24.8
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1501 | #------- | ||||||||||||||||||||||||||||||||||||||||||
| 1502 | 0 | my($self,$seqType) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1503 | 0 | ▶ | $seqType ||= 'query'; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$seqType ||= "query"
MC/DC0%0/1
$seqType ||= "query"
$seqType
Truth table0%0/2
A
A= $seqType
| |||||||||||||||||||||||||||||||||||||||||||
| 1504 | 0 | ▶ | $seqType = 'sbjct' if $seqType eq 'hit'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1505 | 0 | my $str = $self->seq_str($seqType); | |||||||||||||||||||||||||||||||||||||||||
| 1506 | |||||||||||||||||||||||||||||||||||||||||||
| 1507 | 0 | require Bio::Seq; | |||||||||||||||||||||||||||||||||||||||||
| 1508 | |||||||||||||||||||||||||||||||||||||||||||
| 1509 | 0 | Bio::Seq->new(-ID => $self->to_string, | |||||||||||||||||||||||||||||||||||||||||
| 1510 | -SEQ => $str, | ||||||||||||||||||||||||||||||||||||||||||
| 1511 | -DESC => "$seqType sequence", | ||||||||||||||||||||||||||||||||||||||||||
| 1512 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 1513 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1514 | |||||||||||||||||||||||||||||||||||||||||||
| 1515 | =head2 seq_str | ||||||||||||||||||||||||||||||||||||||||||
| 1516 | |||||||||||||||||||||||||||||||||||||||||||
| 1517 | Usage : $hsp->seq_str( seq_type ); | ||||||||||||||||||||||||||||||||||||||||||
| 1518 | Purpose : Get the full query, sbjct, or 'match' sequence as a string. | ||||||||||||||||||||||||||||||||||||||||||
| 1519 | : The 'match' sequence is the string of symbols in between the | ||||||||||||||||||||||||||||||||||||||||||
| 1520 | : query and sbjct sequences. | ||||||||||||||||||||||||||||||||||||||||||
| 1521 | Example : $str = $hsp->seq_str('query'); | ||||||||||||||||||||||||||||||||||||||||||
| 1522 | Returns : String | ||||||||||||||||||||||||||||||||||||||||||
| 1523 | Argument : seq_Type = 'query' or 'hit' or 'sbjct' or 'match' | ||||||||||||||||||||||||||||||||||||||||||
| 1524 | : ('sbjct' is synonymous with 'hit') | ||||||||||||||||||||||||||||||||||||||||||
| 1525 | Throws : Exception if the argument does not match an accepted seq_type. | ||||||||||||||||||||||||||||||||||||||||||
| 1526 | Comments : Calls _set_seq_data() to set the 'match' sequence if it has | ||||||||||||||||||||||||||||||||||||||||||
| 1527 | : not been set already. | ||||||||||||||||||||||||||||||||||||||||||
| 1528 | |||||||||||||||||||||||||||||||||||||||||||
| 1529 | See Also : L</seq>, L</seq_inds>, L</_set_match_seq> | ||||||||||||||||||||||||||||||||||||||||||
| 1530 | |||||||||||||||||||||||||||||||||||||||||||
| 1531 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 1532 | |||||||||||||||||||||||||||||||||||||||||||
| 1533 | #------------ | ||||||||||||||||||||||||||||||||||||||||||
| 1534 | 0 | ▶ | sub seq_str { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
seq_str: not called CC=7 SCAR=40.3
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1535 | #------------ | ||||||||||||||||||||||||||||||||||||||||||
| 1536 | 0 | my($self,$seqType) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1537 | |||||||||||||||||||||||||||||||||||||||||||
| 1538 | 0 | ▶ | $seqType ||= 'query'; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$seqType ||= "query"
MC/DC0%0/1
$seqType ||= "query"
$seqType
Truth table0%0/2
A
A= $seqType
| |||||||||||||||||||||||||||||||||||||||||||
| 1539 | 0 | ▶ | $seqType = 'sbjct' if $seqType eq 'hit'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1540 | ## Sensitive to member name changes. | ||||||||||||||||||||||||||||||||||||||||||
| 1541 | 0 | $seqType = "_\L$seqType\E"; | |||||||||||||||||||||||||||||||||||||||||
| 1542 | |||||||||||||||||||||||||||||||||||||||||||
| 1543 | 0 | ▶ | $self->_set_seq_data() unless $self->{'_set_seq_data'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1544 | |||||||||||||||||||||||||||||||||||||||||||
| 1545 | 0 | ▶ | if($seqType =~ /sbjct|query/) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 2 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 1546 | 0 | my $seq = join('',@{$self->{$seqType.'Seq'}}); | |||||||||||||||||||||||||||||||||||||||||
| 1547 | 0 | $seq =~ s/\s+//g; | |||||||||||||||||||||||||||||||||||||||||
| 1548 | 0 | return $seq; | |||||||||||||||||||||||||||||||||||||||||
| 1549 | |||||||||||||||||||||||||||||||||||||||||||
| 1550 | } elsif( $seqType =~ /match/i) { | ||||||||||||||||||||||||||||||||||||||||||
| 1551 | # Only need to call _set_match_seq() if the match seq is requested. | ||||||||||||||||||||||||||||||||||||||||||
| 1552 | 0 | ▶ | my $aref = $self->_set_match_seq() unless ref $self->{'_matchSeq'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1553 | 0 | $aref = $self->{'_matchSeq'}; | |||||||||||||||||||||||||||||||||||||||||
| 1554 | |||||||||||||||||||||||||||||||||||||||||||
| 1555 | 0 | return join('',@$aref); | |||||||||||||||||||||||||||||||||||||||||
| 1556 | |||||||||||||||||||||||||||||||||||||||||||
| 1557 | } else { | ||||||||||||||||||||||||||||||||||||||||||
| 1558 | 0 | my $id_str = $self->_id_str; | |||||||||||||||||||||||||||||||||||||||||
| 1559 | 0 | $self->throw(-class => 'Bio::Root::BadParameter', | |||||||||||||||||||||||||||||||||||||||||
| 1560 | -text => "Invalid or undefined sequence type: $seqType ($id_str)\n" . | ||||||||||||||||||||||||||||||||||||||||||
| 1561 | "Valid types: query, sbjct, match", | ||||||||||||||||||||||||||||||||||||||||||
| 1562 | -value => $seqType); | ||||||||||||||||||||||||||||||||||||||||||
| 1563 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1564 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1565 | |||||||||||||||||||||||||||||||||||||||||||
| 1566 | =head2 seq_inds | ||||||||||||||||||||||||||||||||||||||||||
| 1567 | |||||||||||||||||||||||||||||||||||||||||||
| 1568 | Usage : $hsp->seq_inds( seq_type, class, collapse ); | ||||||||||||||||||||||||||||||||||||||||||
| 1569 | Purpose : Get a list of residue positions (indices) for all identical | ||||||||||||||||||||||||||||||||||||||||||
| 1570 | : or conserved residues in the query or sbjct sequence. | ||||||||||||||||||||||||||||||||||||||||||
| 1571 | Example : @s_ind = $hsp->seq_inds('query', 'identical'); | ||||||||||||||||||||||||||||||||||||||||||
| 1572 | : @h_ind = $hsp->seq_inds('hit', 'conserved'); | ||||||||||||||||||||||||||||||||||||||||||
| 1573 | : @h_ind = $hsp->seq_inds('hit', 'conserved', 1); | ||||||||||||||||||||||||||||||||||||||||||
| 1574 | Returns : List of integers | ||||||||||||||||||||||||||||||||||||||||||
| 1575 | : May include ranges if collapse is true. | ||||||||||||||||||||||||||||||||||||||||||
| 1576 | Argument : seq_type = 'query' or 'hit' or 'sbjct' (default = query) | ||||||||||||||||||||||||||||||||||||||||||
| 1577 | : ('sbjct' is synonymous with 'hit') | ||||||||||||||||||||||||||||||||||||||||||
| 1578 | : class = 'identical' or 'conserved' (default = identical) | ||||||||||||||||||||||||||||||||||||||||||
| 1579 | : (can be shortened to 'id' or 'cons') | ||||||||||||||||||||||||||||||||||||||||||
| 1580 | : (actually, anything not 'id' will evaluate to 'conserved'). | ||||||||||||||||||||||||||||||||||||||||||
| 1581 | : collapse = boolean, if true, consecutive positions are merged | ||||||||||||||||||||||||||||||||||||||||||
| 1582 | : using a range notation, e.g., "1 2 3 4 5 7 9 10 11" | ||||||||||||||||||||||||||||||||||||||||||
| 1583 | : collapses to "1-5 7 9-11". This is useful for | ||||||||||||||||||||||||||||||||||||||||||
| 1584 | : consolidating long lists. Default = no collapse. | ||||||||||||||||||||||||||||||||||||||||||
| 1585 | Throws : n/a. | ||||||||||||||||||||||||||||||||||||||||||
| 1586 | Comments : Calls _set_residues() to set the 'match' sequence if it has | ||||||||||||||||||||||||||||||||||||||||||
| 1587 | : not been set already. | ||||||||||||||||||||||||||||||||||||||||||
| 1588 | |||||||||||||||||||||||||||||||||||||||||||
| 1589 | See Also : L</seq>, L</_set_residues>, L<Bio::Search::BlastUtils::collapse_nums()|Bio::Search::BlastUtils>, L<Bio::Search::Hit::BlastHit::seq_inds()|Bio::Search::Hit::BlastHit> | ||||||||||||||||||||||||||||||||||||||||||
| 1590 | |||||||||||||||||||||||||||||||||||||||||||
| 1591 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 1592 | |||||||||||||||||||||||||||||||||||||||||||
| 1593 | #--------------- | ||||||||||||||||||||||||||||||||||||||||||
| 1594 | 0 | ▶ | sub seq_inds { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
seq_inds: not called CC=10 SCAR=47.0
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1595 | #--------------- | ||||||||||||||||||||||||||||||||||||||||||
| 1596 | 0 | my ($self, $seqType, $class, $collapse) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1597 | |||||||||||||||||||||||||||||||||||||||||||
| 1598 | 0 | ▶ | $seqType ||= 'query'; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$seqType ||= "query"
MC/DC0%0/1
$seqType ||= "query"
$seqType
Truth table0%0/2
A
A= $seqType
| |||||||||||||||||||||||||||||||||||||||||||
| 1599 | 0 | ▶ | $class ||= 'identical'; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$class ||= "identical"
MC/DC0%0/1
$class ||= "identical"
$class
Truth table0%0/2
A
A= $class
| |||||||||||||||||||||||||||||||||||||||||||
| 1600 | 0 | ▶ | $collapse ||= 0; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$collapse ||= 0
MC/DC0%0/1
$collapse ||= 0
$collapse
Truth table0%0/2
A
A= $collapse
| |||||||||||||||||||||||||||||||||||||||||||
| 1601 | 0 | ▶ | $seqType = 'sbjct' if $seqType eq 'hit'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1602 | |||||||||||||||||||||||||||||||||||||||||||
| 1603 | 0 | ▶ | $self->_set_residues() unless defined $self->{'_identicalRes_query'}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1604 | |||||||||||||||||||||||||||||||||||||||||||
| 1605 | 0 | ▶ | $seqType = ($seqType !~ /^q/i ? 'sbjct' : 'query'); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1606 | 0 | ▶ | $class = ($class !~ /^id/i ? 'conserved' : 'identical'); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1607 | |||||||||||||||||||||||||||||||||||||||||||
| 1608 | ## Sensitive to member name changes. | ||||||||||||||||||||||||||||||||||||||||||
| 1609 | 0 | $seqType = "_\L$seqType\E"; | |||||||||||||||||||||||||||||||||||||||||
| 1610 | 0 | $class = "_\L$class\E"; | |||||||||||||||||||||||||||||||||||||||||
| 1611 | |||||||||||||||||||||||||||||||||||||||||||
| 1612 | 0 | my @ary = sort { $a <=> $b } keys %{ $self->{"${class}Res$seqType"}}; | |||||||||||||||||||||||||||||||||||||||||
| 1613 | |||||||||||||||||||||||||||||||||||||||||||
| 1614 | 0 | ▶ | require Bio::Search::BlastUtils if $collapse; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1615 | |||||||||||||||||||||||||||||||||||||||||||
| 1616 | 0 | ▶ | return $collapse ? &Bio::Search::BlastUtils::collapse_nums(@ary) : @ary; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1617 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1618 | |||||||||||||||||||||||||||||||||||||||||||
| 1619 | |||||||||||||||||||||||||||||||||||||||||||
| 1620 | =head2 get_aln | ||||||||||||||||||||||||||||||||||||||||||
| 1621 | |||||||||||||||||||||||||||||||||||||||||||
| 1622 | Usage : $hsp->get_aln() | ||||||||||||||||||||||||||||||||||||||||||
| 1623 | Purpose : Get a Bio::SimpleAlign object constructed from the query + sbjct | ||||||||||||||||||||||||||||||||||||||||||
| 1624 | : sequences of the present HSP object. | ||||||||||||||||||||||||||||||||||||||||||
| 1625 | Example : $aln_obj = $hsp->get_aln(); | ||||||||||||||||||||||||||||||||||||||||||
| 1626 | Returns : Object reference for a Bio::SimpleAlign.pm object. | ||||||||||||||||||||||||||||||||||||||||||
| 1627 | Argument : n/a. | ||||||||||||||||||||||||||||||||||||||||||
| 1628 | Throws : Propagates any exception ocurring during the construction of | ||||||||||||||||||||||||||||||||||||||||||
| 1629 | : the Bio::SimpleAlign object. | ||||||||||||||||||||||||||||||||||||||||||
| 1630 | Comments : Requires Bio::SimpleAlign. | ||||||||||||||||||||||||||||||||||||||||||
| 1631 | : The Bio::SimpleAlign object is constructed from the query + sbjct | ||||||||||||||||||||||||||||||||||||||||||
| 1632 | : sequence objects obtained by calling seq(). | ||||||||||||||||||||||||||||||||||||||||||
| 1633 | : Gap residues are included (see $GAP_SYMBOL). | ||||||||||||||||||||||||||||||||||||||||||
| 1634 | |||||||||||||||||||||||||||||||||||||||||||
| 1635 | See Also : L</seq>, L<Bio::SimpleAlign> | ||||||||||||||||||||||||||||||||||||||||||
| 1636 | |||||||||||||||||||||||||||||||||||||||||||
| 1637 | =cut | ||||||||||||||||||||||||||||||||||||||||||
| 1638 | |||||||||||||||||||||||||||||||||||||||||||
| 1639 | #------------ | ||||||||||||||||||||||||||||||||||||||||||
| 1640 | 0 | ▶ | sub get_aln { | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
get_aln: not called CC=2 SCAR=17.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1641 | #------------ | ||||||||||||||||||||||||||||||||||||||||||
| 1642 | 0 | my $self = shift; | |||||||||||||||||||||||||||||||||||||||||
| 1643 | |||||||||||||||||||||||||||||||||||||||||||
| 1644 | 0 | require Bio::SimpleAlign; | |||||||||||||||||||||||||||||||||||||||||
| 1645 | 0 | require Bio::LocatableSeq; | |||||||||||||||||||||||||||||||||||||||||
| 1646 | 0 | my $qseq = $self->seq('query'); | |||||||||||||||||||||||||||||||||||||||||
| 1647 | 0 | my $sseq = $self->seq('sbjct'); | |||||||||||||||||||||||||||||||||||||||||
| 1648 | |||||||||||||||||||||||||||||||||||||||||||
| 1649 | 0 | ▶ | my $type = $self->algorithm =~ /P$|^T/ ? 'amino' : 'dna'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1650 | 0 | my $aln = Bio::SimpleAlign->new(); | |||||||||||||||||||||||||||||||||||||||||
| 1651 | 0 | $aln->add_seq(Bio::LocatableSeq->new(-seq => $qseq->seq(), | |||||||||||||||||||||||||||||||||||||||||
| 1652 | -id => 'query_'.$qseq->display_id(), | ||||||||||||||||||||||||||||||||||||||||||
| 1653 | -start => 1, | ||||||||||||||||||||||||||||||||||||||||||
| 1654 | -end => CORE::length($qseq))); | ||||||||||||||||||||||||||||||||||||||||||
| 1655 | |||||||||||||||||||||||||||||||||||||||||||
| 1656 | 0 | $aln->add_seq(Bio::LocatableSeq->new(-seq => $sseq->seq(), | |||||||||||||||||||||||||||||||||||||||||
| 1657 | -id => 'hit_'.$sseq->display_id(), | ||||||||||||||||||||||||||||||||||||||||||
| 1658 | -start => 1, | ||||||||||||||||||||||||||||||||||||||||||
| 1659 | -end => CORE::length($sseq))); | ||||||||||||||||||||||||||||||||||||||||||
| 1660 | |||||||||||||||||||||||||||||||||||||||||||
| 1661 | 0 | return $aln; | |||||||||||||||||||||||||||||||||||||||||
| 1662 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1663 | |||||||||||||||||||||||||||||||||||||||||||
| 1664 | |||||||||||||||||||||||||||||||||||||||||||
| 1665 | 1 | 1; | |||||||||||||||||||||||||||||||||||||||||
| 1666 | __END__ | ||||||||||||||||||||||||||||||||||||||||||