Seq.pm

filter: Statementstmt 100% 117 / 117 Branchbran 97.9% 47 / 48 Conditioncond 100% 34 / 34 MC/DCmcdc 100% 17 / 17 Subroutinesub 100% 19 / 19 Podpod 100% 11 / 11 totaltotal 99.5% 245 / 246 CC 39 SCAR 16.1
CC
39
Cov
99%
new
8.0
translate
8.0
as_fastq
7.0
CRAP 5.0
« Seq/Stream/FASTA.pm ↑ Summary Seq/Utils.pm »
1 package BioX::Seq 0.008014;
2  
3 4 ▶use 5.016;
Subroutine BEGIN: called CC=1 SCAR=0.0
4 4 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
5 4 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
6  
7 use overload
8 4 ▶ '""' => \&_stringify,
Subroutine BEGIN: called CC=1 SCAR=0.0
9 '.=' => \&_concat,
10 4 ▶ 'bool' => sub{return(1)};
Subroutine __ANON__: called CC=1 SCAR=0.0
11  
12 4 my %genetic_code = (
13
14 # Standard codon table
15  
16 TTT => 'F' , TCT => 'S' , TAT => 'Y' , TGT => 'C' ,
17 TTC => 'F' , TCC => 'S' , TAC => 'Y' , TGC => 'C' ,
18 TTA => 'L' , TCA => 'S' , TAA => '*' , TGA => '*' ,
19 TTG => 'L' , TCG => 'S' , TAG => '*' , TGG => 'W' ,
20
21 CTT => 'L' , CCT => 'P' , CAT => 'H' , CGT => 'R' ,
22 CTC => 'L' , CCC => 'P' , CAC => 'H' , CGC => 'R' ,
23 CTA => 'L' , CCA => 'P' , CAA => 'Q' , CGA => 'R' ,
24 CTG => 'L' , CCG => 'P' , CAG => 'Q' , CGG => 'R' ,
25  
26 ATT => 'I' , ACT => 'T' , AAT => 'N' , AGT => 'S' ,
27 ATC => 'I' , ACC => 'T' , AAC => 'N' , AGC => 'S' ,
28 ATA => 'I' , ACA => 'T' , AAA => 'K' , AGA => 'R' ,
29 ATG => 'M' , ACG => 'T' , AAG => 'K' , AGG => 'R' ,
30  
31 GTT => 'V' , GCT => 'A' , GAT => 'D' , GGT => 'G' ,
32 GTC => 'V' , GCC => 'A' , GAC => 'D' , GGC => 'G' ,
33 GTA => 'V' , GCA => 'A' , GAA => 'E' , GGA => 'G' ,
34 GTG => 'V' , GCG => 'A' , GAG => 'E' , GGG => 'G' ,
35
36 # Extension containing all permutations using ambiguity codes
37
38 AAU => 'N' , AAR => 'K' , AAY => 'N' , ACU => 'T' ,
39 ACM => 'T' , ACR => 'T' , ACW => 'T' , ACS => 'T' ,
40 ACY => 'T' , ACK => 'T' , ACV => 'T' , ACH => 'T' ,
41 ACD => 'T' , ACB => 'T' , ACN => 'T' , AGU => 'S' ,
42 AGR => 'R' , AGY => 'S' , ATU => 'I' , ATM => 'I' ,
43 ATW => 'I' , ATY => 'I' , ATH => 'I' , AUA => 'I' ,
44 AUC => 'I' , AUG => 'M' , AUT => 'I' , AUU => 'I' ,
45 AUM => 'I' , AUW => 'I' , AUY => 'I' , AUH => 'I' ,
46 CAU => 'H' , CAR => 'Q' , CAY => 'H' , CCU => 'P' ,
47 CCM => 'P' , CCR => 'P' , CCW => 'P' , CCS => 'P' ,
48 CCY => 'P' , CCK => 'P' , CCV => 'P' , CCH => 'P' ,
49 CCD => 'P' , CCB => 'P' , CCN => 'P' , CGU => 'R' ,
50 CGM => 'R' , CGR => 'R' , CGW => 'R' , CGS => 'R' ,
51 CGY => 'R' , CGK => 'R' , CGV => 'R' , CGH => 'R' ,
52 CGD => 'R' , CGB => 'R' , CGN => 'R' , CTU => 'L' ,
53 CTM => 'L' , CTR => 'L' , CTW => 'L' , CTS => 'L' ,
54 CTY => 'L' , CTK => 'L' , CTV => 'L' , CTH => 'L' ,
55 CTD => 'L' , CTB => 'L' , CTN => 'L' , CUA => 'L' ,
56 CUC => 'L' , CUG => 'L' , CUT => 'L' , CUU => 'L' ,
57 CUM => 'L' , CUR => 'L' , CUW => 'L' , CUS => 'L' ,
58 CUY => 'L' , CUK => 'L' , CUV => 'L' , CUH => 'L' ,
59 CUD => 'L' , CUB => 'L' , CUN => 'L' , GAU => 'D' ,
60 GAR => 'E' , GAY => 'D' , GCU => 'A' , GCM => 'A' ,
61 GCR => 'A' , GCW => 'A' , GCS => 'A' , GCY => 'A' ,
62 GCK => 'A' , GCV => 'A' , GCH => 'A' , GCD => 'A' ,
63 GCB => 'A' , GCN => 'A' , GGU => 'G' , GGM => 'G' ,
64 GGR => 'G' , GGW => 'G' , GGS => 'G' , GGY => 'G' ,
65 GGK => 'G' , GGV => 'G' , GGH => 'G' , GGD => 'G' ,
66 GGB => 'G' , GGN => 'G' , GTU => 'V' , GTM => 'V' ,
67 GTR => 'V' , GTW => 'V' , GTS => 'V' , GTY => 'V' ,
68 GTK => 'V' , GTV => 'V' , GTH => 'V' , GTD => 'V' ,
69 GTB => 'V' , GTN => 'V' , GUA => 'V' , GUC => 'V' ,
70 GUG => 'V' , GUT => 'V' , GUU => 'V' , GUM => 'V' ,
71 GUR => 'V' , GUW => 'V' , GUS => 'V' , GUY => 'V' ,
72 GUK => 'V' , GUV => 'V' , GUH => 'V' , GUD => 'V' ,
73 GUB => 'V' , GUN => 'V' , TAU => 'Y' , TAR => '*' ,
74 TAY => 'Y' , TCU => 'S' , TCM => 'S' , TCR => 'S' ,
75 TCW => 'S' , TCS => 'S' , TCY => 'S' , TCK => 'S' ,
76 TCV => 'S' , TCH => 'S' , TCD => 'S' , TCB => 'S' ,
77 TCN => 'S' , TGU => 'C' , TGY => 'C' , TTU => 'F' ,
78 TTR => 'L' , TTY => 'F' , TUA => 'L' , TUC => 'F' ,
79 TUG => 'L' , TUT => 'F' , TUU => 'F' , TUR => 'L' ,
80 TUY => 'F' , TRA => '*' , UAA => '*' , UAC => 'Y' ,
81 UAG => '*' , UAT => 'Y' , UAU => 'Y' , UAR => '*' ,
82 UAY => 'Y' , UCA => 'S' , UCC => 'S' , UCG => 'S' ,
83 UCT => 'S' , UCU => 'S' , UCM => 'S' , UCR => 'S' ,
84 UCW => 'S' , UCS => 'S' , UCY => 'S' , UCK => 'S' ,
85 UCV => 'S' , UCH => 'S' , UCD => 'S' , UCB => 'S' ,
86 UCN => 'S' , UGA => '*' , UGC => 'C' , UGG => 'W' ,
87 UGT => 'C' , UGU => 'C' , UGY => 'C' , UTA => 'L' ,
88 UTC => 'F' , UTG => 'L' , UTT => 'F' , UTU => 'F' ,
89 UTR => 'L' , UTY => 'F' , UUA => 'L' , UUC => 'F' ,
90 UUG => 'L' , UUT => 'F' , UUU => 'F' , UUR => 'L' ,
91 UUY => 'F' , URA => '*' , MGA => 'R' , MGG => 'R' ,
92 MGR => 'R' , YTA => 'L' , YTG => 'L' , YTR => 'L' ,
93 YUA => 'L' , YUG => 'L' , YUR => 'L' ,
94  
95 );
96  
97 133 ▶sub new {
Subroutine new: called CC=8 SCAR=20.8
Pod documented
98  
99 133 my ($class, $seq, $id, $desc, $qual) = @_;
100  
101 133 ▶ if ( defined $seq && defined $qual
Branch: 1 branch
BranchTrueFalseTotal
if (defined $seq and defined $qual and length $seq != length $qual) 1 132 133
Condition100%6/6
defined $seq and defined $qual and length $seq != length $qual
!ll&&!rl&&r
12751
defined $seq and defined $qual
!ll&&!rl&&r
11266
MC/DC100%3/3
defined $seq and defined $qual and length $seq != length $qual
defined $seq defined $qual length $seq != length $qual
Truth table100%4/4
A and B and C
A= defined $seqB= defined $qualC= length $seq != length $qual
ABCresult
0XX0
10X0
1100
1111
102 && (length($seq) != length($qual))) {
103 1 die "Sequence/quality length mismatch";
104 }
105  
106 132 my $self = bless {}, $class;
107 132 ▶ $self->{seq} = $seq // '';
Condition100%2/2
$seq // ""
l!l
1311
MC/DC100%1/1
$seq // ""
$seq
Truth table100%2/2
A
A= $seq
Aresult
11
00
108 132 ▶ $self->{id} = $id // undef;
Condition100%2/2
$id // undef
l!l
1293
MC/DC100%1/1
$id // undef
$id
Truth table100%2/2
A
A= $id
Aresult
11
00
109 132 ▶ $self->{desc} = $desc // undef;
Condition100%2/2
$desc // undef
l!l
11814
MC/DC100%1/1
$desc // undef
$desc
Truth table100%2/2
A
A= $desc
Aresult
11
00
110 132 ▶ $self->{qual} = $qual // undef;
Condition100%2/2
$qual // undef
l!l
5127
MC/DC100%1/1
$qual // undef
$qual
Truth table100%2/2
A
A= $qual
Aresult
11
00
111  
112 132 return $self;
113  
114 }
115  
116 29 ▶sub seq : lvalue {
Subroutine seq: called CC=2 SCAR=6.9
Pod documented
117  
118 29 my ($self,$new_val) = @_;
119 29 ▶ $self->{seq} = $new_val if (defined $new_val);
Branch: 1 branch
BranchTrueFalseTotal
if defined $new_val 3 26 29
120 29 return $self->{seq};
121  
122 }
123  
124 9 ▶sub id : lvalue {
Subroutine id: called CC=2 SCAR=6.9
Pod documented
125  
126 9 my ($self,$new_val) = @_;
127 9 ▶ $self->{id} = $new_val if (defined $new_val);
Branch: 1 branch
BranchTrueFalseTotal
if defined $new_val 1 8 9
128 9 return $self->{id};
129  
130 }
131  
132 9 ▶sub desc : lvalue {
Subroutine desc: called CC=2 SCAR=6.9
Pod documented
133  
134 9 my ($self,$new_val) = @_;
135 9 ▶ $self->{desc} = $new_val if (defined $new_val);
Branch: 1 branch
BranchTrueFalseTotal
if defined $new_val 1 8 9
136 9 return $self->{desc};
137  
138 }
139  
140 10 ▶sub qual : lvalue {
Subroutine qual: called CC=2 SCAR=6.9
Pod documented
141  
142 10 my ($self,$new_val) = @_;
143 10 ▶ $self->{qual} = $new_val if (defined $new_val);
Branch: 1 branch
BranchTrueFalseTotal
if defined $new_val 2 8 10
144 10 return $self->{qual};
145  
146 }
147  
148 7 ▶sub range {
Subroutine range: called CC=6 SCAR=17.9
Pod documented
149  
150 7 my ($self, $start, $end) = @_;
151 7 ▶ if ($start < 1 || $end < 1 || $start > $end || $end > length($self->{seq})) {
Branch: 1 branch
BranchTrueFalseTotal
if ($start < 1 or $end < 1 or $start > $end or $end > length $self->{"seq"}) 5 2 7
Condition100%9/9
$start < 1 or $end < 1 or $start > $end or $end > length $self->{"seq"}
l!l&&r!l&&!r
412
$start < 1 or $end < 1 or $start > $end
l!l&&r!l&&!r
313
$start < 1 or $end < 1
l!l&&r!l&&!r
214
MC/DC100%4/4
$start < 1 or $end < 1 or $start > $end or $end > length $self->{"seq"}
$start < 1 $end < 1 $start > $end $end > length $self->{"seq"}
Truth table100%5/5
A or B or C or D
A= $start < 1B= $end < 1C= $start > $endD= $end > length $self->{"seq"}
ABCDresult
1XXX1
01XX1
001X1
00011
00000
152 5 warn "Range outside of sequence length\n";
153 5 return;
154 }
155 2 my $seq = substr $self->{seq}, $start-1, $end-$start+1;
156 my $qual = defined $self->{qual}
157 2 ▶ ? substr $self->{qual}, $start-1, $end-$start+1
Branch: 1 branch
BranchTrueFalseTotal
defined $self->{'qual'} ? : 1 1 2
158 : undef;
159 my $new = __PACKAGE__->new(
160 $seq,
161 "$self->{id}_$start-$end",
162 $self->{desc},
163 2 $qual,
164 );
165 2 $new->{_input_format} = $self->{_input_format};
166 2 return $new;
167  
168 }
169  
170 5 ▶sub as_fasta {
Subroutine as_fasta: called CC=5 SCAR=16.1
Pod documented
171  
172 5 my ($self, $line_length) = @_;
173 5 ▶ my $l = $line_length // 60;
Condition100%2/2
$line_length // 60
l!l
23
MC/DC100%1/1
$line_length // 60
$line_length
Truth table100%2/2
A
A= $line_length
Aresult
11
00
174 5 ▶ if (! defined $self->{id}) {
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $self->{"id"}) 1 4 5
175 1 warn "Can't write FASTA with undefined ID\n";
176 1 return;
177 }
178 4 my $string = '>' . $self->{id};
179 4 ▶ $string .= ' ' . $self->{desc} if (defined $self->{desc});
Branch: 1 branch
BranchTrueFalseTotal
if defined $self->{"desc"} 3 1 4
180 4 $string .= "\n";
181 4 my $i = 0;
182 4 ▶ while ($i < length($self->{seq})) {
Branch: 1 branch
BranchTrueFalseTotal
if ($i < length $self->{"seq"}) 8 4 12
183 8 $string .= substr($self->{seq}, $i, $l) . "\n";
184 8 $i += $l;
185 }
186 4 return $string;
187  
188 }
189  
190 7 ▶sub as_fastq {
Subroutine as_fastq: called CC=7 SCAR=19.5
Pod documented
191  
192 7 my ($self, $qual) = @_;
193 7 ▶ if (! defined $self->{id}) {
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $self->{"id"}) 1 6 7
194 1 warn "Can't write FASTQ with undefined ID\n";
195 1 return;
196 }
197 6 my $string = '@' . $self->{id};
198 6 ▶ $string .= ' ' . $self->{desc} if (defined $self->{desc});
Branch: 1 branch
BranchTrueFalseTotal
if defined $self->{"desc"} 3 3 6
199 6 $string .= "\n";
200 6 $string .= $self->{seq};
201 6 $string .= "\n+\n";
202  
203 # check string lengths
204 6 ▶ if (defined $self->{qual}) {
Branch: 2 branches
BranchTrueFalseTotal
if (defined $self->{'qual'}) { } 4 2 6
elsif (not defined $qual) { } 1 1 2
205 4 ▶ if (length $self->{qual} != length $self->{seq}) {
Branch: 1 branch
BranchTrueFalseTotal
if (length $self->{"qual"} != length $self->{"seq"}) 1 3 4
206 1 die "Sequence/quality length mismatch";
207 }
208 }
209 # check that quality is defined somewhere
210 elsif (! defined $qual) {
211 1 die "Attempt to write FASTQ with undefined quality";
212 }
213  
214 # populate qual with constant quality if not defined
215 $string .= defined $qual
216 ? chr($qual+33) x length($self->{seq})
217 4 ▶ : $self->{qual};
Branch: 1 branch
BranchTrueFalseTotal
defined $qual ? : 2 2 4
218 4 $string .= "\n";
219 4 return $string;
220  
221 }
222  
223 4 ▶sub as_input {
Subroutine as_input: called CC=2 SCAR=7.0
Pod documented
224  
225 4 my ($self, $arg2) = @_;
226 die "No input format found"
227 4 ▶ if (! defined $self->{_input_format});
Branch: 1 branch
BranchTrueFalseTotal
unless defined $self->{"_input_format"} 0 4 4
228 4 my $method = 'as_' . $self->{_input_format};
229 4 $self->$method($arg2);
230  
231 }
232  
233 7 ▶sub rev_com {
Subroutine rev_com: called CC=4 SCAR=13.9
Pod documented
234  
235 7 my ($self) = @_;
236  
237 7 my $seq = $self->{seq};
238 7 $seq =~ tr/Xx/Nn/;
239 7 ▶ if (! _is_nucleic($seq) ) {
Branch: 1 branch
BranchTrueFalseTotal
unless (_is_nucleic($seq)) 1 6 7
240 1 warn "Bad input sequence\n";
241 1 return;
242 }
243 6 $seq = reverse $seq;
244 6 $seq =~ tr
245 {ACGTMRWSYKVHDBNacgtmrwsykvhdbn-}
246 {TGCAKYWSRMBDHVNtgcakywsrmbdhvn-};
247  
248 6 my $qual = $self->{qual};
249 6 ▶ $qual = reverse $qual if (defined $qual);
Branch: 1 branch
BranchTrueFalseTotal
if defined $qual 1 5 6
250  
251 # If in void context, act in-place
252 6 ▶ if (! defined wantarray) {
Branch: 1 branch
BranchTrueFalseTotal
unless (defined wantarray) 1 5 6
253 1 $self->{seq} = $seq;
254 1 $self->{qual} = $qual;
255 1 return 1;
256 }
257  
258 # else return a new sequence object
259 my $new = __PACKAGE__->new(
260 $seq,
261 $self->{id},
262 $self->{desc},
263 5 $qual,
264 );
265 5 $new->{_input_format} = $self->{_input_format};
266 5 return $new;
267  
268 }
269  
270 6 ▶sub translate {
Subroutine translate: called CC=8 SCAR=20.8
Pod documented
271  
272 6 my ($self,$frame) = @_;
273  
274 6 ▶ $frame = $frame // 0;
Condition100%2/2
$frame // 0
l!l
33
MC/DC100%1/1
$frame // 0
$frame
Truth table100%2/2
A
A= $frame
Aresult
11
00
275 6 ▶ die "$frame is not a valid frame (must be between 0 and 5)\n"
Branch: 1 branch
BranchTrueFalseTotal
if $frame < 0 or $frame > 5 2 4 6
Condition100%3/3
$frame < 0 or $frame > 5
l!l&&r!l&&!r
114
MC/DC100%2/2
$frame < 0 or $frame > 5
$frame < 0 $frame > 5
Truth table100%3/3
A or B
A= $frame < 0B= $frame > 5
ABresult
1X1
011
000
276 if ($frame < 0 || $frame > 5);
277  
278 4 ▶ my $seq = uc( $frame > 2 ? $self->rev_com->seq : $self->seq );
Branch: 1 branch
BranchTrueFalseTotal
$frame > 2 ? : 1 3 4
279 4 $seq = substr $seq, $frame%3;
280 4 $seq =~ tr/X/N/;
281 4 ▶ if (! _is_nucleic($seq) ) {
Branch: 1 branch
BranchTrueFalseTotal
unless (_is_nucleic($seq)) 2 2 4
282 2 warn "Input doesn't look like DNA\n";
283 2 return;
284 }
285  
286 2 ▶ $seq = join('', map {$genetic_code{$_} // 'X'}
Condition100%2/2
$genetic_code{$_} // "X"
l!l
41
MC/DC100%1/1
$genetic_code{$_} // "X"
$genetic_code{$_}
Truth table100%2/2
A
A= $genetic_code{$_}
Aresult
11
00
287 unpack 'A3' x int(length($seq)/3), $seq);
288  
289 # If in void context, act in-place
290 2 ▶ if (! defined wantarray) {
Branch: 1 branch
BranchTrueFalseTotal
unless (defined wantarray) 1 1 2
291 1 $self->{seq} = $seq;
292 1 $self->{qual} = undef;
293 1 return 1;
294 }
295  
296 # else return a new sequence object
297 return __PACKAGE__->new(
298 $seq,
299 $self->{id},
300 $self->{desc},
301 1 );
302  
303 }
304  
305 125 ▶sub _stringify {
Subroutine _stringify: called CC=2 SCAR=6.9
306  
307 125 my ($self) = @_;
308 125 ▶ return $self->{seq} // '';
Condition100%2/2
$self->{"seq"} // ""
l!l
1241
MC/DC100%1/1
$self->{"seq"} // ""
$self->{"seq"}
Truth table100%2/2
A
A= $self->{"seq"}
Aresult
11
00
309  
310 }
311  
312 1 ▶sub _concat {
Subroutine _concat: called CC=1 SCAR=0.0
313  
314 1 my ($self,$addition,$other) = @_;
315 1 $self->{seq} .= $addition;
316 1 return $self;
317  
318 }
319  
320 11 ▶sub _is_nucleic {
Subroutine _is_nucleic: called CC=1 SCAR=0.0
321  
322 11 my ($seq) = @_;
323 11 return $seq !~ /[^ACGTUMRWSYKVHDBN-]/i;
324 }
325  
326  
327 4 1;
328  
329  
330 __END__
« Seq/Stream/FASTA.pm ↑ Summary Seq/Utils.pm »