annotate variant_effect_predictor/Bio/EnsEMBL/DBEntry.pm @ 0:2bc9b66ada89 draft default tip

Uploaded
author mahtabm
date Thu, 11 Apr 2013 06:29:17 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
1 =head1 LICENSE
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
2
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
3 Copyright (c) 1999-2012 The European Bioinformatics Institute and
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
4 Genome Research Limited. All rights reserved.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
5
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
6 This software is distributed under a modified Apache license.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
7 For license details, please see
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
8
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
9 http://www.ensembl.org/info/about/code_licence.html
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
10
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
11 =head1 CONTACT
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
12
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
13 Please email comments or questions to the public Ensembl
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
14 developers list at <dev@ensembl.org>.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
15
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
16 Questions may also be sent to the Ensembl help desk at
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
17 <helpdesk@ensembl.org>.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
18
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
19 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
20
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
21 =head1 NAME
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
22
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
23 Bio::EnsEMBL::DBEntry -
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
24 Object representing an external reference (xref)
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
25
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
26 =head1 DESCRIPTION
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
27
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
28 This object holds information about external references (xrefs) to
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
29 Ensembl objects.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
30
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
31 =head1 METHODS
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
32
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
33 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
34
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
35 package Bio::EnsEMBL::DBEntry;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
36
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
37 use strict;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
38 use warnings;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
39 no warnings qw(uninitialized);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
40
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
41 use Bio::EnsEMBL::Storable;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
42 use Bio::Annotation::DBLink;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
43
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
44 use Bio::EnsEMBL::Utils::Argument qw(rearrange);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
45 use Bio::EnsEMBL::Utils::Exception qw(deprecate);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
46 use Scalar::Util qw(weaken isweak);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
47
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
48 our @ISA = qw(Bio::EnsEMBL::Storable Bio::Annotation::DBLink);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
49
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
50
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
51 =head2 new_fast
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
52
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
53 Arg [1] : Hashref $hashref - hash reference to bless as new DBEntry object
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
54 Description: A very quick constructor that requires internal knowledge of
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
55 the class. This is used in speed critical sections of the code
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
56 where many objects need to be created quickly.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
57 Returntype : Bio::EnsEMBL::DBEntry
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
58 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
59 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
60 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
61
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
62 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
63
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
64 sub new_fast {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
65 my $class = shift;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
66 my $hashref = shift;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
67 my $self = bless $hashref, $class;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
68 weaken($self->{adaptor}) if ( ! isweak($self->{adaptor}) );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
69 return $self;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
70 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
71
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
72
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
73 =head2 new
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
74
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
75 Args [...] : list of named parameters
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
76 Example : my $dbentry = new Bio::EnsEMBL::DBEntry(
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
77 -adaptor => $adaptor,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
78 -primary_id => $pid,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
79 -version => $version,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
80 -dbname => $dbname,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
81 -release => $release,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
82 -display_id => $did,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
83 -description => $description,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
84 -priority => $priority,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
85 -db_display_name => $db_display_name,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
86 -info_type => $info_type,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
87 -info_text => $info_text,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
88 -type => $type,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
89 -secondary_db_name => $secondary_db_name,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
90 -secondary_db_table => $secondary_db_table
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
91 -linkage_annotation => $object_xref_text);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
92 Description: Creates a new DBEntry object
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
93 Returntype : Bio::EnsEMBL::DBEntry
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
94 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
95 Caller : Bio::EnsEMBL::DBEntryAdaptor
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
96 Status : At Risk
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
97 Due to 'PRIORITY',
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
98 'INFO_TYPE', 'INFO_TEXT', ''DB_DISPLAY_NAME', 'TYPE',
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
99 'SECONDARY_DB_NAME', 'SECONDARY_DB_TABLE'
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
100 being under development - if you don't use any of these the
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
101 method can be considered Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
102
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
103 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
104
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
105 sub new {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
106 my ($class, @args) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
107
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
108 my $self = bless {},$class;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
109
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
110 my ( $adaptor, $dbID, $primary_id, $version,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
111 $dbname, $release, $display_id, $description,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
112 $priority,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
113 $db_display_name, $info_type, $info_text, $type,
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
114 $secondary_db_name, $secondary_db_table, $link_annotation, $analysis) =
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
115 rearrange ( ['ADAPTOR','DBID','PRIMARY_ID','VERSION',
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
116 'DBNAME','RELEASE','DISPLAY_ID','DESCRIPTION',
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
117 'PRIORITY',
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
118 'DB_DISPLAY_NAME', 'INFO_TYPE', 'INFO_TEXT', 'TYPE',
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
119 'SECONDARY_DB_NAME', 'SECONDARY_DB_TABLE', 'LINKAGE_ANNOTATION', 'ANALYSIS'], @args );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
120
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
121 $self->adaptor($adaptor);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
122 $self->{'dbID'} = $dbID;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
123
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
124 if( defined $primary_id ) { $self->primary_id( $primary_id ) }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
125 if( defined $version ) { $self->version( $version ) } else
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
126 { $self->version( 0 ); }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
127 if( defined $dbname ) { $self->dbname( $dbname ) }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
128 if( defined $release) { $self->release( $release ) }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
129 if( defined $display_id) { $self->display_id( $display_id ) }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
130 if( defined $description) { $self->description($description) }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
131 if( defined $priority) { $self->priority($priority) }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
132 if( defined $db_display_name) { $self->db_display_name($db_display_name) }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
133 if( defined $info_type) { $self->info_type($info_type) }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
134 if( defined $info_text) { $self->info_text($info_text) }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
135 if( defined $type) { $self->type($type) }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
136 if( defined $secondary_db_name) { $self->secondary_db_name($secondary_db_name) }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
137 if( defined $secondary_db_table) { $self->secondary_db_table($secondary_db_table) }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
138
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
139 $self->linkage_annotation($link_annotation) if defined $link_annotation;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
140 $self->analysis($analysis) if defined $analysis;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
141
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
142
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
143 return $self;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
144 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
145
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
146
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
147 =head2 primary_id
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
148
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
149 Arg [1] : (optional) String $arg - value to set
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
150 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
151 Description: Getter/setter for attribute 'primary_id'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
152 This is the object's primary id in the external database.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
153 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
154 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
155 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
156 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
157
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
158 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
159
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
160 sub primary_id {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
161 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
162 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
163 $self->{primary_id} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
164 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
165 return $self->{primary_id};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
166 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
167
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
168
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
169 =head2 display_id
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
170
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
171 Arg [1] : (optional) String $arg - value to set
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
172 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
173 Description: Getter/setter for attribute 'display_id'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
174 The object's preferred display name. This can be the same
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
175 as primary_id or ensembl-specific.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
176 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
177 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
178 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
179 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
180
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
181 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
182
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
183 sub display_id{
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
184 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
185 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
186 $self->{display_id} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
187 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
188 return $self->{display_id};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
189 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
190
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
191
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
192 =head2 optional_id
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
193
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
194 Args : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
195 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
196 Description: Additional getter for attribute 'display_id'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
197 The object's preferred display name.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
198 Only include for BioPerl interface compliance, please use
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
199 $self->display_id().
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
200 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
201 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
202 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
203 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
204
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
205 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
206
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
207 sub optional_id {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
208 my $self = shift;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
209 return $self->display_id;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
210 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
211
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
212
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
213 =head2 dbname
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
214
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
215 Arg [1] : (optional) String $arg - value to set
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
216 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
217 Description: Getter/setter for attribute 'dbname'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
218 The name of the external database.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
219 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
220 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
221 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
222 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
223
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
224 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
225
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
226 sub dbname {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
227 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
228 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
229 $self->{dbname} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
230 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
231 return $self->{dbname};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
232 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
233
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
234
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
235 =head2 database
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
236
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
237 Args : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
238 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
239 Description: Additional getter for attribute 'dbname'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
240 The name of the external database.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
241 Only include for BioPerl interface compliance, please use
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
242 $self->dbname().
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
243 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
244 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
245 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
246 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
247
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
248 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
249
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
250 sub database {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
251 my $self = shift;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
252 return $self->dbname();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
253 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
254
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
255
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
256 =head2 release
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
257
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
258 Arg [1] : (optional) String $arg - value to set
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
259 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
260 Description: Getter/setter for attribute 'release'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
261 The external database release name.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
262 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
263 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
264 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
265 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
266
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
267 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
268
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
269 sub release {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
270 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
271 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
272 $self->{release} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
273 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
274 return $self->{release};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
275 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
276
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
277
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
278 =head2 version
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
279
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
280 Arg [1] : (optional) String $arg - value to set
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
281 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
282 Description: Getter/setter for attribute 'version'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
283 The object's version in the external database.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
284 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
285 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
286 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
287 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
288
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
289 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
290
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
291 sub version {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
292 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
293 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
294 $self->{version} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
295 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
296 return $self->{version};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
297 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
298
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
299
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
300 =head2 description
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
301
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
302 Arg [1] : (optional) String $arg - value to set
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
303 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
304 Description: Getter/setter for attribute 'description'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
305 The object's description, from the xref table
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
306 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
307 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
308 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
309 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
310
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
311 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
312
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
313 sub description {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
314 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
315
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
316 if ( defined($arg) ) { $self->{'description'} = $arg }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
317
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
318 return $self->{description};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
319 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
320
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
321 =head2 analysis
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
322
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
323 Arg [1] : Bio::EnsEMBL::Analysis $analysis
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
324 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
325 Description: get/set for attribute analysis
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
326 Returntype : Bio::EnsEMBL::Analysis
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
327 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
328 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
329 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
330
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
331 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
332
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
333 sub analysis {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
334 my $self = shift;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
335 $self->{analysis} = shift if( @_ );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
336 return $self->{analysis};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
337 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
338
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
339 =head2 comment
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
340
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
341 Args : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
342 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
343 Description: Additional getter for attribute 'description'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
344 The object's description.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
345 Only include for BioPerl interface compliance, please use
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
346 $self->description().
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
347 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
348 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
349 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
350 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
351
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
352 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
353
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
354 sub comment {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
355 my $self = shift;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
356 return $self->description();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
357 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
358
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
359
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
360 =head2 priority
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
361
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
362 Arg [1] : int $priority
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
363 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
364 Priority : Getter/setter for attribute 'priority'. Note this
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
365 is the priority from the external_db table.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
366 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
367 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
368 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
369 Status : At Risk
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
370 : due to it being under development
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
371
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
372 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
373
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
374 sub priority {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
375 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
376 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
377 $self->{priority} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
378 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
379 return $self->{priority};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
380 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
381
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
382
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
383 =head2 db_display_name
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
384
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
385 Arg [1] : String $db_display_name
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
386 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
387 Description: Getter/setter for attribute 'db_display_name'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
388 The preferred display name for the external database. Has
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
389 "Projected " prepended if info_type='PROJECTION'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
390 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
391 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
392 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
393
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
394 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
395
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
396 sub db_display_name {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
397 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
398 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
399 $self->{db_display_name} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
400 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
401
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
402 my $name;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
403 if ($self->{info_type} && $self->{info_type} eq "PROJECTION") {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
404 $name = "Projected " . $self->{db_display_name};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
405 } else {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
406 $name = $self->{db_display_name};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
407 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
408
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
409 return $name;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
410 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
411
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
412
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
413 =head2 info_type
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
414
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
415 Arg [1] : String $info_type
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
416 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
417 Description: Getter/setter for attribute 'info_type'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
418 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
419 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
420 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
421
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
422 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
423
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
424 sub info_type {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
425 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
426 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
427 $self->{info_type} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
428 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
429 return $self->{info_type};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
430 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
431
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
432
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
433 =head2 info_text
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
434
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
435 Arg [1] : String $info_text
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
436 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
437 Description: Getter/setter for attribute 'info_text'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
438 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
439 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
440 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
441
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
442 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
443
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
444 sub info_text {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
445 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
446 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
447 $self->{info_text} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
448 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
449 return $self->{info_text};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
450 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
451
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
452 =head2 linkage_annotation
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
453
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
454 Arg [1] : String $object_xref_text
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
455 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
456 Description: Getter/setter for attribute 'linkage_annotation'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
457 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
458 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
459 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
460
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
461 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
462
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
463 sub linkage_annotation {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
464 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
465
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
466 $self->{linkage_annotation} = $arg if defined $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
467
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
468 return $self->{linkage_annotation};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
469 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
470
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
471
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
472 =head2 type
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
473
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
474 Arg [1] : String $type
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
475 Example : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
476 Description: Getter/setter for attribute 'type'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
477 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
478 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
479 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
480
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
481 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
482
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
483 sub type {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
484 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
485 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
486 $self->{type} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
487 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
488 return $self->{type};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
489 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
490
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
491 =head2 secondary_db_name
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
492
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
493 Arg [1] : String $secondary_db_name
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
494 Description: Getter/setter for attribute 'secondary_db_name'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
495 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
496 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
497 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
498
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
499 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
500
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
501 sub secondary_db_name {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
502 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
503 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
504 $self->{secondary_db_name} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
505 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
506 return $self->{secondary_db_name};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
507 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
508
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
509
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
510 =head2 secondary_db_table
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
511
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
512 Arg [1] : String $secondary_db_table
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
513 Description: Getter/setter for attribute 'secondary_db_table'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
514 Returns : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
515 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
516 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
517
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
518 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
519
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
520 sub secondary_db_table {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
521 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
522 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
523 $self->{secondary_db_table} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
524 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
525 return $self->{secondary_db_table};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
526 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
527
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
528
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
529 =head2 add_synonym
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
530
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
531 Arg [1] : String $arg - synonym to add
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
532 Description: Add a synonym for the external object.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
533 Returntype : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
534 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
535 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
536 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
537
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
538 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
539
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
540
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
541 sub add_synonym {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
542 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
543 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
544 push( @{$self->{synonyms}}, $arg );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
545 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
546 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
547
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
548
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
549 =head2 get_all_synonyms
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
550
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
551 Args : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
552 Example : my @synonyms = @{ $db_entry->get_all_synonyms };
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
553 Description: Get a list of synonyms known for this object.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
554 Synonyms are lazy-loaded if required.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
555 Returntype : listref of strings. May be empty.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
556 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
557 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
558 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
559
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
560 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
561
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
562 sub get_all_synonyms {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
563
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
564 my $self = shift;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
565
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
566 # lazy-load synonyms if required
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
567 if (!$self->{synonyms} && $self->adaptor()) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
568 $self->{synonyms} = $self->adaptor()->fetch_all_synonyms($self->dbID());
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
569 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
570
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
571 return $self->{synonyms};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
572 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
573
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
574
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
575 =head2 get_all_dependents
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
576
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
577 Args[1] : (optional) Bio::EnsEMBL::Gene, Transcript or Translation object
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
578 Example : my @dependents = @{ $db_entry->get_all_dependents };
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
579 Description: Get a list of DBEntrys that are depenednet on the DBEntry.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
580 if an ensembl gene transcript or translation is given then only
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
581 the ones on that object will be given
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
582 Returntype : listref of DBEntrys. May be empty.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
583 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
584 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
585 Status : UnStable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
586
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
587 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
588
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
589 sub get_all_dependents {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
590 my $self = shift;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
591 my $ensembl_object = shift;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
592
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
593 return $self->adaptor()->get_all_dependents($self->dbID(), $ensembl_object);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
594 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
595
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
596 =head2 get_all_masters
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
597
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
598 Args[1] : (optional) Bio::EnsEMBL::Gene, Transcript or Translation object
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
599 Example : my @masters = @{ $db_entry->get_all_masters };
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
600 Description: Get a list of DBEntrys that are the masters of the DBEntry.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
601 if an ensembl gene transcript or translation is given then only
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
602 the ones on that object will be given.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
603 Returntype : listref of DBEntrys. May be empty.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
604 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
605 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
606 Status : UnStable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
607
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
608 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
609
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
610 sub get_all_masters {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
611 my $self = shift;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
612 my $ensembl_object = shift;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
613
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
614 return $self->adaptor()->get_all_masters($self->dbID(), $ensembl_object);
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
615 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
616
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
617
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
618 =head2 flush_synonyms
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
619
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
620 Args : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
621 Description: Remove all synonyms from this object.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
622 Returntype : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
623 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
624 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
625 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
626
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
627 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
628
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
629 sub flush_synonyms {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
630 my $self = shift;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
631 $self->{synonyms} = [];
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
632 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
633
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
634
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
635 =head2 status
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
636
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
637 Arg [1] : (optional) String $arg - value to set
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
638 Description: Getter/setter for attribute 'status'.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
639 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
640 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
641 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
642 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
643
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
644 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
645
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
646
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
647 sub status{
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
648 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
649 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
650 $self->{status} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
651 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
652 return $self->{status};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
653 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
654
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
655 =head2 ensembl_object_type
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
656
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
657 Arg [1] : (optional) String $arg - value to set
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
658 Description: Getter/setter for attribute ensembl_object_type.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
659 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
660 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
661 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
662 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
663
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
664 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
665
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
666
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
667 sub ensembl_object_type{
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
668 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
669 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
670 $self->{ensembl_object_type} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
671 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
672 return $self->{ensembl_object_type};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
673 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
674
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
675 =head2 ensembl_id
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
676
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
677 Arg [1] : (optional) String $arg - value to set
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
678 Description: Getter/setter for attribute ensembl_id.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
679 Returntype : String
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
680 Exceptions : none
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
681 Caller : general
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
682 Status : Stable
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
683
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
684 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
685
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
686
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
687 sub ensembl_id{
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
688 my ( $self, $arg ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
689 if( defined $arg ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
690 $self->{ensembl_id} = $arg;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
691 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
692 return $self->{ensembl_id};
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
693 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
694
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
695
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
696
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
697 =head1 DEPRECATED METHODS
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
698
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
699 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
700
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
701 =head2 get_synonyms
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
702
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
703 DEPRECATED use get_all_synonyms instead
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
704
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
705 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
706
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
707 sub get_synonyms {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
708 my $self = shift;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
709
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
710 deprecate("get_synonyms has been renamed get_all_synonyms.");
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
711 return $self->get_all_synonyms;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
712 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
713
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
714 1;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
715