annotate variant_effect_predictor/Bio/Align/PairwiseStatistics.pm @ 0:2bc9b66ada89 draft default tip

Uploaded
author mahtabm
date Thu, 11 Apr 2013 06:29:17 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
1 # $Id: PairwiseStatistics.pm,v 1.2 2002/10/22 07:45:10 lapp Exp $
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
2 #
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
3 # BioPerl module for Bio::Align::PairwiseStatistics
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
4 #
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
5 # Cared for by Jason Stajich <jason@bioperl.org>
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
6 #
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
7 # Copyright Jason Stajich
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
8 #
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
9 # You may distribute this module under the same terms as perl itself
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
10
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
11 # POD documentation - main docs before the code
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
12
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
13 =head1 NAME
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
14
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
15 Bio::Align::PairwiseStatistics - Base statistic object for Pairwise Alignments
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
16
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
17 =head1 SYNOPSIS
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
18
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
19 Give standard usage here
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
20
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
21 =head1 DESCRIPTION
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
22
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
23 Describe the object here
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
24
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
25 =head1 FEEDBACK
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
26
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
27 =head2 Mailing Lists
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
28
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
29 User feedback is an integral part of the evolution of this and other
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
30 Bioperl modules. Send your comments and suggestions preferably to
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
31 the Bioperl mailing list. Your participation is much appreciated.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
32
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
33 bioperl-l@bioperl.org - General discussion
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
34 http://bioperl.org/MailList.shtml - About the mailing lists
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
35
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
36 =head2 Reporting Bugs
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
37
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
38 Report bugs to the Bioperl bug tracking system to help us keep track
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
39 of the bugs and their resolution. Bug reports can be submitted via
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
40 email or the web:
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
41
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
42 bioperl-bugs@bioperl.org
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
43 http://bugzilla.bioperl.org/
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
44
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
45 =head1 AUTHOR - Jason Stajich
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
46
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
47 Email jason@bioperl.org
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
48
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
49 Describe contact details here
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
50
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
51 =head1 CONTRIBUTORS
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
52
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
53 Additional contributors names and emails here
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
54
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
55 =head1 APPENDIX
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
56
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
57 The rest of the documentation details each of the object methods.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
58 Internal methods are usually preceded with a _
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
59
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
60 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
61
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
62
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
63 # Let the code begin...
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
64
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
65
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
66 package Bio::Align::PairwiseStatistics;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
67 use vars qw(@ISA $GapChars);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
68 use strict;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
69
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
70 use Bio::Align::StatisticsI;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
71 use Bio::Root::Root;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
72
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
73 BEGIN { $GapChars = '(\.|\-)'; }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
74
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
75 @ISA = qw(Bio::Root::Root Bio::Align::StatisticsI );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
76
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
77 =head2 number_of_comparable_bases
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
78
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
79 Title : number_of_comparable_bases
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
80 Usage : my $bases = $stat->number_of_comparable_bases($aln);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
81 Function: Returns the count of the number of bases that can be
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
82 compared (L) in this alignment ( length - gaps)
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
83 Returns : integer
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
84 Args : Bio::Align::AlignI
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
85
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
86
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
87 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
88
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
89 sub number_of_comparable_bases{
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
90 my ($self,$aln) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
91 if( ! defined $aln || ! $aln->isa('Bio::Align::AlignI') ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
92 $self->warn("Must provide a Bio::Align::AlignI compliant object to Bio::Align::PairwiseStatistics");
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
93 return 0;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
94 } elsif( $aln->no_sequences != 2 ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
95 $self->warn("only pairwise calculations currently supported");
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
96 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
97 my $L = $aln->length - $self->number_of_gaps($aln);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
98 return $L;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
99 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
100
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
101 =head2 number_of_differences
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
102
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
103 Title : number_of_differences
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
104 Usage : my $nd = $stat->number_of_distances($aln);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
105 Function: Returns the number of differences between two
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
106 Returns : integer
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
107 Args : Bio::Align::AlignI
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
108
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
109
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
110 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
111
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
112 sub number_of_differences{
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
113 my ($self,$aln) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
114 if( ! defined $aln || ! $aln->isa('Bio::Align::AlignI') ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
115 $self->warn("Must provide a Bio::Align::AlignI compliant object to Bio::Align::PairwiseStatistics");
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
116 return 0;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
117 } elsif( $aln->no_sequences != 2 ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
118 $self->warn("only pairwise calculations currently supported");
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
119 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
120 my (@seqs);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
121 foreach my $seq ( $aln->each_seq) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
122 push @seqs, [ split(//,$seq->seq())];
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
123 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
124 my $firstseq = shift @seqs;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
125 # my $secondseq = shift @seqs;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
126 my $diffcount = 0;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
127 for (my $i = 0;$i<$aln->length; $i++ ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
128 next if( $firstseq->[$i] =~ /^$GapChars$/);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
129 foreach my $seq ( @seqs ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
130 next if( $seq->[$i] =~ /^$GapChars$/);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
131 if( $firstseq->[$i] ne $seq->[$i] ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
132 $diffcount++;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
133 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
134 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
135 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
136 return $diffcount;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
137 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
138
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
139 =head2 number_of_gaps
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
140
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
141 Title : number_of_gaps
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
142 Usage : my $nd = $stat->number_of_gaps($aln);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
143 Function: Returns the number of differences between two
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
144 Example :
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
145 Returns :
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
146 Args :
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
147
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
148
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
149 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
150
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
151 sub number_of_gaps{
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
152 my ($self,$aln) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
153 if( ! defined $aln || ! $aln->isa('Bio::Align::AlignI') ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
154 $self->warn("Must provide a Bio::Align::AlignI compliant object to Bio::Align::PairwiseStatistics");
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
155 return 0;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
156 } elsif( $aln->no_sequences != 2 ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
157 $self->warn("only pairwise calculations currently supported");
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
158 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
159 my (@seqs);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
160 foreach my $seq ( $aln->each_seq) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
161 push @seqs, [ split(//,$seq->seq())];
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
162 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
163 my $firstseq = shift @seqs;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
164 # my $secondseq = shift @seqs;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
165 my $gapcount = 0;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
166 for (my $i = 0;$i<$aln->length; $i++ ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
167 ($gapcount++) && next if( $firstseq->[$i] =~ /^$GapChars$/);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
168 foreach my $seq ( @seqs ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
169 ($gapcount++) && next if( $seq->[$i] =~ /^$GapChars$/);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
170 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
171 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
172 return $gapcount;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
173 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
174
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
175 1;