| 1 | =head1 NAME | ||||||||||||||||||||||||||||
| 2 | |||||||||||||||||||||||||||||
| 3 | Bio::DB::GFF::Aggregator -- Aggregate GFF groups into composite features | ||||||||||||||||||||||||||||
| 4 | |||||||||||||||||||||||||||||
| 5 | =head1 SYNOPSIS | ||||||||||||||||||||||||||||
| 6 | |||||||||||||||||||||||||||||
| 7 | use Bio::DB::GFF; | ||||||||||||||||||||||||||||
| 8 | |||||||||||||||||||||||||||||
| 9 | my $agg1 = Bio::DB::GFF::Aggregator->new(-method => 'cistron', | ||||||||||||||||||||||||||||
| 10 | -main_method => 'locus', | ||||||||||||||||||||||||||||
| 11 | -sub_parts => ['allele','variant'] | ||||||||||||||||||||||||||||
| 12 | ); | ||||||||||||||||||||||||||||
| 13 | |||||||||||||||||||||||||||||
| 14 | my $agg2 = Bio::DB::GFF::Aggregator->new(-method => 'splice_group', | ||||||||||||||||||||||||||||
| 15 | -sub_parts => 'transcript'); | ||||||||||||||||||||||||||||
| 16 | |||||||||||||||||||||||||||||
| 17 | my $db = Bio::DB::GFF->new( -adaptor => 'dbi:mysql', | ||||||||||||||||||||||||||||
| 18 | -aggregator => [$agg1,$agg2], | ||||||||||||||||||||||||||||
| 19 | -dsn => 'dbi:mysql:elegans42', | ||||||||||||||||||||||||||||
| 20 | ); | ||||||||||||||||||||||||||||
| 21 | |||||||||||||||||||||||||||||
| 22 | |||||||||||||||||||||||||||||
| 23 | =head1 DESCRIPTION | ||||||||||||||||||||||||||||
| 24 | |||||||||||||||||||||||||||||
| 25 | Bio::DB::GFF::Aggregator is used to aggregate GFF groups into | ||||||||||||||||||||||||||||
| 26 | composite features. Each composite feature has a "main part", the | ||||||||||||||||||||||||||||
| 27 | top-level feature, and a series of zero or more subparts, retrieved | ||||||||||||||||||||||||||||
| 28 | with the sub_SeqFeature() method. The aggregator class is designed to | ||||||||||||||||||||||||||||
| 29 | be subclassable, allowing a variety of GFF feature types to be | ||||||||||||||||||||||||||||
| 30 | supported. | ||||||||||||||||||||||||||||
| 31 | |||||||||||||||||||||||||||||
| 32 | The base Bio::DB::GFF::Aggregator class is generic, and can be used to | ||||||||||||||||||||||||||||
| 33 | create specific instances to be passed to the -aggregator argument of | ||||||||||||||||||||||||||||
| 34 | Bio::DB::GFF-E<gt>new() call. The various subclasses of | ||||||||||||||||||||||||||||
| 35 | Bio::DB::GFF::Aggregator are tuned for specific common feature types | ||||||||||||||||||||||||||||
| 36 | such as clones, gapped alignments and transcripts. | ||||||||||||||||||||||||||||
| 37 | |||||||||||||||||||||||||||||
| 38 | Instances of Bio::DB::GFF::Aggregator have three attributes: | ||||||||||||||||||||||||||||
| 39 | |||||||||||||||||||||||||||||
| 40 | =over 3 | ||||||||||||||||||||||||||||
| 41 | |||||||||||||||||||||||||||||
| 42 | =item * | ||||||||||||||||||||||||||||
| 43 | |||||||||||||||||||||||||||||
| 44 | method | ||||||||||||||||||||||||||||
| 45 | |||||||||||||||||||||||||||||
| 46 | This is the GFF method field of the composite feature as a whole. For | ||||||||||||||||||||||||||||
| 47 | example, "transcript" may be used for a composite feature created by | ||||||||||||||||||||||||||||
| 48 | aggregating individual intron, exon and UTR features. | ||||||||||||||||||||||||||||
| 49 | |||||||||||||||||||||||||||||
| 50 | =item * | ||||||||||||||||||||||||||||
| 51 | |||||||||||||||||||||||||||||
| 52 | main method | ||||||||||||||||||||||||||||
| 53 | |||||||||||||||||||||||||||||
| 54 | Sometimes GFF groups are organized hierarchically, with one feature | ||||||||||||||||||||||||||||
| 55 | logically containing another. For example, in the C. elegans schema, | ||||||||||||||||||||||||||||
| 56 | methods of type "Sequence:curated" correspond to regions covered by | ||||||||||||||||||||||||||||
| 57 | curated genes. There can be zero or one main methods. | ||||||||||||||||||||||||||||
| 58 | |||||||||||||||||||||||||||||
| 59 | =item * | ||||||||||||||||||||||||||||
| 60 | |||||||||||||||||||||||||||||
| 61 | subparts | ||||||||||||||||||||||||||||
| 62 | |||||||||||||||||||||||||||||
| 63 | This is a list of one or more methods that correspond to the component | ||||||||||||||||||||||||||||
| 64 | features of the aggregates. For example, in the C. elegans database, | ||||||||||||||||||||||||||||
| 65 | the subparts of transcript are "intron", "exon" and "CDS". | ||||||||||||||||||||||||||||
| 66 | |||||||||||||||||||||||||||||
| 67 | =back | ||||||||||||||||||||||||||||
| 68 | |||||||||||||||||||||||||||||
| 69 | Aggregators have two main methods that can be overridden in | ||||||||||||||||||||||||||||
| 70 | subclasses: | ||||||||||||||||||||||||||||
| 71 | |||||||||||||||||||||||||||||
| 72 | =over 4 | ||||||||||||||||||||||||||||
| 73 | |||||||||||||||||||||||||||||
| 74 | =item * | ||||||||||||||||||||||||||||
| 75 | |||||||||||||||||||||||||||||
| 76 | disaggregate() | ||||||||||||||||||||||||||||
| 77 | |||||||||||||||||||||||||||||
| 78 | This method is called by the Adaptor object prior to fetching a list | ||||||||||||||||||||||||||||
| 79 | of features. The method is passed an associative array containing the | ||||||||||||||||||||||||||||
| 80 | [method,source] pairs that the user has requested, and it returns a | ||||||||||||||||||||||||||||
| 81 | list of raw features that it would like the adaptor to fetch. | ||||||||||||||||||||||||||||
| 82 | |||||||||||||||||||||||||||||
| 83 | =item * | ||||||||||||||||||||||||||||
| 84 | |||||||||||||||||||||||||||||
| 85 | aggregate() | ||||||||||||||||||||||||||||
| 86 | |||||||||||||||||||||||||||||
| 87 | This method is called by the Adaptor object after it has fetched | ||||||||||||||||||||||||||||
| 88 | features. The method is passed a list of raw features and is expected | ||||||||||||||||||||||||||||
| 89 | to add its composite features to the list. | ||||||||||||||||||||||||||||
| 90 | |||||||||||||||||||||||||||||
| 91 | =back | ||||||||||||||||||||||||||||
| 92 | |||||||||||||||||||||||||||||
| 93 | The disaggregate() and aggregate() methods provided by the base | ||||||||||||||||||||||||||||
| 94 | Aggregator class should be sufficient for many applications. In this | ||||||||||||||||||||||||||||
| 95 | case, it suffices for subclasses to override the following methods: | ||||||||||||||||||||||||||||
| 96 | |||||||||||||||||||||||||||||
| 97 | =over 4 | ||||||||||||||||||||||||||||
| 98 | |||||||||||||||||||||||||||||
| 99 | =item * | ||||||||||||||||||||||||||||
| 100 | |||||||||||||||||||||||||||||
| 101 | method() | ||||||||||||||||||||||||||||
| 102 | |||||||||||||||||||||||||||||
| 103 | Return the default method for the composite feature as a whole. | ||||||||||||||||||||||||||||
| 104 | |||||||||||||||||||||||||||||
| 105 | =item * | ||||||||||||||||||||||||||||
| 106 | |||||||||||||||||||||||||||||
| 107 | main_name() | ||||||||||||||||||||||||||||
| 108 | |||||||||||||||||||||||||||||
| 109 | Return the default main method name. | ||||||||||||||||||||||||||||
| 110 | |||||||||||||||||||||||||||||
| 111 | =item * | ||||||||||||||||||||||||||||
| 112 | |||||||||||||||||||||||||||||
| 113 | part_names() | ||||||||||||||||||||||||||||
| 114 | |||||||||||||||||||||||||||||
| 115 | Return a list of subpart method names. | ||||||||||||||||||||||||||||
| 116 | |||||||||||||||||||||||||||||
| 117 | =back | ||||||||||||||||||||||||||||
| 118 | |||||||||||||||||||||||||||||
| 119 | Provided that method() and part_names() are overridden (and optionally | ||||||||||||||||||||||||||||
| 120 | main_name() as well), then the bare name of the aggregator subclass | ||||||||||||||||||||||||||||
| 121 | can be passed to the -aggregator of Bio::DB::GFF-E<gt>new(). For example, | ||||||||||||||||||||||||||||
| 122 | this is a small subclass that will aggregate features of type "allele" | ||||||||||||||||||||||||||||
| 123 | and "polymorphism" into an aggregate named "mutant": | ||||||||||||||||||||||||||||
| 124 | |||||||||||||||||||||||||||||
| 125 | package Bio::DB::GFF::Aggregator::mutant; | ||||||||||||||||||||||||||||
| 126 | |||||||||||||||||||||||||||||
| 127 | use strict; | ||||||||||||||||||||||||||||
| 128 | use Bio::DB::GFF::Aggregator; | ||||||||||||||||||||||||||||
| 129 | |||||||||||||||||||||||||||||
| 130 | use base qw(Bio::DB::GFF::Aggregator); | ||||||||||||||||||||||||||||
| 131 | |||||||||||||||||||||||||||||
| 132 | sub method { 'mutant' } | ||||||||||||||||||||||||||||
| 133 | |||||||||||||||||||||||||||||
| 134 | sub part_names { | ||||||||||||||||||||||||||||
| 135 | return qw(allele polymorphism); | ||||||||||||||||||||||||||||
| 136 | } | ||||||||||||||||||||||||||||
| 137 | |||||||||||||||||||||||||||||
| 138 | 1; | ||||||||||||||||||||||||||||
| 139 | |||||||||||||||||||||||||||||
| 140 | Once installed, this aggregator can be passed to Bio::DB::GFF-E<gt>new() | ||||||||||||||||||||||||||||
| 141 | by name like so: | ||||||||||||||||||||||||||||
| 142 | |||||||||||||||||||||||||||||
| 143 | my $db = Bio::DB::GFF->new( -adaptor => 'dbi:mysql', | ||||||||||||||||||||||||||||
| 144 | -aggregator => 'mutant', | ||||||||||||||||||||||||||||
| 145 | -dsn => 'dbi:mysql:elegans42', | ||||||||||||||||||||||||||||
| 146 | ); | ||||||||||||||||||||||||||||
| 147 | |||||||||||||||||||||||||||||
| 148 | =head1 API | ||||||||||||||||||||||||||||
| 149 | |||||||||||||||||||||||||||||
| 150 | The remainder of this document describes the public and private | ||||||||||||||||||||||||||||
| 151 | methods implemented by this module. | ||||||||||||||||||||||||||||
| 152 | |||||||||||||||||||||||||||||
| 153 | =cut | ||||||||||||||||||||||||||||
| 154 | |||||||||||||||||||||||||||||
| 155 | package Bio::DB::GFF::Aggregator; | ||||||||||||||||||||||||||||
| 156 | 34 | $Bio::DB::GFF::Aggregator::VERSION = '1.7.4'; | |||||||||||||||||||||||||||
| 157 | 34 | ▶ | use strict; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 158 | 34 | ▶ | use Bio::DB::GFF::Util::Rearrange; # for rearrange() | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 159 | 34 | ▶ | use Bio::DB::GFF::Feature; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 160 | |||||||||||||||||||||||||||||
| 161 | 34 | ▶ | use base qw(Bio::Root::Root); | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 162 | |||||||||||||||||||||||||||||
| 163 | 0 | ▶ | my $ALWAYS_TRUE = sub { 1 }; | ||||||||||||||||||||||||||
|
Subroutine
__ANON__: not called CC=1 SCAR=1.2
| |||||||||||||||||||||||||||||
| 164 | |||||||||||||||||||||||||||||
| 165 | =head2 new | ||||||||||||||||||||||||||||
| 166 | |||||||||||||||||||||||||||||
| 167 | Title : new | ||||||||||||||||||||||||||||
| 168 | Usage : $a = Bio::DB::GFF::Aggregator->new(@args) | ||||||||||||||||||||||||||||
| 169 | Function: create a new aggregator | ||||||||||||||||||||||||||||
| 170 | Returns : a Bio::DB::GFF::Aggregator object | ||||||||||||||||||||||||||||
| 171 | Args : see below | ||||||||||||||||||||||||||||
| 172 | Status : Public | ||||||||||||||||||||||||||||
| 173 | |||||||||||||||||||||||||||||
| 174 | This is the constructor for Bio::DB::GFF::Aggregator. Named arguments | ||||||||||||||||||||||||||||
| 175 | are as follows: | ||||||||||||||||||||||||||||
| 176 | |||||||||||||||||||||||||||||
| 177 | -method the method for the composite feature | ||||||||||||||||||||||||||||
| 178 | |||||||||||||||||||||||||||||
| 179 | -main_method the top-level raw feature, if any | ||||||||||||||||||||||||||||
| 180 | |||||||||||||||||||||||||||||
| 181 | -sub_parts the list of raw features that will form the subparts | ||||||||||||||||||||||||||||
| 182 | of the composite feature (array reference or scalar) | ||||||||||||||||||||||||||||
| 183 | |||||||||||||||||||||||||||||
| 184 | =cut | ||||||||||||||||||||||||||||
| 185 | |||||||||||||||||||||||||||||
| 186 | 20 | ▶ | sub new { | ||||||||||||||||||||||||||
|
Subroutine
new: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 187 | 20 | my $class = shift; | |||||||||||||||||||||||||||
| 188 | 20 | my ($method,$main,$sub_parts,$whole_object) = rearrange(['METHOD', | |||||||||||||||||||||||||||
| 189 | ['MAIN_PART','MAIN_METHOD'], | ||||||||||||||||||||||||||||
| 190 | ['SUB_METHODS','SUB_PARTS'], | ||||||||||||||||||||||||||||
| 191 | 'WHOLE_OBJECT' | ||||||||||||||||||||||||||||
| 192 | ],@_); | ||||||||||||||||||||||||||||
| 193 | 20 | return bless { | |||||||||||||||||||||||||||
| 194 | method => $method, | ||||||||||||||||||||||||||||
| 195 | main_method => $main, | ||||||||||||||||||||||||||||
| 196 | sub_parts => $sub_parts, | ||||||||||||||||||||||||||||
| 197 | require_whole_object => $whole_object, | ||||||||||||||||||||||||||||
| 198 | },$class; | ||||||||||||||||||||||||||||
| 199 | } | ||||||||||||||||||||||||||||
| 200 | |||||||||||||||||||||||||||||
| 201 | =head2 disaggregate | ||||||||||||||||||||||||||||
| 202 | |||||||||||||||||||||||||||||
| 203 | Title : disaggregate | ||||||||||||||||||||||||||||
| 204 | Usage : $a->disaggregate($types,$factory) | ||||||||||||||||||||||||||||
| 205 | Function: disaggregate type list into components | ||||||||||||||||||||||||||||
| 206 | Returns : a true value if this aggregator should be called to reaggregate | ||||||||||||||||||||||||||||
| 207 | Args : see below | ||||||||||||||||||||||||||||
| 208 | Status : Public | ||||||||||||||||||||||||||||
| 209 | |||||||||||||||||||||||||||||
| 210 | This method is called to disaggregate a list of types into the set of | ||||||||||||||||||||||||||||
| 211 | low-level features to be retrieved from the GFF database. The list of | ||||||||||||||||||||||||||||
| 212 | types is passed as an array reference containing a series of | ||||||||||||||||||||||||||||
| 213 | [method,source] pairs. This method synthesizes a new set of | ||||||||||||||||||||||||||||
| 214 | [method,source] pairs, and appends them to the list of requested | ||||||||||||||||||||||||||||
| 215 | types, changing the list in situ. | ||||||||||||||||||||||||||||
| 216 | |||||||||||||||||||||||||||||
| 217 | Arguments: | ||||||||||||||||||||||||||||
| 218 | |||||||||||||||||||||||||||||
| 219 | $types reference to an array of [method,source] pairs | ||||||||||||||||||||||||||||
| 220 | |||||||||||||||||||||||||||||
| 221 | $factory reference to the Adaptor object that is calling | ||||||||||||||||||||||||||||
| 222 | this method | ||||||||||||||||||||||||||||
| 223 | |||||||||||||||||||||||||||||
| 224 | Note that the API allows disaggregate() to remove types from the type | ||||||||||||||||||||||||||||
| 225 | list. This feature is probably not desirable and may be deprecated in | ||||||||||||||||||||||||||||
| 226 | the future. | ||||||||||||||||||||||||||||
| 227 | |||||||||||||||||||||||||||||
| 228 | =cut | ||||||||||||||||||||||||||||
| 229 | |||||||||||||||||||||||||||||
| 230 | # this is called at the beginning to turn the pseudo-type | ||||||||||||||||||||||||||||
| 231 | # into its component feature types | ||||||||||||||||||||||||||||
| 232 | 218 | ▶ | sub disaggregate { | ||||||||||||||||||||||||||
|
Subroutine
disaggregate: called CC=5 SCAR=16.1
Pod
documented
| |||||||||||||||||||||||||||||
| 233 | 218 | my $self = shift; | |||||||||||||||||||||||||||
| 234 | 218 | my $types = shift; | |||||||||||||||||||||||||||
| 235 | 218 | my $factory = shift; | |||||||||||||||||||||||||||
| 236 | |||||||||||||||||||||||||||||
| 237 | 218 | my $sub_features = $factory->parse_types($self->get_part_names); | |||||||||||||||||||||||||||
| 238 | 218 | my $main_feature = $factory->parse_types($self->get_main_name); | |||||||||||||||||||||||||||
| 239 | |||||||||||||||||||||||||||||
| 240 | 218 | ▶ | if (@$types) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 241 | 85 | my (@synthetic_types,@unchanged); | |||||||||||||||||||||||||||
| 242 | 85 | foreach (@$types) { | |||||||||||||||||||||||||||
| 243 | 270 | my ($method,$source) = @$_; | |||||||||||||||||||||||||||
| 244 | 270 | ▶ | if (lc $method eq lc $self->get_method) { # e.g. "transcript" | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 245 | 20 | ▶ | push @synthetic_types,map { [$_->[0],$_->[1] || $source] } @$sub_features,@$main_feature; | ||||||||||||||||||||||||||
|
Condition33%1/3
$_->[1] || $source
MC/DC0%0/2
$_->[1] || $source
$_->[1]
$source
Truth table33%1/3
A || B
A= $_->[1]B= $source
| |||||||||||||||||||||||||||||
| 246 | } | ||||||||||||||||||||||||||||
| 247 | else { | ||||||||||||||||||||||||||||
| 248 | 250 | push @unchanged,$_; | |||||||||||||||||||||||||||
| 249 | } | ||||||||||||||||||||||||||||
| 250 | } | ||||||||||||||||||||||||||||
| 251 | # remember what we're searching for | ||||||||||||||||||||||||||||
| 252 | 85 | $self->components(\@synthetic_types); | |||||||||||||||||||||||||||
| 253 | 85 | $self->passthru(\@unchanged); | |||||||||||||||||||||||||||
| 254 | 85 | @$types = (@unchanged,@synthetic_types); | |||||||||||||||||||||||||||
| 255 | } | ||||||||||||||||||||||||||||
| 256 | |||||||||||||||||||||||||||||
| 257 | # we get here when no search types are listed | ||||||||||||||||||||||||||||
| 258 | else { | ||||||||||||||||||||||||||||
| 259 | 133 | my @stypes = map { [$_->[0],$_->[1]] } @$sub_features,@$main_feature; | |||||||||||||||||||||||||||
| 260 | 133 | $self->components(\@stypes); | |||||||||||||||||||||||||||
| 261 | 133 | $self->passthru(undef); | |||||||||||||||||||||||||||
| 262 | } | ||||||||||||||||||||||||||||
| 263 | |||||||||||||||||||||||||||||
| 264 | 218 | return $self->component_count > 0; | |||||||||||||||||||||||||||
| 265 | } | ||||||||||||||||||||||||||||
| 266 | |||||||||||||||||||||||||||||
| 267 | |||||||||||||||||||||||||||||
| 268 | =head2 aggregate | ||||||||||||||||||||||||||||
| 269 | |||||||||||||||||||||||||||||
| 270 | Title : aggregate | ||||||||||||||||||||||||||||
| 271 | Usage : $features = $a->aggregate($features,$factory) | ||||||||||||||||||||||||||||
| 272 | Function: aggregate a feature list into composite features | ||||||||||||||||||||||||||||
| 273 | Returns : an array reference containing modified features | ||||||||||||||||||||||||||||
| 274 | Args : see below | ||||||||||||||||||||||||||||
| 275 | Status : Public | ||||||||||||||||||||||||||||
| 276 | |||||||||||||||||||||||||||||
| 277 | This method is called to aggregate a list of raw GFF features into the | ||||||||||||||||||||||||||||
| 278 | set of composite features. The method is called an array reference to | ||||||||||||||||||||||||||||
| 279 | a set of Bio::DB::GFF::Feature objects. It runs through the list, | ||||||||||||||||||||||||||||
| 280 | creating new composite features when appropriate. The method result | ||||||||||||||||||||||||||||
| 281 | is an array reference containing the composite features. | ||||||||||||||||||||||||||||
| 282 | |||||||||||||||||||||||||||||
| 283 | Arguments: | ||||||||||||||||||||||||||||
| 284 | |||||||||||||||||||||||||||||
| 285 | $features reference to an array of Bio::DB::GFF::Feature objects | ||||||||||||||||||||||||||||
| 286 | |||||||||||||||||||||||||||||
| 287 | $factory reference to the Adaptor object that is calling | ||||||||||||||||||||||||||||
| 288 | this method | ||||||||||||||||||||||||||||
| 289 | |||||||||||||||||||||||||||||
| 290 | NOTE: The reason that the function result contains the raw features as | ||||||||||||||||||||||||||||
| 291 | well as the aggregated ones is to allow queries like this one: | ||||||||||||||||||||||||||||
| 292 | |||||||||||||||||||||||||||||
| 293 | @features = $segment->features('exon','transcript:curated'); | ||||||||||||||||||||||||||||
| 294 | |||||||||||||||||||||||||||||
| 295 | Assuming that "transcript" is the name of an aggregated feature and | ||||||||||||||||||||||||||||
| 296 | that "exon" is one of its components, we do not want the transcript | ||||||||||||||||||||||||||||
| 297 | aggregator to remove features of type "exon" because the user asked | ||||||||||||||||||||||||||||
| 298 | for them explicitly. | ||||||||||||||||||||||||||||
| 299 | |||||||||||||||||||||||||||||
| 300 | =cut | ||||||||||||||||||||||||||||
| 301 | |||||||||||||||||||||||||||||
| 302 | 168 | ▶ | sub aggregate { | ||||||||||||||||||||||||||
|
Subroutine
aggregate: called CC=17 SCAR=30.2
Pod
documented
| |||||||||||||||||||||||||||||
| 303 | 168 | my $self = shift; | |||||||||||||||||||||||||||
| 304 | 168 | my $features = shift; | |||||||||||||||||||||||||||
| 305 | 168 | my $factory = shift; | |||||||||||||||||||||||||||
| 306 | |||||||||||||||||||||||||||||
| 307 | 168 | my $main_method = $self->get_main_name; | |||||||||||||||||||||||||||
| 308 | 168 | ▶ | my $matchsub = $self->match_sub($factory) or return; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 309 | 168 | my $strictmatch = $self->strict_match(); | |||||||||||||||||||||||||||
| 310 | 168 | my $passthru = $self->passthru_sub($factory); | |||||||||||||||||||||||||||
| 311 | |||||||||||||||||||||||||||||
| 312 | 168 | my (%aggregates,@result); | |||||||||||||||||||||||||||
| 313 | 168 | for my $feature (@$features) { | |||||||||||||||||||||||||||
| 314 | |||||||||||||||||||||||||||||
| 315 | 592 | ▶ | if ($feature->group && $matchsub->($feature)) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition66%2/3
$feature->group and &$matchsub($feature)
MC/DC50%1/2
$feature->group and &$matchsub($feature)
$feature->group
&$matchsub($feature)
Truth table66%2/3
A and B
A= $feature->groupB= &$matchsub($feature)
| |||||||||||||||||||||||||||||
| 316 | 282 | ▶ | my $key = $strictmatch->{lc $feature->method,lc $feature->source} | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 317 | ? join ($;,$feature->group,$feature->refseq,$feature->source) | ||||||||||||||||||||||||||||
| 318 | : join ($;,$feature->group,$feature->refseq); | ||||||||||||||||||||||||||||
| 319 | 282 | ▶ | if ($main_method && lc $feature->method eq lc $main_method) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition66%2/3
$main_method and lc $feature->method eq lc $main_method
MC/DC50%1/2
$main_method and lc $feature->method eq lc $main_method
$main_method
lc $feature->method eq lc $main_method
Truth table66%2/3
A and B
A= $main_methodB= lc $feature->method eq lc $main_method
| |||||||||||||||||||||||||||||
| 320 | 81 | ▶ | $aggregates{$key}{base} ||= $feature->clone; | ||||||||||||||||||||||||||
|
Condition33%1/3
$aggregates{$key}{"base"} ||= $feature->clone
MC/DC0%0/2
$aggregates{$key}{"base"} ||= $feature->clone
$aggregates{$key}{"base"}
$feature->clone
Truth table33%1/3
A ||= B
A= $aggregates{$key}{"base"}B= $feature->clone
| |||||||||||||||||||||||||||||
| 321 | } else { | ||||||||||||||||||||||||||||
| 322 | 201 | push @{$aggregates{$key}{subparts}},$feature; | |||||||||||||||||||||||||||
| 323 | } | ||||||||||||||||||||||||||||
| 324 | 282 | ▶ | push @result,$feature if $passthru && $passthru->($feature); | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
$passthru and &$passthru($feature)
MC/DC0%0/2
$passthru and &$passthru($feature)
$passthru
&$passthru($feature)
Truth table33%1/3
A and B
A= $passthruB= &$passthru($feature)
| |||||||||||||||||||||||||||||
| 325 | |||||||||||||||||||||||||||||
| 326 | } else { | ||||||||||||||||||||||||||||
| 327 | 310 | push @result,$feature; | |||||||||||||||||||||||||||
| 328 | } | ||||||||||||||||||||||||||||
| 329 | } | ||||||||||||||||||||||||||||
| 330 | |||||||||||||||||||||||||||||
| 331 | # aggregate components | ||||||||||||||||||||||||||||
| 332 | 168 | my $pseudo_method = $self->get_method; | |||||||||||||||||||||||||||
| 333 | 168 | my $require_whole_object = $self->require_whole_object; | |||||||||||||||||||||||||||
| 334 | 168 | foreach (keys %aggregates) { | |||||||||||||||||||||||||||
| 335 | 107 | ▶ | if ($require_whole_object && $self->components) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
$require_whole_object and $self->components
MC/DC0%0/2
$require_whole_object and $self->components
$require_whole_object
$self->components
Truth table33%1/3
A and B
A= $require_whole_objectB= $self->components
| |||||||||||||||||||||||||||||
| 336 | 0 | ▶ | next unless $aggregates{$_}{base}; # && $aggregates{$_}{subparts}; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 337 | } | ||||||||||||||||||||||||||||
| 338 | 107 | my $base = $aggregates{$_}{base}; | |||||||||||||||||||||||||||
| 339 | 107 | ▶ | unless ($base) { # no base, so create one | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 340 | 26 | my $first = $aggregates{$_}{subparts}[0]; | |||||||||||||||||||||||||||
| 341 | 26 | $base = $first->clone; # to inherit parent coordinate system, etc | |||||||||||||||||||||||||||
| 342 | 26 | $base->score(undef); | |||||||||||||||||||||||||||
| 343 | 26 | $base->phase(undef); | |||||||||||||||||||||||||||
| 344 | } | ||||||||||||||||||||||||||||
| 345 | 107 | $base->method($pseudo_method); | |||||||||||||||||||||||||||
| 346 | 107 | $base->add_subfeature($_) foreach @{$aggregates{$_}{subparts}}; | |||||||||||||||||||||||||||
| 347 | 107 | $base->adjust_bounds; | |||||||||||||||||||||||||||
| 348 | 107 | $base->compound(1); # set the compound flag | |||||||||||||||||||||||||||
| 349 | 107 | push @result,$base; | |||||||||||||||||||||||||||
| 350 | } | ||||||||||||||||||||||||||||
| 351 | 168 | @$features = @result; | |||||||||||||||||||||||||||
| 352 | } | ||||||||||||||||||||||||||||
| 353 | |||||||||||||||||||||||||||||
| 354 | |||||||||||||||||||||||||||||
| 355 | =head2 method | ||||||||||||||||||||||||||||
| 356 | |||||||||||||||||||||||||||||
| 357 | Title : method | ||||||||||||||||||||||||||||
| 358 | Usage : $string = $a->method | ||||||||||||||||||||||||||||
| 359 | Function: get the method type for the composite feature | ||||||||||||||||||||||||||||
| 360 | Returns : a string | ||||||||||||||||||||||||||||
| 361 | Args : none | ||||||||||||||||||||||||||||
| 362 | Status : Protected | ||||||||||||||||||||||||||||
| 363 | |||||||||||||||||||||||||||||
| 364 | This method is called to get the method to be assigned to the | ||||||||||||||||||||||||||||
| 365 | composite feature once it is aggregated. It is called if the user did | ||||||||||||||||||||||||||||
| 366 | not explicitly supply a -method argument when the aggregator was | ||||||||||||||||||||||||||||
| 367 | created. | ||||||||||||||||||||||||||||
| 368 | |||||||||||||||||||||||||||||
| 369 | This is the method that should be overridden in aggregator subclasses. | ||||||||||||||||||||||||||||
| 370 | |||||||||||||||||||||||||||||
| 371 | =cut | ||||||||||||||||||||||||||||
| 372 | |||||||||||||||||||||||||||||
| 373 | # default method - override in subclasses | ||||||||||||||||||||||||||||
| 374 | 0 | ▶ | sub method { | ||||||||||||||||||||||||||
|
Subroutine
method: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||
| 375 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 376 | 0 | $self->{method}; | |||||||||||||||||||||||||||
| 377 | } | ||||||||||||||||||||||||||||
| 378 | |||||||||||||||||||||||||||||
| 379 | =head2 main_name | ||||||||||||||||||||||||||||
| 380 | |||||||||||||||||||||||||||||
| 381 | Title : main_name | ||||||||||||||||||||||||||||
| 382 | Usage : $string = $a->main_name | ||||||||||||||||||||||||||||
| 383 | Function: get the method type for the "main" component of the feature | ||||||||||||||||||||||||||||
| 384 | Returns : a string | ||||||||||||||||||||||||||||
| 385 | Args : none | ||||||||||||||||||||||||||||
| 386 | Status : Protected | ||||||||||||||||||||||||||||
| 387 | |||||||||||||||||||||||||||||
| 388 | This method is called to get the method of the "main component" of the | ||||||||||||||||||||||||||||
| 389 | composite feature. It is called if the user did not explicitly supply | ||||||||||||||||||||||||||||
| 390 | a -main-method argument when the aggregator was created. | ||||||||||||||||||||||||||||
| 391 | |||||||||||||||||||||||||||||
| 392 | This is the method that should be overridden in aggregator subclasses. | ||||||||||||||||||||||||||||
| 393 | |||||||||||||||||||||||||||||
| 394 | =cut | ||||||||||||||||||||||||||||
| 395 | |||||||||||||||||||||||||||||
| 396 | # no default main method | ||||||||||||||||||||||||||||
| 397 | 0 | ▶ | sub main_name { | ||||||||||||||||||||||||||
|
Subroutine
main_name: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||
| 398 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 399 | 0 | return; | |||||||||||||||||||||||||||
| 400 | } | ||||||||||||||||||||||||||||
| 401 | |||||||||||||||||||||||||||||
| 402 | =head2 part_names | ||||||||||||||||||||||||||||
| 403 | |||||||||||||||||||||||||||||
| 404 | Title : part_names | ||||||||||||||||||||||||||||
| 405 | Usage : @methods = $a->part_names | ||||||||||||||||||||||||||||
| 406 | Function: get the methods for the non-main various components of the feature | ||||||||||||||||||||||||||||
| 407 | Returns : a list of strings | ||||||||||||||||||||||||||||
| 408 | Args : none | ||||||||||||||||||||||||||||
| 409 | Status : Protected | ||||||||||||||||||||||||||||
| 410 | |||||||||||||||||||||||||||||
| 411 | This method is called to get the list of methods of the "main component" of the | ||||||||||||||||||||||||||||
| 412 | composite feature. It is called if the user did not explicitly supply | ||||||||||||||||||||||||||||
| 413 | a -main-method argument when the aggregator was created. | ||||||||||||||||||||||||||||
| 414 | |||||||||||||||||||||||||||||
| 415 | This is the method that should be overridden in aggregator subclasses. | ||||||||||||||||||||||||||||
| 416 | |||||||||||||||||||||||||||||
| 417 | =cut | ||||||||||||||||||||||||||||
| 418 | |||||||||||||||||||||||||||||
| 419 | # no default part names | ||||||||||||||||||||||||||||
| 420 | 0 | ▶ | sub part_names { | ||||||||||||||||||||||||||
|
Subroutine
part_names: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||
| 421 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 422 | 0 | return; | |||||||||||||||||||||||||||
| 423 | } | ||||||||||||||||||||||||||||
| 424 | |||||||||||||||||||||||||||||
| 425 | =head2 require_whole_object | ||||||||||||||||||||||||||||
| 426 | |||||||||||||||||||||||||||||
| 427 | Title : require_whole_object | ||||||||||||||||||||||||||||
| 428 | Usage : $bool = $a->require_whole_object | ||||||||||||||||||||||||||||
| 429 | Function: see below | ||||||||||||||||||||||||||||
| 430 | Returns : a boolean flag | ||||||||||||||||||||||||||||
| 431 | Args : none | ||||||||||||||||||||||||||||
| 432 | Status : Internal | ||||||||||||||||||||||||||||
| 433 | |||||||||||||||||||||||||||||
| 434 | This method returns true if the aggregator should refuse to aggregate | ||||||||||||||||||||||||||||
| 435 | an object unless both its main part and its subparts are present. | ||||||||||||||||||||||||||||
| 436 | |||||||||||||||||||||||||||||
| 437 | =cut | ||||||||||||||||||||||||||||
| 438 | |||||||||||||||||||||||||||||
| 439 | 168 | ▶ | sub require_whole_object { | ||||||||||||||||||||||||||
|
Subroutine
require_whole_object: called CC=2 SCAR=7.0
Pod
documented
| |||||||||||||||||||||||||||||
| 440 | 168 | my $self = shift; | |||||||||||||||||||||||||||
| 441 | 168 | my $d = $self->{require_whole_object}; | |||||||||||||||||||||||||||
| 442 | 168 | ▶ | $self->{require_whole_object} = shift if @_; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 443 | 168 | $d; | |||||||||||||||||||||||||||
| 444 | } | ||||||||||||||||||||||||||||
| 445 | |||||||||||||||||||||||||||||
| 446 | =head2 match_sub | ||||||||||||||||||||||||||||
| 447 | |||||||||||||||||||||||||||||
| 448 | Title : match_sub | ||||||||||||||||||||||||||||
| 449 | Usage : $coderef = $a->match_sub($factory) | ||||||||||||||||||||||||||||
| 450 | Function: generate a code reference that will match desired features | ||||||||||||||||||||||||||||
| 451 | Returns : a code reference | ||||||||||||||||||||||||||||
| 452 | Args : see below | ||||||||||||||||||||||||||||
| 453 | Status : Internal | ||||||||||||||||||||||||||||
| 454 | |||||||||||||||||||||||||||||
| 455 | This method is used internally to generate a code sub that will | ||||||||||||||||||||||||||||
| 456 | quickly filter out the raw features that we're interested in | ||||||||||||||||||||||||||||
| 457 | aggregating. The returned sub accepts a Feature and returns true if | ||||||||||||||||||||||||||||
| 458 | we should aggregate it, false otherwise. | ||||||||||||||||||||||||||||
| 459 | |||||||||||||||||||||||||||||
| 460 | =cut | ||||||||||||||||||||||||||||
| 461 | |||||||||||||||||||||||||||||
| 462 | #' make emacs happy | ||||||||||||||||||||||||||||
| 463 | |||||||||||||||||||||||||||||
| 464 | 168 | ▶ | sub match_sub { | ||||||||||||||||||||||||||
|
Subroutine
match_sub: called CC=3 SCAR=11.3
Pod
documented
| |||||||||||||||||||||||||||||
| 465 | 168 | my $self = shift; | |||||||||||||||||||||||||||
| 466 | 168 | my $factory = shift; | |||||||||||||||||||||||||||
| 467 | 168 | ▶ | my $types_to_aggregate = $self->components() or return; # saved from disaggregate call | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 468 | 168 | ▶ | return unless @$types_to_aggregate; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 469 | 168 | return $factory->make_match_sub($types_to_aggregate); | |||||||||||||||||||||||||||
| 470 | } | ||||||||||||||||||||||||||||
| 471 | |||||||||||||||||||||||||||||
| 472 | =head2 strict_match | ||||||||||||||||||||||||||||
| 473 | |||||||||||||||||||||||||||||
| 474 | Title : strict_match | ||||||||||||||||||||||||||||
| 475 | Usage : $strict = $a->strict_match | ||||||||||||||||||||||||||||
| 476 | Function: generate a hashref that indicates which subfeatures | ||||||||||||||||||||||||||||
| 477 | need to be tested strictly for matching sources before | ||||||||||||||||||||||||||||
| 478 | aggregating | ||||||||||||||||||||||||||||
| 479 | Returns : a hash ref | ||||||||||||||||||||||||||||
| 480 | Status : Internal | ||||||||||||||||||||||||||||
| 481 | |||||||||||||||||||||||||||||
| 482 | =cut | ||||||||||||||||||||||||||||
| 483 | |||||||||||||||||||||||||||||
| 484 | 168 | ▶ | sub strict_match { | ||||||||||||||||||||||||||
|
Subroutine
strict_match: called CC=3 SCAR=11.0
Pod
documented
| |||||||||||||||||||||||||||||
| 485 | 168 | my $self = shift; | |||||||||||||||||||||||||||
| 486 | 168 | my $types_to_aggregate = $self->components(); | |||||||||||||||||||||||||||
| 487 | 168 | my %strict; | |||||||||||||||||||||||||||
| 488 | 168 | for my $t (@$types_to_aggregate) { | |||||||||||||||||||||||||||
| 489 | 1432 | ▶ | $strict{lc $t->[0],lc $t->[1]}++ if defined $t->[1]; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 490 | } | ||||||||||||||||||||||||||||
| 491 | 168 | \%strict; | |||||||||||||||||||||||||||
| 492 | } | ||||||||||||||||||||||||||||
| 493 | |||||||||||||||||||||||||||||
| 494 | 168 | ▶ | sub passthru_sub { | ||||||||||||||||||||||||||
|
Subroutine
passthru_sub: called CC=3 SCAR=11.3
Pod
undocumented
| |||||||||||||||||||||||||||||
| 495 | 168 | my $self = shift; | |||||||||||||||||||||||||||
| 496 | 168 | my $factory = shift; | |||||||||||||||||||||||||||
| 497 | 168 | ▶ | my $passthru = $self->passthru() or return; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 498 | 20 | ▶ | return unless @$passthru; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 499 | 0 | return $factory->make_match_sub($passthru); | |||||||||||||||||||||||||||
| 500 | } | ||||||||||||||||||||||||||||
| 501 | |||||||||||||||||||||||||||||
| 502 | =head2 components | ||||||||||||||||||||||||||||
| 503 | |||||||||||||||||||||||||||||
| 504 | Title : components | ||||||||||||||||||||||||||||
| 505 | Usage : @array= $a->components([$components]) | ||||||||||||||||||||||||||||
| 506 | Function: get/set stored list of parsed raw feature types | ||||||||||||||||||||||||||||
| 507 | Returns : an array in list context, an array ref in scalar context | ||||||||||||||||||||||||||||
| 508 | Args : new arrayref of feature types | ||||||||||||||||||||||||||||
| 509 | Status : Internal | ||||||||||||||||||||||||||||
| 510 | |||||||||||||||||||||||||||||
| 511 | This method is used internally to remember the parsed list of raw | ||||||||||||||||||||||||||||
| 512 | features that we will aggregate. The need for this subroutine is | ||||||||||||||||||||||||||||
| 513 | seen when a user requests a composite feature of type | ||||||||||||||||||||||||||||
| 514 | "clone:cosmid". This generates a list of components in which the | ||||||||||||||||||||||||||||
| 515 | source is appended to the method, like "clone_left_end:cosmid" and | ||||||||||||||||||||||||||||
| 516 | "clone_right_end:cosmid". components() stores this information for | ||||||||||||||||||||||||||||
| 517 | later use. | ||||||||||||||||||||||||||||
| 518 | |||||||||||||||||||||||||||||
| 519 | =cut | ||||||||||||||||||||||||||||
| 520 | |||||||||||||||||||||||||||||
| 521 | 772 | ▶ | sub components { | ||||||||||||||||||||||||||
|
Subroutine
components: called CC=4 SCAR=13.9
Pod
documented
| |||||||||||||||||||||||||||||
| 522 | 772 | my $self = shift; | |||||||||||||||||||||||||||
| 523 | 772 | my $d = $self->{components}; | |||||||||||||||||||||||||||
| 524 | 772 | ▶ | $self->{components} = shift if @_; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 525 | 772 | ▶ | return unless ref $d; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 526 | 752 | ▶ | return wantarray ? @$d : $d; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 527 | } | ||||||||||||||||||||||||||||
| 528 | |||||||||||||||||||||||||||||
| 529 | 218 | ▶ | sub component_count { | ||||||||||||||||||||||||||
|
Subroutine
component_count: called CC=1 SCAR=0.0
Pod
undocumented
| |||||||||||||||||||||||||||||
| 530 | 218 | my @c = shift->components; | |||||||||||||||||||||||||||
| 531 | 218 | scalar @c; | |||||||||||||||||||||||||||
| 532 | } | ||||||||||||||||||||||||||||
| 533 | |||||||||||||||||||||||||||||
| 534 | 386 | ▶ | sub passthru { | ||||||||||||||||||||||||||
|
Subroutine
passthru: called CC=4 SCAR=13.9
Pod
undocumented
| |||||||||||||||||||||||||||||
| 535 | 386 | my $self = shift; | |||||||||||||||||||||||||||
| 536 | 386 | my $d = $self->{passthru}; | |||||||||||||||||||||||||||
| 537 | 386 | ▶ | $self->{passthru} = shift if @_; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 538 | 386 | ▶ | return unless ref $d; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 539 | 96 | ▶ | return wantarray ? @$d : $d; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 540 | } | ||||||||||||||||||||||||||||
| 541 | |||||||||||||||||||||||||||||
| 542 | 15 | ▶ | sub clone { | ||||||||||||||||||||||||||
|
Subroutine
clone: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 543 | 15 | my $self = shift; | |||||||||||||||||||||||||||
| 544 | 15 | my %new = %{$self}; | |||||||||||||||||||||||||||
| 545 | 15 | return bless \%new,ref($self); | |||||||||||||||||||||||||||
| 546 | } | ||||||||||||||||||||||||||||
| 547 | |||||||||||||||||||||||||||||
| 548 | =head2 get_part_names | ||||||||||||||||||||||||||||
| 549 | |||||||||||||||||||||||||||||
| 550 | Title : get_part_names | ||||||||||||||||||||||||||||
| 551 | Usage : @array = $a->get_part_names | ||||||||||||||||||||||||||||
| 552 | Function: get list of sub-parts for this type of feature | ||||||||||||||||||||||||||||
| 553 | Returns : an array | ||||||||||||||||||||||||||||
| 554 | Args : none | ||||||||||||||||||||||||||||
| 555 | Status : Internal | ||||||||||||||||||||||||||||
| 556 | |||||||||||||||||||||||||||||
| 557 | This method is used internally to fetch the list of feature types that | ||||||||||||||||||||||||||||
| 558 | form the components of the composite feature. Type names in the | ||||||||||||||||||||||||||||
| 559 | format "method:source" are recognized, as are "method" and | ||||||||||||||||||||||||||||
| 560 | Bio::DB::GFF::Typename objects as well. It checks instance variables | ||||||||||||||||||||||||||||
| 561 | first, and if not defined calls the part_names() method. | ||||||||||||||||||||||||||||
| 562 | |||||||||||||||||||||||||||||
| 563 | =cut | ||||||||||||||||||||||||||||
| 564 | |||||||||||||||||||||||||||||
| 565 | 218 | ▶ | sub get_part_names { | ||||||||||||||||||||||||||
|
Subroutine
get_part_names: called CC=3 SCAR=11.0
Pod
documented
| |||||||||||||||||||||||||||||
| 566 | 218 | my $self = shift; | |||||||||||||||||||||||||||
| 567 | 218 | ▶ | if ($self->{sub_parts}) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 568 | 46 | ▶ | return ref $self->{sub_parts} ? @{$self->{sub_parts}} : $self->{sub_parts}; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 569 | } else { | ||||||||||||||||||||||||||||
| 570 | 172 | return $self->part_names; | |||||||||||||||||||||||||||
| 571 | } | ||||||||||||||||||||||||||||
| 572 | } | ||||||||||||||||||||||||||||
| 573 | |||||||||||||||||||||||||||||
| 574 | =head2 get_main_name | ||||||||||||||||||||||||||||
| 575 | |||||||||||||||||||||||||||||
| 576 | Title : get_main_name | ||||||||||||||||||||||||||||
| 577 | Usage : $string = $a->get_main_name | ||||||||||||||||||||||||||||
| 578 | Function: get the "main" method type for this feature | ||||||||||||||||||||||||||||
| 579 | Returns : a string | ||||||||||||||||||||||||||||
| 580 | Args : none | ||||||||||||||||||||||||||||
| 581 | Status : Internal | ||||||||||||||||||||||||||||
| 582 | |||||||||||||||||||||||||||||
| 583 | This method is used internally to fetch the type of the "main part" of | ||||||||||||||||||||||||||||
| 584 | the feature. It checks instance variables first, and if not defined | ||||||||||||||||||||||||||||
| 585 | calls the main_name() method. | ||||||||||||||||||||||||||||
| 586 | |||||||||||||||||||||||||||||
| 587 | =cut | ||||||||||||||||||||||||||||
| 588 | |||||||||||||||||||||||||||||
| 589 | 386 | ▶ | sub get_main_name { | ||||||||||||||||||||||||||
|
Subroutine
get_main_name: called CC=2 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||
| 590 | 386 | my $self = shift; | |||||||||||||||||||||||||||
| 591 | 386 | ▶ | return $self->{main_method} if defined $self->{main_method}; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 592 | 309 | return $self->main_name; | |||||||||||||||||||||||||||
| 593 | } | ||||||||||||||||||||||||||||
| 594 | |||||||||||||||||||||||||||||
| 595 | =head2 get_method | ||||||||||||||||||||||||||||
| 596 | |||||||||||||||||||||||||||||
| 597 | Title : get_method | ||||||||||||||||||||||||||||
| 598 | Usage : $string = $a->get_method | ||||||||||||||||||||||||||||
| 599 | Function: get the method type for the composite feature | ||||||||||||||||||||||||||||
| 600 | Returns : a string | ||||||||||||||||||||||||||||
| 601 | Args : none | ||||||||||||||||||||||||||||
| 602 | Status : Internal | ||||||||||||||||||||||||||||
| 603 | |||||||||||||||||||||||||||||
| 604 | This method is used internally to fetch the type of the method that | ||||||||||||||||||||||||||||
| 605 | will be assigned to the composite feature once it is synthesized. | ||||||||||||||||||||||||||||
| 606 | |||||||||||||||||||||||||||||
| 607 | =cut | ||||||||||||||||||||||||||||
| 608 | |||||||||||||||||||||||||||||
| 609 | 458 | ▶ | sub get_method { | ||||||||||||||||||||||||||
|
Subroutine
get_method: called CC=2 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||
| 610 | 458 | my $self = shift; | |||||||||||||||||||||||||||
| 611 | 458 | ▶ | return $self->{method} if defined $self->{method}; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 612 | 302 | return $self->method; | |||||||||||||||||||||||||||
| 613 | } | ||||||||||||||||||||||||||||
| 614 | |||||||||||||||||||||||||||||
| 615 | 34 | 1; | |||||||||||||||||||||||||||
| 616 | |||||||||||||||||||||||||||||
| 617 | =head1 BUGS | ||||||||||||||||||||||||||||
| 618 | |||||||||||||||||||||||||||||
| 619 | None known yet. | ||||||||||||||||||||||||||||
| 620 | |||||||||||||||||||||||||||||
| 621 | =head1 SEE ALSO | ||||||||||||||||||||||||||||
| 622 | |||||||||||||||||||||||||||||
| 623 | L<Bio::DB::GFF>, | ||||||||||||||||||||||||||||
| 624 | L<Bio::DB::GFF::Aggregator::alignment>, | ||||||||||||||||||||||||||||
| 625 | L<Bio::DB::GFF::Aggregator::clone>, | ||||||||||||||||||||||||||||
| 626 | L<Bio::DB::GFF::Aggregator::coding>, | ||||||||||||||||||||||||||||
| 627 | L<Bio::DB::GFF::Aggregator::match>, | ||||||||||||||||||||||||||||
| 628 | L<Bio::DB::GFF::Aggregator::processed_transcript>, | ||||||||||||||||||||||||||||
| 629 | L<Bio::DB::GFF::Aggregator::transcript>, | ||||||||||||||||||||||||||||
| 630 | L<Bio::DB::GFF::Aggregator::none> | ||||||||||||||||||||||||||||
| 631 | |||||||||||||||||||||||||||||
| 632 | =head1 AUTHOR | ||||||||||||||||||||||||||||
| 633 | |||||||||||||||||||||||||||||
| 634 | Lincoln Stein E<lt>lstein@cshl.orgE<gt>. | ||||||||||||||||||||||||||||
| 635 | |||||||||||||||||||||||||||||
| 636 | Copyright (c) 2001 Cold Spring Harbor Laboratory. | ||||||||||||||||||||||||||||
| 637 | |||||||||||||||||||||||||||||
| 638 | This library is free software; you can redistribute it and/or modify | ||||||||||||||||||||||||||||
| 639 | it under the same terms as Perl itself. | ||||||||||||||||||||||||||||
| 640 | |||||||||||||||||||||||||||||
| 641 | =cut | ||||||||||||||||||||||||||||
| 642 | |||||||||||||||||||||||||||||