Bio/Tools/Phylo/Gerp.pm

filter: Statementstmt 100% 29 / 29 Branchbran 75.0% 3 / 4 Conditioncond 75.0% 3 / 4 MC/DCmcdc 50.0% 1 / 2 Subroutinesub 100% 6 / 6 Podpod 100% 2 / 2 totaltotal 93.6% 44 / 47 CC 5 SCAR 11.0
CC
5
Cov
95%
next_result
5.0
BEGIN
1.0
BEGIN
1.0
CRAP 3.0
« Bio/DBLinkContainerI.pm ↑ Summary Bio/FeatureHolderI.pm »
1 # $Id: Gumby.pm,v 1.2 2007/06/14 18:01:52 nathan Exp $
2 #
3 # BioPerl module for Bio::Tools::Phylo::Gerp
4 #
5 # Please direct questions and support issues to <bioperl-l@bioperl.org>
6 #
7 # Cared for by Sendu Bala <bix@sendu.me.uk>
8 #
9 # Copyright Sendu Bala
10 #
11 # You may distribute this module under the same terms as perl itself
12  
13 # POD documentation - main docs before the code
14  
15 =head1 NAME
16  
17 Bio::Tools::Phylo::Gerp - Parses output from GERP
18  
19 =head1 SYNOPSIS
20  
21 use strict;
22  
23 use Bio::Tools::Phylo::Gerp;
24  
25 my $parser = Bio::Tools::Phylo::Gerp->new(-file => "alignment.rates.elems");
26  
27 while (my $feat = $parser->next_result) {
28 my $start = $feat->start;
29 my $end = $feat->end;
30 my $rs_score = $feat->score;
31 my $p_value = ($feat->annotation->get_Annotations('p-value'))[0]->value;
32 }
33  
34 =head1 DESCRIPTION
35  
36 This module is used to parse the output from 'GERP' (v2) by Eugene Davydov
37 (originally Gregory M. Cooper et al.). You can get details here:
38 http://mendel.stanford.edu/sidowlab/
39  
40 It works on the .elems files produced by gerpelem.
41  
42 Each result is a Bio::SeqFeature::Annotated representing a single constrained
43 element.
44  
45 =head1 FEEDBACK
46  
47 =head2 Mailing Lists
48  
49 User feedback is an integral part of the evolution of this and other
50 Bioperl modules. Send your comments and suggestions preferably to
51 the Bioperl mailing list. Your participation is much appreciated.
52  
53 bioperl-l@bioperl.org - General discussion
54 http://bioperl.org/wiki/Mailing_lists - About the mailing lists
55  
56 =head2 Support
57  
58 Please direct usage questions or support issues to the mailing list:
59  
60 I<bioperl-l@bioperl.org>
61  
62 rather than to the module maintainer directly. Many experienced and
63 reponsive experts will be able look at the problem and quickly
64 address it. Please include a thorough description of the problem
65 with code and data examples if at all possible.
66  
67 =head2 Reporting Bugs
68  
69 Report bugs to the Bioperl bug tracking system to help us keep track
70 of the bugs and their resolution. Bug reports can be submitted via the
71 web:
72  
73 https://github.com/bioperl/bioperl-live/issues
74  
75 =head1 AUTHOR - Sendu Bala
76  
77 Email bix@sendu.me.uk
78  
79 =head1 APPENDIX
80  
81 The rest of the documentation details each of the object methods.
82 Internal methods are usually preceded with a _
83  
84 =cut
85  
86 # Let the code begin...
87  
88 package Bio::Tools::Phylo::Gerp;
89 2 $Bio::Tools::Phylo::Gerp::VERSION = '1.7.8';
90 2 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
91  
92 2 ▶use Bio::SeqFeature::Generic;
Subroutine BEGIN: called CC=1 SCAR=0.0
93 2 ▶use Bio::Annotation::SimpleValue;
Subroutine BEGIN: called CC=1 SCAR=0.0
94  
95 2 ▶use base qw(Bio::Root::Root Bio::Root::IO);
Subroutine BEGIN: called CC=1 SCAR=0.0
96  
97  
98 =head2 new
99  
100 Title : new
101 Usage : my $obj = Bio::Tools::Phylo::Gerp->new();
102 Function: Builds a new Bio::Tools::Phylo::Gerp object
103 Returns : Bio::Tools::Phylo::Gerp
104 Args : -file (or -fh) should contain the contents of a gerpelem .elems file
105  
106 =cut
107  
108 1 ▶sub new {
Subroutine new: called CC=1 SCAR=0.0
Pod documented
109 1 my ($class, @args) = @_;
110 1 my $self = $class->SUPER::new(@args);
111
112 1 $self->_initialize_io(@args);
113
114 1 return $self;
115 }
116  
117 =head2 next_result
118  
119 Title : next_result
120 Usage : $result = $obj->next_result();
121 Function: Returns the next result available from the input, or undef if there
122 are no more results.
123 Returns : Bio::SeqFeature::Annotated object. Features are annotated with a tag
124 for 'pvalue', and a 'predicted' tag. They have no sequence id unless
125 the input GERP file is non-standard, with the seq id as the 6th
126 column.
127  
128 NB: feature coordinates are alignment columns of the alignment
129 used to create the result file.
130 Args : none
131  
132 =cut
133  
134 6 ▶sub next_result {
Subroutine next_result: called CC=5 SCAR=16.2
Pod documented
135 6 my ($self) = @_;
136
137 6 ▶ my $line = $self->_readline || return;
Condition100%2/2
$self->_readline || (return)
l!l
51
MC/DC100%1/1
$self->_readline || (return)
$self->_readline
Truth table100%2/2
A
A= $self->_readline
Aresult
11
00
138
139 5 ▶ while ($line !~ /^\d+\s+\d+\s+\d+\s+\S+\s+\S+\s*(?:\S+\s*)?$/) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($line =~ /^\d+\s+\d+\s+\d+\s+\S+\s+\S+\s*(?:\S+\s*)?$/) 5 5 10
140 5 ▶ $line = $self->_readline || return;
Condition50%1/2
$self->_readline || (return)
l!l
50
MC/DC0%0/1
$self->_readline || (return)
$self->_readline
Truth table50%1/2
A
A= $self->_readline
Aresult
11
00
141 }
142
143 #start end length RS-score p-value
144 # code elsewhere adds seq_id on the end (not valid GERP), so we capture that
145 # if present
146 5 my ($start, $end, undef, $rs_score, $p_value, $seq_id) = split(/\s+/, $line);
147 5 ▶ my $feat = Bio::SeqFeature::Generic->new(
Branch: 1 branch
BranchTrueFalseTotal
$seq_id ? : 0 5 5
148 $seq_id ? (-seq_id => $seq_id) : (),
149 -start => $start,
150 -end => $end,
151 -strand => 1,
152 -score => $rs_score,
153 #-type => 'conserved_region', ***causes 740x increase in SeqFeatureDB storage requirements!
154 -source => 'GERP');
155
156 5 my $sv = Bio::Annotation::SimpleValue->new(-tagname => 'predicted', -value => 1);
157 5 $feat->annotation->add_Annotation($sv);
158 5 $sv = Bio::Annotation::SimpleValue->new(-tagname => 'pvalue', -value => $p_value);
159 5 $feat->annotation->add_Annotation($sv);
160
161 5 return $feat;
162 }
163  
164 2 1;
« Bio/DBLinkContainerI.pm ↑ Summary Bio/FeatureHolderI.pm »