Bio/Location/Split.pm

filter: Statementstmt 80.9% 200 / 247 Branchbran 66.0% 103 / 156 Conditioncond 61.9% 52 / 84 MC/DCmcdc 38.4% 20 / 52 Subroutinesub 95.4% 21 / 22 Podpod 100% 20 / 20 totaltotal 71.6% 416 / 581 CC 121 SCAR 30.0
CC
121
Cov
73%
length
57.5
sub_Location
52.5
is_single_sequence
30.0
CRAP 20.1
« Bio/SearchIO/IteratedSearchResultEventBuilder.pm ↑ Summary Bio/Search/Iteration/GenericIteration.pm »
1 #
2 # BioPerl module for Bio::Location::Split
3 # Please direct questions and support issues to <bioperl-l@bioperl.org>
4 #
5 # Cared for by Jason Stajich <jason@bioperl.org>
6 #
7 # Copyright Jason Stajich
8 #
9 # You may distribute this module under the same terms as perl itself
10 # POD documentation - main docs before the code
11  
12 =head1 NAME
13  
14 Bio::Location::Split - Implementation of a Location on a Sequence
15 which has multiple locations (start/end points)
16  
17 =head1 SYNOPSIS
18  
19 use Bio::Location::Split;
20  
21 my $splitlocation = Bio::Location::Split->new();
22 $splitlocation->add_sub_Location(Bio::Location::Simple->new(-start=>1,
23 -end=>30,
24 -strand=>1));
25 $splitlocation->add_sub_Location(Bio::Location::Simple->new(-start=>50,
26 -end=>61,
27 -strand=>1));
28 my @sublocs = $splitlocation->sub_Location();
29  
30 my $count = 1;
31 # print the start/end points of the sub locations
32 foreach my $location ( sort { $a->start <=> $b->start }
33 @sublocs ) {
34 printf "sub feature %d [%d..%d]\n",
35 $count, $location->start,$location->end, "\n";
36 $count++;
37 }
38  
39 =head1 DESCRIPTION
40  
41 This implementation handles locations which span more than one
42 start/end location, or and/or lie on different sequences, and can
43 work with split locations that depend on the specific order of the
44 sublocations ('join') or don't have a specific order but represent
45 a feature spanning noncontiguous sublocations ('order', 'bond').
46  
47 Note that the order in which sublocations are added may be very important,
48 depending on the specific split location type. For instance, a 'join'
49 must have the sublocations added in the order that one expects to
50 join the sublocations, whereas all other types are sorted based on the
51 sequence location.
52  
53 =head1 FEEDBACK
54  
55 User feedback is an integral part of the evolution of this and other
56 Bioperl modules. Send your comments and suggestions preferably to one
57 of the Bioperl mailing lists. Your participation is much appreciated.
58  
59 bioperl-l@bioperl.org - General discussion
60 http://bioperl.org/wiki/Mailing_lists - About the mailing lists
61  
62 =head2 Support
63  
64 Please direct usage questions or support issues to the mailing list:
65  
66 I<bioperl-l@bioperl.org>
67  
68 rather than to the module maintainer directly. Many experienced and
69 reponsive experts will be able look at the problem and quickly
70 address it. Please include a thorough description of the problem
71 with code and data examples if at all possible.
72  
73 =head2 Reporting Bugs
74  
75 Report bugs to the Bioperl bug tracking system to help us keep track
76 the bugs and their resolution. Bug reports can be submitted via the
77 web:
78  
79 https://github.com/bioperl/bioperl-live/issues
80  
81 =head1 AUTHOR - Jason Stajich
82  
83 Email jason-AT-bioperl_DOT_org
84  
85 =head1 APPENDIX
86  
87 The rest of the documentation details each of the object
88 methods. Internal methods are usually preceded with a _
89  
90 =cut
91  
92 # Let the code begin...
93  
94 package Bio::Location::Split;
95 298 $Bio::Location::Split::VERSION = '1.7.8';
96 # as defined by BSANE 0.03
97 298 our @CORBALOCATIONOPERATOR = ('NONE','JOIN', undef, 'ORDER');;
98  
99 298 ▶use Bio::Root::Root;
Subroutine BEGIN: called CC=1 SCAR=0.0
100  
101 298 ▶use base qw(Bio::Location::Atomic Bio::Location::SplitLocationI);
Subroutine BEGIN: called CC=1 SCAR=0.0
102  
103 3625 ▶sub new {
Subroutine new: called CC=5 SCAR=16.5
Pod documented
104 3625 my ($class, @args) = @_;
105 3625 my $self = $class->SUPER::new(@args);
106 # initialize
107 3625 $self->{'_sublocations'} = [];
108 3625 my ( $type, $seqid, $locations ) =
109 $self->_rearrange([qw(SPLITTYPE
110 SEQ_ID
111 LOCATIONS
112 )], @args);
113 3625 ▶ if( defined $locations && ref($locations) =~ /array/i ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $locations and ref($locations) =~ /array/i) 0 3625 3625
Condition33%1/3
defined $locations and ref($locations) =~ /array/i
!ll&&!rl&&r
362500
MC/DC0%0/2
defined $locations and ref($locations) =~ /array/i
defined $locations ref($locations) =~ /array/i
Truth table33%1/3
A and B
A= defined $locationsB= ref($locations) =~ /array/i
ABresult
0X0
100
111
114 0 $self->add_sub_Location(@$locations);
115 }
116 3625 ▶ $seqid && $self->seq_id($seqid);
Branch: 1 branch
BranchTrueFalseTotal
$seqid and $self->seq_id($seqid) 1 3624 3625
117 3625 ▶ $type ||= 'JOIN';
Condition100%2/2
$type ||= "JOIN"
l!l
358738
MC/DC100%1/1
$type ||= "JOIN"
$type
Truth table100%2/2
A
A= $type
Aresult
11
00
118 3625 $type = lc ($type);
119 3625 $self->splittype($type);
120 3625 return $self;
121 }
122  
123 =head2 each_Location
124  
125 Title : each_Location
126 Usage : @locations = $locObject->each_Location($order);
127 Function: Conserved function call across Location:: modules - will
128 return an array containing the component Location(s) in
129 that object, regardless if the calling object is itself a
130 single location or one containing sublocations.
131 Returns : an array of Bio::LocationI implementing objects
132 Args : Optional sort order to be passed to sub_Location()
133  
134 =cut
135  
136 6355 ▶sub each_Location {
Subroutine each_Location: called CC=2 SCAR=6.9
Pod documented
137 6355 my ($self, $order) = @_;
138 6355 my @locs = ();
139 6355 foreach my $subloc ($self->sub_Location($order)) {
140 # Recursively check to get hierarchical split locations:
141 69369 push @locs, $subloc->each_Location($order);
142 }
143 6355 return @locs;
144 }
145  
146 =head2 sub_Location
147  
148 Title : sub_Location
149 Usage : @sublocs = $splitloc->sub_Location();
150 Function: Returns the array of sublocations making up this compound (split)
151 location. Those sublocations referring to the same sequence as
152 the root split location will be sorted by start position (forward
153 sort) or end position (reverse sort) and come first (before
154 those on other sequences).
155  
156 The sort order can be optionally specified or suppressed by the
157 value of the first argument. The default is no sort.
158  
159 Returns : an array of Bio::LocationI implementing objects
160 Args : Optionally 1, 0, or -1 for specifying a forward, no, or reverse
161 sort order
162  
163 =cut
164  
165 103804 ▶sub sub_Location {
Subroutine sub_Location: called CC=25 SCAR=39.6
Pod documented
166 103804 my ($self, $order) = @_;
167 103804 ▶ $order = 0 unless defined $order;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $order 6367 97437 103804
168 103804 ▶ if( defined($order) && ($order !~ /^-?\d+$/) ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $order and not $order =~ /^-?\d+$/) 0 103804 103804
Condition33%1/3
defined $order and not $order =~ /^-?\d+$/
!ll&&!rl&&r
01038040
MC/DC0%0/2
defined $order and not $order =~ /^-?\d+$/
defined $order not $order =~ /^-?\d+$/
Truth table33%1/3
A and not(B)
A= defined $orderB= not $order =~ /^-?\d+$/
ABresult
0X0
100
111
169 0 $self->throw("value $order passed in to sub_Location is $order, an invalid value");
170 }
171 103804 ▶ $order = 1 if($order > 1);
Branch: 1 branch
BranchTrueFalseTotal
if $order > 1 0 103804 103804
172 103804 ▶ $order = -1 if($order < -1);
Branch: 1 branch
BranchTrueFalseTotal
if $order < -1 0 103804 103804
173 103804 ▶ my @sublocs = defined $self->{'_sublocations'} ? @{$self->{'_sublocations'}} : ();
Branch: 1 branch
BranchTrueFalseTotal
defined $self->{'_sublocations'} ? : 96553 7251 103804
174  
175 # return the array if no ordering requested
176 103804 ▶ return @sublocs if( ($order == 0) || (! @sublocs) );
Branch: 1 branch
BranchTrueFalseTotal
if $order == 0 or not @sublocs 103802 2 103804
Condition66%2/3
$order == 0 or not @sublocs
l!l&&r!l&&!r
10380202
MC/DC50%1/2
$order == 0 or not @sublocs
$order == 0 not @sublocs
Truth table66%2/3
A or not(B)
A= $order == 0B= not @sublocs
ABresult
1X1
011
000
177
178 # sort those locations that are on the same sequence as the top (`master')
179 # if the top seq is undefined, we take the first defined in a sublocation
180 2 my $seqid = $self->seq_id();
181 2 my $i = 0;
182 2 ▶ while((! defined($seqid)) && ($i <= $#sublocs)) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $seqid and $i <= $#sublocs) 10 2 12
Condition66%2/3
not defined $seqid and $i <= $#sublocs
!ll&&!rl&&r
0210
MC/DC50%1/2
not defined $seqid and $i <= $#sublocs
not defined $seqid $i <= $#sublocs
Truth table66%2/3
not(A) and B
A= not defined $seqidB= $i <= $#sublocs
ABresult
0X0
100
111
183 10 $seqid = $sublocs[$i++]->seq_id();
184 }
185 2 ▶ if((! $self->seq_id()) && $seqid) {
Branch: 1 branch
BranchTrueFalseTotal
if (not $self->seq_id and $seqid) 0 2 2
Condition33%1/3
not $self->seq_id and $seqid
!ll&&!rl&&r
020
MC/DC0%0/2
not $self->seq_id and $seqid
not $self->seq_id $seqid
Truth table33%1/3
not(A) and B
A= not $self->seq_idB= $seqid
ABresult
0X0
100
111
186 0 $self->warn("sorted sublocation array requested but ".
187 "root location doesn't define seq_id ".
188 "(at least one sublocation does!)");
189 }
190 my @locs = ($seqid ?
191 0 ▶ grep { $_->seq_id() eq $seqid; } @sublocs :
Branch: 1 branch
BranchTrueFalseTotal
$seqid ? : 0 2 2
192 @sublocs);
193 2 ▶ if(@locs) {
Branch: 1 branch
BranchTrueFalseTotal
if (@locs) 2 0 2
194 2 ▶ if($order == 1) {
Branch: 1 branch
BranchTrueFalseTotal
if ($order == 1) { } 1 1 2
195 # Schwartzian transforms for performance boost
196 5 @locs = map { $_->[0] }
197 sort {
198 9 ▶ (defined $a && defined $b) ? $a->[1] <=> $b->[1] :
Branch: 2 branches
BranchTrueFalseTotal
defined $a && defined $b ? : 9 0 9
$a ? : 0 0 0
Condition33%1/3
defined $a and defined $b
!ll&&!rl&&r
009
MC/DC0%0/2
defined $a and defined $b
defined $a defined $b
Truth table33%1/3
A and B
A= defined $aB= defined $b
ABresult
0X0
100
111
199 $a ? -1 : 1
200 }
201 map {
202 1 ▶ [$_, (defined $_->start ? $_->start : $_->end)]
Branch: 1 branch
BranchTrueFalseTotal
defined $_->start ? : 5 0 5
203 } @locs;;
204 } else { # $order == -1
205 5 @locs = map { $_->[0]}
206 sort {
207 6 ▶ (defined $a && defined $b) ? $b->[1] <=> $a->[1] :
Branch: 2 branches
BranchTrueFalseTotal
defined $a && defined $b ? : 6 0 6
$a ? : 0 0 0
Condition33%1/3
defined $a and defined $b
!ll&&!rl&&r
006
MC/DC0%0/2
defined $a and defined $b
defined $a defined $b
Truth table33%1/3
A and B
A= defined $aB= defined $b
ABresult
0X0
100
111
208 $a ? -1 : 1
209 }
210 map {
211 1 ▶ [$_, (defined $_->end ? $_->end : $_->start)]
Branch: 1 branch
BranchTrueFalseTotal
defined $_->end ? : 5 0 5
212 } @locs;
213 }
214 }
215 # push the rest unsorted
216 2 ▶ if($seqid) {
Branch: 1 branch
BranchTrueFalseTotal
if ($seqid) 0 2 2
217 0 push(@locs, grep { $_->seq_id() ne $seqid; } @sublocs);
218 }
219 # done!
220  
221 2 return @locs;
222 }
223  
224 =head2 add_sub_Location
225  
226 Title : add_sub_Location
227 Usage : $splitloc->add_sub_Location(@locationIobjs);
228 Function: add an additional sublocation
229 Returns : number of current sub locations
230 Args : list of Bio::LocationI implementing object(s) to add
231  
232 =cut
233  
234 35492 ▶sub add_sub_Location {
Subroutine add_sub_Location: called CC=4 SCAR=15.2
Pod documented
235 35492 my ($self,@args) = @_;
236 35492 my @locs;
237 35492 foreach my $loc ( @args ) {
238 35492 ▶ if( !ref($loc) || ! $loc->isa('Bio::LocationI') ) {
Branch: 1 branch
BranchTrueFalseTotal
unless (ref $loc and $loc->isa("Bio::LocationI")) 0 35492 35492
Condition33%1/3
ref $loc and $loc->isa("Bio::LocationI")
!ll&&!rl&&r
0035492
MC/DC0%0/2
ref $loc and $loc->isa("Bio::LocationI")
ref $loc $loc->isa("Bio::LocationI")
Truth table33%1/3
A and B
A= ref $locB= $loc->isa("Bio::LocationI")
ABresult
0X0
100
111
239 0 $self->throw("Trying to add $loc as a sub Location but it doesn't implement Bio::LocationI!");
240 0 next;
241 }
242 35492 push @{$self->{'_sublocations'}}, $loc;
243 }
244  
245 35492 return scalar @{$self->{'_sublocations'}};
246 }
247  
248 =head2 splittype
249  
250 Title : splittype
251 Usage : $splittype = $location->splittype();
252 Function: get/set the split splittype
253 Returns : the splittype of split feature (join, order)
254 Args : splittype to set
255  
256 =cut
257  
258 3742 ▶sub splittype {
Subroutine splittype: called CC=4 SCAR=14.0
Pod documented
259 3742 my ($self, $value) = @_;
260 3742 ▶ if( defined $value || ! defined $self->{'_splittype'} ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $value or not defined $self->{"_splittype"}) 3632 110 3742
Condition66%2/3
defined $value or not defined $self->{"_splittype"}
l!l&&r!l&&!r
36320110
MC/DC50%1/2
defined $value or not defined $self->{"_splittype"}
defined $value not defined $self->{"_splittype"}
Truth table66%2/3
A or not(B)
A= defined $valueB= not defined $self->{"_splittype"}
ABresult
1X1
011
000
261 3632 ▶ $value = 'JOIN' unless( defined $value );
Branch: 1 branch
BranchTrueFalseTotal
unless defined $value 0 3632 3632
262 3632 $self->{'_splittype'} = uc ($value);
263 }
264 3742 return $self->{'_splittype'};
265 }
266  
267 =head2 is_single_sequence
268  
269 Title : is_single_sequence
270 Usage : if($splitloc->is_single_sequence()) {
271 print "Location object $splitloc is split ".
272 "but only across a single sequence\n";
273 }
274 Function: Determine whether this location is split across a single or
275 multiple sequences.
276  
277 This implementation ignores (sub-)locations that do not define
278 seq_id(). The same holds true for the root location.
279  
280 Returns : TRUE if all sublocations lie on the same sequence as the root
281 location (feature), and FALSE otherwise.
282 Args : none
283  
284 =cut
285  
286 0 ▶sub is_single_sequence {
Subroutine is_single_sequence: not called CC=5 SCAR=34.0
Pod documented
287 0 my ($self) = @_;
288  
289 0 my $seqid = $self->seq_id();
290 0 foreach my $loc ($self->sub_Location(0)) {
291 0 ▶ $seqid = $loc->seq_id() if(! $seqid);
Branch: 1 branch
BranchTrueFalseTotal
unless $seqid 0 0 0
292 0 ▶ if(defined($loc->seq_id()) && ($loc->seq_id() ne $seqid)) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $loc->seq_id and $loc->seq_id ne $seqid) 0 0 0
Condition0%0/3
defined $loc->seq_id and $loc->seq_id ne $seqid
!ll&&!rl&&r
000
MC/DC0%0/2
defined $loc->seq_id and $loc->seq_id ne $seqid
defined $loc->seq_id $loc->seq_id ne $seqid
Truth table0%0/3
A and B
A= defined $loc->seq_idB= $loc->seq_id ne $seqid
ABresult
0X0
100
111
293 0 return 0;
294 }
295 }
296 0 return 1;
297 }
298  
299 =head2 guide_strand
300  
301 Title : guide_strand
302 Usage : $str = $loc->guide_strand();
303 Function: Get/Set the guide strand. Of use only if the split type is
304 a 'join' (this helps determine the order of sublocation
305 retrieval)
306 Returns : value of guide strand (1, -1, or undef)
307 Args : new value (-1 or 1, optional)
308  
309 =cut
310  
311 9030 ▶sub guide_strand {
Subroutine guide_strand: called CC=8 SCAR=20.8
Pod documented
312 9030 my $self = shift;
313 9030 ▶ return $self->{'strand'} = shift if @_;
Branch: 1 branch
BranchTrueFalseTotal
if @_ 3649 5381 9030
314  
315 # Sublocations strand values consistency check to set Guide Strand
316 5381 my @subloc_strands;
317 5381 foreach my $loc ($self->sub_Location(0)) {
318 52990 ▶ push @subloc_strands, $loc->strand || 1;
Condition50%1/2
$loc->strand || 1
l!l
529900
MC/DC0%0/1
$loc->strand || 1
$loc->strand
Truth table50%1/2
A
A= $loc->strand
Aresult
11
00
319 }
320 5381 ▶ if ($self->isa('Bio::Location::SplitLocationI')) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->isa("Bio::Location::SplitLocationI")) 5381 0 5381
321 5381 my $identical = 0;
322 5381 my $first_value = $subloc_strands[0];
323 5381 foreach my $strand (@subloc_strands) {
324 52990 ▶ $identical++ if ($strand == $first_value);
Branch: 1 branch
BranchTrueFalseTotal
if $strand == $first_value 52971 19 52990
325 }
326  
327 5381 ▶ if ($identical == scalar @subloc_strands) {
Branch: 1 branch
BranchTrueFalseTotal
if ($identical == scalar @subloc_strands) { } 5370 11 5381
328 5370 $self->{'strand'} = $first_value;
329 }
330 else {
331 11 $self->{'strand'} = undef;
332 }
333 }
334 5381 return $self->{'strand'};
335 }
336  
337 =head1 LocationI methods
338  
339 =head2 strand
340  
341 Title : strand
342 Usage : $obj->strand($newval)
343 Function: For SplitLocations, setting the strand of the container
344 (this object) is a short-cut for setting the strand of all
345 sublocations.
346  
347 In get-mode, checks if no sub-location is remote, and if
348 all have the same strand. If so, it returns that shared
349 strand value. Otherwise it returns undef.
350  
351 Example :
352 Returns : on get, value of strand if identical between sublocations
353 (-1, 1, or undef)
354 Args : new value (-1 or 1, optional)
355  
356  
357 =cut
358  
359 14164 ▶sub strand{
Subroutine strand: called CC=8 SCAR=20.8
Pod documented
360 14164 my ($self,$value) = @_;
361 14164 ▶ if( defined $value) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $value) { } 1655 12509 14164
362 1655 $self->{'strand'} = $value;
363 # propagate to all sublocs
364 1655 foreach my $loc ($self->sub_Location(0)) {
365 16728 $loc->strand($value);
366 }
367 }
368 else {
369 12509 my ($strand, $lstrand);
370 12509 foreach my $loc ($self->sub_Location(0)) {
371 # we give up upon any location that doesn't have
372 # the strand specified, or has a differing one set than
373 # previously seen.
374 # calling strand() is potentially expensive if the subloc
375 # is also a split location, so we cache it
376 124547 $lstrand = $loc->strand();
377 124547 ▶ if ( ! $lstrand
Branch: 2 branches
BranchTrueFalseTotal
if (not $lstrand or $strand and $strand != $lstrand) { } 12 124535 124547
elsif (not $strand) { } 12509 112026 124535
Condition83%5/6
not $lstrand or $strand and $strand != $lstrand
l!l&&r!l&&!r
012124535
$strand and $strand != $lstrand
!ll&&!rl&&r
1250911202612
MC/DC66%2/3
not $lstrand or $strand and $strand != $lstrand
not $lstrand $strand $strand != $lstrand
Truth table75%3/4
not(A) or B and C
A= not $lstrandB= $strandC= $strand != $lstrand
ABCresult
1XX1
0111
00X0
0100
378 or ($strand and ($strand != $lstrand))
379 ) {
380 12 $strand = undef;
381 12 last;
382 }
383 elsif (! $strand) {
384 12509 $strand = $lstrand;
385 }
386 }
387 12509 return $strand;
388 }
389 }
390  
391 =head2 flip_strand
392  
393 Title : flip_strand
394 Usage : $location->flip_strand();
395 Function: Flip-flop a strand to the opposite. Also sets Split strand
396 to be consistent with the sublocation strands
397 (1, -1 or undef for mixed strand values)
398 Returns : None
399 Args : None
400  
401 =cut
402  
403 62 ▶sub flip_strand {
Subroutine flip_strand: called CC=6 SCAR=19.1
Pod documented
404 62 my $self = shift;
405 62 my @sublocs;
406 my @subloc_strands;
407  
408 62 for my $loc ( $self->sub_Location(0) ) {
409 # Atomic "flip_strand" now initialize strand if necessary
410 234 my $new_strand = $loc->flip_strand;
411  
412 # Store strand values for later consistency check
413 234 push @sublocs, $loc;
414 234 push @subloc_strands, $new_strand;
415 }
416  
417 # Sublocations strand values consistency check to set Guide Strand
418 62 ▶ if ($self->isa('Bio::Location::SplitLocationI')) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->isa("Bio::Location::SplitLocationI")) 62 0 62
419 62 my $identical = 0;
420 62 my $first_value = $subloc_strands[0];
421 62 foreach my $strand (@subloc_strands) {
422 234 ▶ $identical++ if ($strand == $first_value);
Branch: 1 branch
BranchTrueFalseTotal
if $strand == $first_value 234 0 234
423 }
424  
425 62 ▶ if ($identical == scalar @subloc_strands) {
Branch: 1 branch
BranchTrueFalseTotal
if ($identical == scalar @subloc_strands) { } 62 0 62
426 62 $self->guide_strand($first_value);
427 }
428 else {
429 # Mixed strand values, must reverse the sublocations order
430 0 $self->guide_strand(undef);
431 0 @{ $self->{_sublocations} } = reverse @sublocs;
432 }
433 }
434 }
435  
436 =head2 start
437  
438 Title : start
439 Usage : $start = $location->start();
440 Function: get the starting point of the first (sorted) sublocation
441 Returns : integer
442 Args : none
443  
444 =cut
445  
446 36397 ▶sub start {
Subroutine start: called CC=2 SCAR=7.6
Pod documented
447 36397 my ($self,$value) = @_;
448 36397 ▶ if( defined $value ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $value) 0 36397 36397
449 0 $self->throw( "Trying to set the starting point of a split location, "
450 . "that is not possible, try manipulating the sub Locations");
451 }
452 36397 return $self->SUPER::start();
453 }
454  
455 =head2 end
456  
457 Title : end
458 Usage : $end = $location->end();
459 Function: get the ending point of the last (sorted) sublocation
460 Returns : integer
461 Args : none
462  
463 =cut
464  
465 32771 ▶sub end {
Subroutine end: called CC=2 SCAR=7.6
Pod documented
466 32771 my ($self,$value) = @_;
467 32771 ▶ if( defined $value ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $value) 0 32771 32771
468 0 $self->throw( "Trying to set the ending point of a split location, "
469 . "that is not possible, try manipulating the sub Locations");
470 }
471 32771 return $self->SUPER::end();
472 }
473  
474 =head2 min_start
475  
476 Title : min_start
477 Usage : $min_start = $location->min_start();
478 Function: get the minimum starting point
479 Returns : the minimum starting point from the contained sublocations
480 Args : none
481  
482 =cut
483  
484 36402 ▶sub min_start {
Subroutine min_start: called CC=3 SCAR=11.3
Pod documented
485 36402 my ($self, $value) = @_;
486  
487 36402 ▶ if( defined $value ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $value) 0 36402 36402
488 0 $self->throw( "Trying to set the minimum starting point of a split "
489 . "location, that is not possible, try manipulating the sub Locations");
490 }
491 # No sort by default because it breaks circular cut by origin features
492 # (like "join(2006035..2007700,1..257)"). Sorting is user responsability.
493 # Assume Start to be 1st segment start and End to be last segment End.
494 36402 my @locs = $self->sub_Location(0);
495 36402 ▶ return ( @locs ) ? $locs[0]->min_start : undef;
Branch: 1 branch
BranchTrueFalseTotal
@locs ? : 32777 3625 36402
496 }
497  
498 =head2 max_start
499  
500 Title : max_start
501 Usage : my $maxstart = $location->max_start();
502 Function: Get maximum starting location of feature startpoint
503 Returns : integer or undef if no maximum starting point.
504 Args : none
505  
506 =cut
507  
508 4520 ▶sub max_start {
Subroutine max_start: called CC=3 SCAR=11.3
Pod documented
509 4520 my ($self,$value) = @_;
510  
511 4520 ▶ if( defined $value ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $value) 0 4520 4520
512 0 $self->throw( "Trying to set the maximum starting point of a split "
513 . "location, that is not possible, try manipulating the sub Locations");
514 }
515 # No sort by default because it breaks circular cut by origin features
516 # (like "join(2006035..2007700,1..257)"). Sorting is user responsability.
517 # Assume Start to be 1st segment start and End to be last segment End.
518 4520 my @locs = $self->sub_Location(0);
519 4520 ▶ return ( @locs ) ? $locs[0]->max_start : undef;
Branch: 1 branch
BranchTrueFalseTotal
@locs ? : 895 3625 4520
520 }
521  
522 =head2 start_pos_type
523  
524 Title : start_pos_type
525 Usage : my $start_pos_type = $location->start_pos_type();
526 Function: Get start position type (ie <,>, ^)
527 Returns : type of position coded as text
528 ('BEFORE', 'AFTER', 'EXACT','WITHIN', 'BETWEEN')
529 Args : none
530  
531 =cut
532  
533 5 ▶sub start_pos_type {
Subroutine start_pos_type: called CC=3 SCAR=12.0
Pod documented
534 5 my ($self,$value) = @_;
535  
536 5 ▶ if( defined $value ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $value) 0 5 5
537 0 $self->throw( "Trying to set the start_pos_type of a split location, "
538 . "that is not possible, try manipulating the sub Locations");
539 }
540 # No sort by default because it breaks circular cut by origin features
541 # (like "join(2006035..2007700,1..257)"). Sorting is user responsability.
542 # Assume Start to be 1st segment start and End to be last segment End.
543 5 my @locs = $self->sub_Location(0);
544 5 ▶ return ( @locs ) ? $locs[0]->start_pos_type : undef;
Branch: 1 branch
BranchTrueFalseTotal
@locs ? : 5 0 5
545 }
546  
547 =head2 min_end
548  
549 Title : min_end
550 Usage : my $minend = $location->min_end();
551 Function: Get minimum ending location of feature endpoint
552 Returns : integer or undef if no minimum ending point.
553 Args : none
554  
555 =cut
556  
557 510 ▶sub min_end {
Subroutine min_end: called CC=11 SCAR=24.3
Pod documented
558 510 my ($self,$value) = @_;
559  
560 510 ▶ if( defined $value ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $value) 0 510 510
561 0 $self->throw( "Trying to set the minimum end point of a split location, "
562 . "that is not possible, try manipulating the sub Locations");
563 }
564 # No sort by default because it breaks circular cut by origin features
565 # (like "join(2006035..2007700,1..257)"). Sorting is user responsability.
566 # Assume Start to be 1st segment start and End to be last segment End.
567 510 my @locs = $self->sub_Location(0);
568  
569 # Return the End corresponding to the same sequence as the top ('master')
570 # if the top seq is undefined, take the first defined in a sublocation.
571 # Example: for "join(1..100,J00194.1:100..202)", End would be 100
572 510 my $seqid = $self->seq_id;
573 510 my $i = 0;
574 510 ▶ while (not defined $seqid and $i <= $#locs) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $seqid and $i <= $#locs) 6 510 516
Condition100%3/3
not defined $seqid and $i <= $#locs
!ll&&!rl&&r
50736
MC/DC100%2/2
not defined $seqid and $i <= $#locs
not defined $seqid $i <= $#locs
Truth table100%3/3
not(A) and B
A= not defined $seqidB= $i <= $#locs
ABresult
0X0
100
111
575 6 $seqid = $locs[$i++]->seq_id;
576 }
577  
578 510 ▶ my @same_id_locs = ($seqid ? grep { $_->seq_id eq $seqid } @locs
Branch: 1 branch
BranchTrueFalseTotal
$seqid ? : 507 3 510
579 : @locs);
580 # If there is a $seqid but no sublocations have the same id,
581 # try with the first id found in the sublocations instead,
582 # and if that fails return the last segment value
583 510 ▶ if (@locs and not @same_id_locs) {
Branch: 1 branch
BranchTrueFalseTotal
if (@locs and not @same_id_locs) 1 509 510
Condition66%2/3
@locs and not @same_id_locs
!ll&&!rl&&r
05091
MC/DC50%1/2
@locs and not @same_id_locs
@locs not @same_id_locs
Truth table66%2/3
A and not(B)
A= @locsB= not @same_id_locs
ABresult
0X0
100
111
584 1 my $first_id;
585 1 ▶ while (not defined $first_id and $i <= $#locs) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $first_id and $i <= $#locs) 1 1 2
Condition66%2/3
not defined $first_id and $i <= $#locs
!ll&&!rl&&r
101
MC/DC50%1/2
not defined $first_id and $i <= $#locs
not defined $first_id $i <= $#locs
Truth table66%2/3
not(A) and B
A= not defined $first_idB= $i <= $#locs
ABresult
0X0
100
111
586 1 $first_id = $locs[$i++]->seq_id;
587 }
588 1 ▶ @same_id_locs = ($first_id ? grep { $_->seq_id eq $first_id } @locs
Branch: 1 branch
BranchTrueFalseTotal
$first_id ? : 1 0 1
589 : @locs);
590 }
591 510 ▶ return ( @same_id_locs ) ? $same_id_locs[-1]->min_end : undef;
Branch: 1 branch
BranchTrueFalseTotal
@same_id_locs ? : 510 0 510
592 }
593  
594 =head2 max_end
595  
596 Title : max_end
597 Usage : my $maxend = $location->max_end();
598 Function: Get maximum ending location of feature endpoint
599 Returns : integer or undef if no maximum ending point.
600 Args : none
601  
602 =cut
603  
604 32776 ▶sub max_end {
Subroutine max_end: called CC=11 SCAR=24.3
Pod documented
605 32776 my ($self,$value) = @_;
606  
607 32776 ▶ if( defined $value ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $value) 0 32776 32776
608 0 $self->throw( "Trying to set the maximum end point of a split location, "
609 ."that is not possible, try manipulating the sub Locations");
610 }
611 # No sort by default because it breaks circular cut by origin features
612 # (like "join(2006035..2007700,1..257)"). Sorting is user responsability.
613 # Assume Start to be 1st segment start and End to be last segment End.
614 32776 my @locs = $self->sub_Location(0);
615  
616 # Return the End corresponding to the same sequence as the top ('master')
617 # if the top seq is undefined, take the first defined in a sublocation.
618 # Example: for "join(1..100,J00194.1:100..202)", End would be 100
619 32776 my $seqid = $self->seq_id;
620 32776 my $i = 0;
621 32776 ▶ while (not defined $seqid and $i <= $#locs) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $seqid and $i <= $#locs) 537 32776 33313
Condition100%3/3
not defined $seqid and $i <= $#locs
!ll&&!rl&&r
32661115537
MC/DC100%2/2
not defined $seqid and $i <= $#locs
not defined $seqid $i <= $#locs
Truth table100%3/3
not(A) and B
A= not defined $seqidB= $i <= $#locs
ABresult
0X0
100
111
622 537 $seqid = $locs[$i++]->seq_id;
623 }
624  
625 32776 ▶ my @same_id_locs = ($seqid ? grep { $_->seq_id eq $seqid } @locs
Branch: 1 branch
BranchTrueFalseTotal
$seqid ? : 32661 115 32776
626 : @locs);
627 # If there is a $seqid but no sublocations have the same id,
628 # try with the first id found in the sublocations instead,
629 # and if that fails return the last segment value
630 32776 ▶ if (@locs and not @same_id_locs) {
Branch: 1 branch
BranchTrueFalseTotal
if (@locs and not @same_id_locs) 1 32775 32776
Condition66%2/3
@locs and not @same_id_locs
!ll&&!rl&&r
0327751
MC/DC50%1/2
@locs and not @same_id_locs
@locs not @same_id_locs
Truth table66%2/3
A and not(B)
A= @locsB= not @same_id_locs
ABresult
0X0
100
111
631 1 my $first_id;
632 1 ▶ while (not defined $first_id and $i <= $#locs) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $first_id and $i <= $#locs) 1 1 2
Condition66%2/3
not defined $first_id and $i <= $#locs
!ll&&!rl&&r
101
MC/DC50%1/2
not defined $first_id and $i <= $#locs
not defined $first_id $i <= $#locs
Truth table66%2/3
not(A) and B
A= not defined $first_idB= $i <= $#locs
ABresult
0X0
100
111
633 1 $first_id = $locs[$i++]->seq_id;
634 }
635 1 ▶ @same_id_locs = ($first_id ? grep { $_->seq_id eq $first_id } @locs
Branch: 1 branch
BranchTrueFalseTotal
$first_id ? : 1 0 1
636 : @locs);
637 }
638 32776 ▶ return ( @same_id_locs ) ? $same_id_locs[-1]->max_end : undef;
Branch: 1 branch
BranchTrueFalseTotal
@same_id_locs ? : 32776 0 32776
639 }
640  
641 =head2 end_pos_type
642  
643 Title : end_pos_type
644 Usage : my $end_pos_type = $location->end_pos_type();
645 Function: Get end position type (ie <,>, ^)
646 Returns : type of position coded as text
647 ('BEFORE', 'AFTER', 'EXACT','WITHIN', 'BETWEEN')
648 Args : none
649  
650 =cut
651  
652 5 ▶sub end_pos_type {
Subroutine end_pos_type: called CC=11 SCAR=24.3
Pod documented
653 5 my ($self,$value) = @_;
654  
655 5 ▶ if( defined $value ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $value) 0 5 5
656 0 $self->throw( "Trying to set end_pos_type of a split location, "
657 . "that is not possible, try manipulating the sub Locations");
658 }
659 # No sort by default because it breaks circular cut by origin features
660 # (like "join(2006035..2007700,1..257)"). Sorting is user responsability.
661 # Assume Start to be 1st segment start and End to be last segment End.
662 5 my @locs = $self->sub_Location(0);
663  
664 # Return the End corresponding to the same sequence as the top ('master')
665 # if the top seq is undefined, take the first defined in a sublocation.
666 # Example: for "join(1..>100,J00194.1:100..202)", End pos type would be 'AFTER'
667 5 my $seqid = $self->seq_id;
668 5 my $i = 0;
669 5 ▶ while (not defined $seqid and $i <= $#locs) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $seqid and $i <= $#locs) 6 5 11
Condition100%3/3
not defined $seqid and $i <= $#locs
!ll&&!rl&&r
236
MC/DC100%2/2
not defined $seqid and $i <= $#locs
not defined $seqid $i <= $#locs
Truth table100%3/3
not(A) and B
A= not defined $seqidB= $i <= $#locs
ABresult
0X0
100
111
670 6 $seqid = $locs[$i++]->seq_id;
671 }
672  
673 5 ▶ my @same_id_locs = ($seqid ? grep { $_->seq_id eq $seqid } @locs
Branch: 1 branch
BranchTrueFalseTotal
$seqid ? : 2 3 5
674 : @locs);
675 # If there is a $seqid but no sublocations have the same id,
676 # try with the first id found in the sublocations instead,
677 # and if that fails return the last segment value
678 5 ▶ if (@locs and not @same_id_locs) {
Branch: 1 branch
BranchTrueFalseTotal
if (@locs and not @same_id_locs) 1 4 5
Condition66%2/3
@locs and not @same_id_locs
!ll&&!rl&&r
041
MC/DC50%1/2
@locs and not @same_id_locs
@locs not @same_id_locs
Truth table66%2/3
A and not(B)
A= @locsB= not @same_id_locs
ABresult
0X0
100
111
679 1 my $first_id;
680 1 ▶ while (not defined $first_id and $i <= $#locs) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $first_id and $i <= $#locs) 1 1 2
Condition66%2/3
not defined $first_id and $i <= $#locs
!ll&&!rl&&r
101
MC/DC50%1/2
not defined $first_id and $i <= $#locs
not defined $first_id $i <= $#locs
Truth table66%2/3
not(A) and B
A= not defined $first_idB= $i <= $#locs
ABresult
0X0
100
111
681 1 $first_id = $locs[$i++]->seq_id;
682 }
683 1 ▶ @same_id_locs = ($first_id ? grep { $_->seq_id eq $first_id } @locs
Branch: 1 branch
BranchTrueFalseTotal
$first_id ? : 1 0 1
684 : @locs);
685 }
686 5 ▶ return ( @same_id_locs ) ? $same_id_locs[-1]->end_pos_type : undef;
Branch: 1 branch
BranchTrueFalseTotal
@same_id_locs ? : 5 0 5
687 }
688  
689 =head2 length
690  
691 Title : length
692 Usage : $len = $loc->length();
693 Function: get the length in the coordinate space this location spans
694 Example :
695 Returns : an integer
696 Args : none
697  
698 =cut
699  
700 1 ▶sub length {
Subroutine length: called CC=10 SCAR=40.5
Pod documented
701 1 my ($self) = @_;
702 1 my $length = 0;
703 # Mixed strand values means transplicing (where exons can even
704 # be in different chromosomes), so in that case only give the sum
705 # of the lengths of the individual segments
706 1 ▶ if (! defined $self->guide_strand) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $self->guide_strand) { } 1 0 1
707 1 for my $loc ( $self->sub_Location(0) ) {
708 2 $length += abs($loc->end - $loc->start) + 1;
709 }
710 }
711 else {
712 0 my @sublocs = $self->sub_Location(0);
713 0 my $start = $sublocs[0]->start;
714 0 my $end = $sublocs[-1]->end;
715  
716 # If Start > End, its a possible case of cut by origin
717 # location in circular sequences (e.g "join(16..20,1..2)")
718 0 ▶ if ($start > $end) {
Branch: 1 branch
BranchTrueFalseTotal
if ($start > $end) { } 0 0 0
719 # Figure out which segments are located before
720 # and which are located after coordinate 1
721 # (END_SEQ - 1 - START_SEQ)
722 0 my @end_seq_segments;
723 my @start_seq_segments;
724 0 my $switch = 0;
725 0 foreach my $subloc (@sublocs) {
726 0 ▶ if ($switch == 0) {
Branch: 1 branch
BranchTrueFalseTotal
if ($switch == 0) { } 0 0 0
727 0 ▶ if ($subloc->start == 1) {
Branch: 1 branch
BranchTrueFalseTotal
if ($subloc->start == 1) { } 0 0 0
728 0 $switch = 1;
729 0 push @start_seq_segments, $subloc;
730 }
731 else {
732 0 push @end_seq_segments, $subloc;
733 }
734 }
735 else {
736 0 push @start_seq_segments, $subloc;
737 }
738 }
739  
740 # If its a cut by origin location, sum the whole length of each group
741 0 ▶ if (scalar @end_seq_segments > 0 and @start_seq_segments > 0) {
Branch: 1 branch
BranchTrueFalseTotal
if (scalar @end_seq_segments > 0 and @start_seq_segments > 0) 0 0 0
Condition0%0/3
scalar @end_seq_segments > 0 and @start_seq_segments > 0
!ll&&!rl&&r
000
MC/DC0%0/2
scalar @end_seq_segments > 0 and @start_seq_segments > 0
scalar @end_seq_segments > 0 @start_seq_segments > 0
Truth table0%0/3
A and B
A= scalar @end_seq_segments > 0B= @start_seq_segments > 0
ABresult
0X0
100
111
742 0 my $end_segments_length = abs( $end_seq_segments[0]->start
743 - $end_seq_segments[-1]->end)
744 + 1;
745 0 my $start_segments_length = abs( $start_seq_segments[0]->start
746 - $start_seq_segments[-1]->end)
747 + 1;
748 0 $length = $end_segments_length + $start_segments_length;
749 }
750 }
751 else {
752 0 $length = $end - $start + 1;
753 }
754 }
755  
756 # If for some reason nothing worked, fall back to previous behaviour
757 1 ▶ if ($length == 0) {
Branch: 1 branch
BranchTrueFalseTotal
if ($length == 0) 0 1 1
758 0 $length = abs($self->end - $self->start) + 1
759 }
760  
761 1 return $length;
762 }
763  
764 =head2 seq_id
765  
766 Title : seq_id
767 Usage : my $seqid = $location->seq_id();
768 Function: Get/Set seq_id that location refers to
769  
770 We override this here in order to propagate to all sublocations
771 which are not remote (provided this root is not remote either)
772 Returns : seq_id
773 Args : [optional] seq_id value to set
774  
775  
776 =cut
777  
778 37113 ▶sub seq_id {
Subroutine seq_id: called CC=5 SCAR=16.1
Pod documented
779 37113 my $self = shift;
780  
781 37113 ▶ if(@_ && !$self->is_remote()) {
Branch: 1 branch
BranchTrueFalseTotal
if (@_ and not $self->is_remote) 3549 33564 37113
Condition66%2/3
@_ and not $self->is_remote
!ll&&!rl&&r
3356403549
MC/DC50%1/2
@_ and not $self->is_remote
@_ not $self->is_remote
Truth table66%2/3
A and not(B)
A= @_B= not $self->is_remote
ABresult
0X0
100
111
782 3549 foreach my $subloc ($self->sub_Location(0)) {
783 35183 ▶ $subloc->seq_id(@_) if !$subloc->is_remote();
Branch: 1 branch
BranchTrueFalseTotal
unless $subloc->is_remote 35122 61 35183
784 }
785 }
786 37113 return $self->SUPER::seq_id(@_);
787 }
788  
789 =head2 coordinate_policy
790  
791 Title : coordinate_policy
792 Usage : $policy = $location->coordinate_policy();
793 $location->coordinate_policy($mypolicy); # set may not be possible
794 Function: Get the coordinate computing policy employed by this object.
795  
796 See Bio::Location::CoordinatePolicyI for documentation about
797 the policy object and its use.
798  
799 The interface *does not* require implementing classes to accept
800 setting of a different policy. The implementation provided here
801 does, however, allow one to do so.
802  
803 Implementors of this interface are expected to initialize every
804 new instance with a CoordinatePolicyI object. The implementation
805 provided here will return a default policy object if none has
806 been set yet. To change this default policy object call this
807 method as a class method with an appropriate argument. Note that
808 in this case only subsequently created Location objects will be
809 affected.
810  
811 Returns : A Bio::Location::CoordinatePolicyI implementing object.
812 Args : On set, a Bio::Location::CoordinatePolicyI implementing object.
813  
814 =head2 to_FTstring
815  
816 Title : to_FTstring
817 Usage : my $locstr = $location->to_FTstring()
818 Function: returns the FeatureTable string of this location
819 Returns : string
820 Args : none
821  
822 =cut
823  
824 58 ▶sub to_FTstring {
Subroutine to_FTstring: called CC=12 SCAR=25.1
Pod documented
825 58 my ($self) = @_;
826 58 my @strs;
827 58 ▶ my $strand = $self->strand() || 0;
Condition100%2/2
$self->strand || 0
l!l
517
MC/DC100%1/1
$self->strand || 0
$self->strand
Truth table100%2/2
A
A= $self->strand
Aresult
11
00
828 58 my $stype = lc($self->splittype());
829  
830 58 ▶ if( $strand < 0 ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($strand < 0) 31 27 58
831 31 $self->flip_strand; # this will recursively set the strand
832 # to +1 for all the sub locations
833 }
834
835 58 foreach my $loc ( $self->sub_Location(0) ) {
836 194 $loc->verbose($self->verbose);
837 194 my $str = $loc->to_FTstring();
838 # we only append the remote seq_id if it hasn't been done already
839 # by the sub-location (which it should if it knows it's remote)
840 # (and of course only if it's necessary)
841 194 ▶ if( (! $loc->is_remote) &&
Branch: 1 branch
BranchTrueFalseTotal
if (not $loc->is_remote and defined $self->seq_id and defined $loc->seq_id and $loc->seq_id ne $self->seq_id) 0 194 194
Condition77%7/9
not $loc->is_remote and defined $self->seq_id and defined $loc->seq_id and $loc->seq_id ne $self->seq_id
!ll&&!rl&&r
103910
not $loc->is_remote and defined $self->seq_id and defined $loc->seq_id
!ll&&!rl&&r
103091
not $loc->is_remote and defined $self->seq_id
!ll&&!rl&&r
178691
MC/DC0%0/4
not $loc->is_remote and defined $self->seq_id and defined $loc->seq_id and $loc->seq_id ne $self->seq_id
not $loc->is_remote defined $self->seq_id defined $loc->seq_id $loc->seq_id ne $self->seq_id
Truth table60%3/5
not(A) and B and C and D
A= not $loc->is_remoteB= defined $self->seq_idC= defined $loc->seq_idD= $loc->seq_id ne $self->seq_id
ABCDresult
0XXX0
10XX0
110X0
11100
11111
842 defined($self->seq_id) && defined($loc->seq_id) &&
843 ($loc->seq_id ne $self->seq_id) ) {
844 0 $str = sprintf("%s:%s", $loc->seq_id, $str);
845 }
846 194 push @strs, $str;
847 }
848 58 ▶ $self->flip_strand if $strand < 0;
Branch: 1 branch
BranchTrueFalseTotal
if $strand < 0 31 27 58
849 58 my $str;
850 58 ▶ if( @strs == 1 ) {
Branch: 2 branches
BranchTrueFalseTotal
if (@strs == 1) { } 6 52 58
elsif (@strs == 0) { } 0 52 52
851 6 ($str) = @strs;
852 } elsif( @strs == 0 ) {
853 0 $self->warn("no Sublocations for this splitloc, so not returning anything\n");
854 } else {
855 52 $str = sprintf("%s(%s)",lc $self->splittype, join(",", @strs));
856 }
857 58 ▶ if( $strand < 0 ) { # wrap this in a complement if it was unrolled
Branch: 1 branch
BranchTrueFalseTotal
if ($strand < 0) 31 27 58
858 31 $str = sprintf("%s(%s)",'complement',$str);
859 }
860  
861 58 return $str;
862 }
863  
864 =head2 valid_Location
865  
866 Title : valid_Location
867 Usage : if ($location->valid_location) {...};
868 Function: boolean method to determine whether location is considered valid
869 (has minimum requirements for Simple implementation)
870 Returns : Boolean value: true if location is valid, false otherwise
871 Args : none
872  
873 =cut
874  
875 # we'll probably need to override the RangeI methods since our locations will
876 # not be contiguous.
877  
878 298 1;
« Bio/SearchIO/IteratedSearchResultEventBuilder.pm ↑ Summary Bio/Search/Iteration/GenericIteration.pm »