annotate variant_effect_predictor/Bio/EnsEMBL/Compara/MemberDomain.pm @ 0:21066c0abaf5 draft

Uploaded
author willmclaren
date Fri, 03 Aug 2012 10:04:48 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
1 =head1 LICENSE
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
2
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
3 Copyright (c) 1999-2012 The European Bioinformatics Institute and
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
4 Genome Research Limited. All rights reserved.
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
5
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
6 This software is distributed under a modified Apache license.
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
7 For license details, please see
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
8
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
9 http://www.ensembl.org/info/about/code_licence.html
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
10
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
11 =head1 CONTACT
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
12
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
13 Please email comments or questions to the public Ensembl
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
14 developers list at <dev@ensembl.org>.
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
15
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
16 Questions may also be sent to the Ensembl help desk at
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
17 <helpdesk@ensembl.org>.
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
18
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
19 =head1 AUTHORSHIP
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
20
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
21 Ensembl Team. Individual contributions can be found in the CVS log.
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
22
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
23 =cut
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
24
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
25 =head1 NAME
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
26
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
27 MemberDomain - DESCRIPTION of Object
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
28
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
29 =head1 DESCRIPTION
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
30
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
31 A subclass of Member which extends it to store a domain (start / end)
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
32 within the sequence
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
33
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
34 =head1 INHERITANCE TREE
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
35
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
36 Bio::EnsEMBL::Compara::MemberDomain
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
37 +- Bio::EnsEMBL::Compara::Member
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
38
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
39 =head1 METHODS
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
40
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
41 =cut
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
42
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
43 package Bio::EnsEMBL::Compara::MemberDomain;
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
44
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
45 use strict;
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
46 use Bio::EnsEMBL::Utils::Exception;
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
47 use Bio::EnsEMBL::Compara::Member;
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
48
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
49 use base ('Bio::EnsEMBL::Compara::Member');
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
50
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
51
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
52 ##################################
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
53 # overriden superclass methods
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
54 ##################################
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
55
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
56 =head2 copy
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
57
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
58 Arg [1] : none
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
59 Example : $copy = $aligned_member->copy();
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
60 Description : Creates a new MemberDomain object from an existing one
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
61 Returntype : Bio::EnsEMBL::Compara::MemberDomain
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
62 Exceptions : none
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
63 Caller : general
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
64 Status : Stable
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
65
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
66 =cut
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
67
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
68 sub copy {
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
69 my $self = shift;
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
70
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
71 my $mycopy = @_ ? shift : {}; # extending or from scratch?
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
72 $self->SUPER::copy($mycopy);
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
73 bless $mycopy, 'Bio::EnsEMBL::Compara::MemberDomain';
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
74
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
75 # The following does not Work if the initial object is only a Member
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
76 if (UNIVERSAL::isa($self, 'Bio::EnsEMBL::Compara::MemberDomain')) {
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
77 $mycopy->member_start($self->member_start);
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
78 $mycopy->member_end($self->member_end);
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
79 }
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
80
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
81 return $mycopy;
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
82 }
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
83
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
84
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
85 =head2 member_start
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
86
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
87 Arg [1] : (optional) $member_start
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
88 Example : $object->member_start($member_start);
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
89 Example : $member_start = $object->member_start();
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
90 Description : Getter/setter for the member_start attribute. For non-global
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
91 alignments, this represent the starting point of the local
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
92 alignment.
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
93 Currently the data provided as MemberDomains (leaves of the
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
94 GeneTree) are obtained using global alignments and the
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
95 member_start is always undefined.
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
96 Returntype : integer
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
97 Exceptions : none
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
98 Caller : general
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
99 Status : Stable
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
100
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
101 =cut
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
102
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
103 sub member_start {
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
104 my $self = shift;
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
105 $self->{'_member_start'} = shift if(@_);
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
106 return $self->{'_member_start'};
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
107 }
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
108
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
109
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
110 =head2 member_end
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
111
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
112 Arg [1] : (optional) $member_end
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
113 Example : $object->member_end($member_end);
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
114 Example : $member_end = $object->member_end();
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
115 Description : Getter/setter for the member_end attribute. For non-global
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
116 alignments, this represent the ending point of the local
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
117 alignment.
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
118 Currently the data provided as MemberDomains (leaves of the
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
119 GeneTree) are obtained using global alignments and the
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
120 member_end is always undefined.
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
121 Returntype : integer
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
122 Exceptions : none
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
123 Caller : general
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
124 Status : Stable
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
125
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
126 =cut
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
127
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
128 sub member_end {
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
129 my $self = shift;
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
130 $self->{'_member_end'} = shift if(@_);
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
131 return $self->{'_member_end'};
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
132 }
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
133
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
134
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
135
21066c0abaf5 Uploaded
willmclaren
parents:
diff changeset
136 1;