annotate variant_effect_predictor/Bio/Tools/ECnumber.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 # $Id: ECnumber.pm,v 1.7 2002/12/12 18:27:02 czmasek Exp $
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
2 #
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
3 # BioPerl module for Bio::Tools::ECnumber
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
4 #
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
5 # Cared for by Christian M. Zmasek <czmasek@gnf.org> or <cmzmasek@yahoo.com>
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
6 #
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
7 # (c) Christian M. Zmasek, czmasek@gnf.org, 2002.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
8 # (c) GNF, Genomics Institute of the Novartis Research Foundation, 2002.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
9 #
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
10 # You may distribute this module under the same terms as perl itself.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
11 # Refer to the Perl Artistic License (see the license accompanying this
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
12 # software package, or see http://www.perl.com/language/misc/Artistic.html)
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
13 # for the terms under which you may use, modify, and redistribute this module.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
14 #
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
15 # THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
16 # WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
17 # MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
18 #
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
19
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
20 # POD documentation - main docs before the code
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
21
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
22
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
23 =head1 NAME
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
24
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
25 ECnumber - representation of EC numbers
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
26
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
27 =head1 SYNOPSIS
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
28
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
29 use Bio::Tools::ECnumber;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
30
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
31
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
32 # Creation of ECnumber objects
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
33 # ----------------------------
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
34
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
35 my $EC1 = Bio::Tools::ECnumber->new( -ec_string => "4.3.2.1" );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
36 my $EC2 = Bio::Tools::ECnumber->new( -ec_string => "EC 1.1.1.1" );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
37 my $EC3 = Bio::Tools::ECnumber->new();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
38
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
39
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
40 # Copying
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
41 # -------
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
42
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
43 my $EC4 = $EC1->copy();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
44
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
45
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
46 # Modification of ECnumber objects
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
47 # --------------------------------
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
48
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
49 print $EC3->EC_string( "1.01.01.001" ); # Prints "1.1.1.1".
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
50
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
51
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
52 # To string
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
53 # ---------
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
54
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
55 print $EC3->EC_string();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
56
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
57 # or:
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
58
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
59 print $EC3->to_string();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
60
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
61
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
62
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
63 # Test for equality
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
64 # -----------------
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
65
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
66 # Against ECnumber object:
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
67 if ( $EC3->is_equal( $EC2 ) ) { # Prints "equal".
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
68 print "equal";
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
69 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
70
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
71 # Against string representation of EC number:
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
72 if ( ! $EC3->is_equal( "1.1.1.-" ) ) { # Prints "not equal".
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
73 print "not equal";
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
74 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
75
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
76
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
77 # Test for membership
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
78 # -------------------
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
79
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
80 my $EC5 = Bio::Tools::ECnumber->new( -ec_string => "4.3.2.-" );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
81
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
82 # Against ECnumber object.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
83 if ( $EC1->is_member( $EC5 ) ) { # Prints "member".
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
84 print "member";
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
85 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
86
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
87
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
88 # Against string representation of EC number.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
89 if ( ! $EC1->is_member( "4.3.1.-" ) ) { # Prints "not member".
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
90 print "not member";
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
91 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
92
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
93
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
94
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
95 =head1 DESCRIPTION
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
96
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
97 ECnumber is a representation of EC numbers [http://www.chem.qmul.ac.uk/iubmb/enzyme/].
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
98
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
99 =head1 FEEDBACK
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
100
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
101 =head2 Mailing Lists
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
102
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
103 User feedback is an integral part of the evolution of this and other
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
104 Bioperl modules. Send your comments and suggestions preferably to one
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
105 of the Bioperl mailing lists. Your participation is much appreciated.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
106
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
107 bioperl-l@bioperl.org - General discussion
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
108 http://bio.perl.org/MailList.html - About the mailing lists
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
109
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
110 =head2 Reporting Bugs
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
111
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
112 Report bugs to the Bioperl bug tracking system to help us keep track
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
113 the bugs and their resolution. Bug reports can be submitted via email
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
114 or the web:
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
115
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
116 bioperl-bugs@bio.perl.org
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
117 http://bugzilla.bioperl.org/
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
118
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
119 =head1 AUTHOR
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
120
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
121 Christian M. Zmasek
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
122
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
123 Email: czmasek@gnf.org or cmzmasek@yahoo.com
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
124
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
125 WWW: http://www.genetics.wustl.edu/eddy/people/zmasek/
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
126
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
127 Address:
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
128
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
129 Genomics Institute of the Novartis Research Foundation
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
130 10675 John Jay Hopkins Drive
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
131 San Diego, CA 92121
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
132
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
133 =head1 APPENDIX
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
134
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
135 The rest of the documentation details each of the object
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
136 methods. Internal methods are usually preceded with a _
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
137
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
138 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
139
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
140
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
141 # Let the code begin...
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
142
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
143 package Bio::Tools::ECnumber;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
144 use vars qw( @ISA );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
145 use strict;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
146 use Bio::Root::Object;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
147
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
148 use constant DEFAULT => "-";
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
149 use constant TRUE => 1;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
150 use constant FALSE => 0;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
151
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
152 @ISA = qw( Bio::Root::Root );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
153
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
154
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
155
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
156
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
157
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
158 =head2 new
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
159
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
160 Title : new
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
161 Usage : $EC1 = Bio::Tools::ECnumber->new( -ec_string => "4.3.2.1" );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
162 or
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
163 $EC2 = Bio::Tools::ECnumber->new( -ec_string => "4.3.2.2",
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
164 -comment => "Is EC 4.3.2.2" );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
165 or
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
166 $EC3 = Bio::Tools::ECnumber->new(); # EC3 is now "-.-.-.-"
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
167 Function: Creates a new ECnumber object.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
168 Parses a EC number from "x.x.x.x", "EC x.x.x.x",
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
169 "ECx.x.x.x", or "EC:x.x.x.x";
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
170 x being either a positive integer or a "-".
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
171 Returns : A new Ecnumber object.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
172 Args : A string representing a EC number, e.g. "4.3.2.1"
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
173 or "EC 4.3.2.1" or "1.-.-.-".
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
174
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
175 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
176
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
177 sub new {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
178 my( $class, @args ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
179
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
180 my $self = $class->SUPER::new( @args );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
181
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
182 my ( $EC_string, $comment )
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
183 = $self->_rearrange( [ qw( EC_STRING COMMENT ) ], @args );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
184
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
185 $self->init();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
186
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
187 $EC_string && $self->EC_string( $EC_string );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
188 $comment && $self->comment( $comment );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
189
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
190 return $self;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
191
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
192 } # new
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
193
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
194
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
195
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
196 =head2 init
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
197
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
198 Title : init()
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
199 Usage : $EC1->init(); # EC1 is now "-.-.-.-"
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
200 Function: Initializes this ECnumber to default values.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
201 Returns :
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
202 Args :
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
203
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
204 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
205
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
206 sub init {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
207 my( $self ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
208
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
209 $self->enzyme_class( DEFAULT );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
210 $self->sub_class( DEFAULT );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
211 $self->sub_sub_class( DEFAULT );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
212 $self->serial_number( DEFAULT );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
213 $self->comment( "" );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
214
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
215 } # init
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
216
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
217
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
218
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
219 =head2 copy
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
220
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
221 Title : copy()
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
222 Usage : $EC2 = $EC1->copy();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
223 Function: Creates a new ECnumber object which is an exact copy
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
224 of this ECnumber.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
225 Returns : A copy of this ECnumber.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
226 Args :
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
227
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
228 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
229
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
230 sub copy {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
231 my( $self ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
232
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
233 my $new_ec = $self->new();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
234 $new_ec->enzyme_class( $self->enzyme_class() );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
235 $new_ec->sub_class( $self->sub_class() );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
236 $new_ec->sub_sub_class( $self->sub_sub_class() );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
237 $new_ec->serial_number( $self->serial_number() );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
238 $new_ec->comment( $self->comment() );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
239 return $new_ec;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
240
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
241 } # copy
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
242
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
243
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
244
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
245 =head2 EC_string
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
246
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
247 Title : EC_string
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
248 Usage : $EC3->EC_string( "1.1.1.-" );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
249 or
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
250 print $EC3->EC_string();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
251 Function: Set/get for string representations of EC numbers.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
252 Parses a EC number from "x.x.x.x", "EC x.x.x.x",
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
253 "ECx.x.x.x", or "EC:x.x.x.x";
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
254 x being either a positive integer or a "-".
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
255 Returns : A string representations of a EC number.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
256 Args : A string representations of a EC number.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
257
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
258 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
259
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
260 sub EC_string {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
261 my ( $self, $value ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
262
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
263 if ( defined $value) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
264 $value =~ s/\s+//g; # Removes white space.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
265 $value =~ s/^EC//i; # Removes "EC".
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
266 $value =~ s/^://; # Removes ":".
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
267
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
268 if ( $value =~ /^([\d-]*)\.([\d-]*)\.([\d-]*)\.([\d-]*)$/ ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
269 $self->enzyme_class( $1 );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
270 $self->sub_class( $2 );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
271 $self->sub_sub_class( $3 );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
272 $self->serial_number( $4 );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
273 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
274 else {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
275 $self->throw( "Illegal format error [$value]" );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
276 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
277 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
278
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
279 return $self->to_string();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
280
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
281 } # EC_string
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
282
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
283
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
284
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
285 =head2 to_string
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
286
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
287 Title : to_string()
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
288 Usage : print $EC3->to_string();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
289 Function: To string method for EC numbers
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
290 (equals the "get" functionality of "EC_string").
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
291 Returns : A string representations of a EC number.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
292 Args :
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
293
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
294 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
295
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
296 sub to_string {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
297 my ( $self ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
298
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
299 my $s = $self->enzyme_class() . ".";
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
300 $s .= $self->sub_class() . ".";
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
301 $s .= $self->sub_sub_class() . ".";
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
302 $s .= $self->serial_number();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
303 return $s;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
304
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
305 } # to_string
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
306
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
307
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
308
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
309 =head2 is_equal
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
310
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
311 Title : is_equal
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
312 Usage : if ( $EC3->is_equal( $EC2 ) )
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
313 or
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
314 if ( $EC3->is_equal( "1.1.1.-" ) )
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
315 Function: Checks whether this ECnumber is equal to the argument
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
316 EC number (please note: "1.1.1.1" != "1.1.1.-").
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
317 Returns : True (1) or false (0).
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
318 Args : A ECnumber object or a string representation of a EC number.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
319
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
320 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
321
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
322 sub is_equal {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
323 my ( $self, $value ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
324
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
325 if ( $self->_is_not_reference( $value ) ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
326 $value = $self->new( -ec_string => $value );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
327 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
328 else {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
329 $self->_is_ECnumber_object( $value );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
330 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
331
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
332 unless ( $self->enzyme_class() eq $value->enzyme_class() ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
333 return FALSE;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
334 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
335 unless ( $self->sub_class() eq $value->sub_class() ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
336 return FALSE;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
337 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
338 unless ( $self->sub_sub_class() eq $value->sub_sub_class() ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
339 return FALSE;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
340 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
341 unless ( $self->serial_number() eq $value->serial_number() ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
342 return FALSE;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
343 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
344 return TRUE;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
345
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
346 } # is_equal
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
347
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
348
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
349
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
350 =head2 is_member
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
351
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
352 Title : is_member
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
353 Usage : if ( $EC1->is_member( $EC5 ) )
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
354 or
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
355 if ( $EC1->is_member( "4.3.-.-" ) )
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
356 Function: Checks whether this ECnumber is a member of the (incomplete)
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
357 argument EC number (e.g. "1.1.1.1" is a member of "1.1.1.-"
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
358 but not of "1.1.1.2").
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
359 Returns : True (1) or false (0).
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
360 Args : A ECnumber object or a string representation of a EC number.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
361
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
362 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
363
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
364 sub is_member {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
365 my ( $self, $value ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
366
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
367 if ( $self->_is_not_reference( $value ) ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
368 $value = $self->new( -ec_string => $value );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
369 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
370 else {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
371 $self->_is_ECnumber_object( $value );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
372 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
373 $self->_check_for_illegal_defaults();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
374 $value->_check_for_illegal_defaults();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
375
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
376 unless ( $value->enzyme_class() eq DEFAULT
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
377 || $self->enzyme_class() eq $value->enzyme_class() ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
378 return FALSE;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
379 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
380 unless ( $value->sub_class() eq DEFAULT
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
381 || $self->sub_class() eq $value->sub_class() ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
382 return FALSE;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
383 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
384 unless ( $value->sub_sub_class() eq DEFAULT
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
385 || $self->sub_sub_class() eq $value->sub_sub_class() ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
386 return FALSE;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
387 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
388 unless ( $value->serial_number() eq DEFAULT
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
389 || $self->serial_number() eq $value->serial_number() ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
390 return FALSE;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
391 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
392 return TRUE;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
393
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
394 } # is_member
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
395
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
396
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
397
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
398 =head2 enzyme_class
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
399
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
400 Title : enzyme_class
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
401 Usage : $EC1->enzyme_class( 1 );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
402 or
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
403 print $EC1->enzyme_class();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
404 Function: Set/get for the enzyme class number of ECnumbers.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
405 Returns : The enzyme class number of this ECnumber.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
406 Args : A positive integer or "-".
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
407
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
408 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
409
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
410 sub enzyme_class {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
411 my ( $self, $value ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
412
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
413 if ( defined $value) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
414 $self->{ "_enzyme_class" } = $self->_check_number( $value );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
415 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
416
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
417 return $self->{ "_enzyme_class" };
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
418
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
419 } # enzyme_class
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
420
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
421
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
422
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
423 =head2 sub_class
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
424
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
425 Title : sub_class
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
426 Usage : $EC1->sub_class( 4 );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
427 or
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
428 print $EC1->sub_class();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
429 Function: Set/get for the enzyme sub class number of ECnumbers.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
430 Returns : The enzyme sub class number of this ECnumber.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
431 Args : A positive integer or "-".
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
432
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
433 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
434
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
435 sub sub_class {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
436 my ( $self, $value ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
437
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
438 if ( defined $value) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
439 $self->{ "_sub_class" } = $self->_check_number( $value );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
440 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
441
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
442 return $self->{ "_sub_class" };
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
443
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
444 } # sub_class
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
445
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
446
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
447
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
448 =head2 sub_sub_class
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
449
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
450 Title : sub_sub_class
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
451 Usage : $EC1->sub_sub_class( 12 );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
452 or
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
453 print $EC1->sub_sub_class();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
454 Function: Set/get for the enzyme sub sub class number of ECnumbers.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
455 Returns : The enzyme sub sub class number of this ECnumber.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
456 Args : A positive integer or "-".
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
457
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
458 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
459
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
460 sub sub_sub_class {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
461 my ( $self, $value ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
462
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
463 if ( defined $value) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
464 $self->{ "_sub_sub_class" } = $self->_check_number( $value );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
465 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
466
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
467 return $self->{ "_sub_sub_class" };
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
468
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
469 } # sub_sub_class
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
470
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
471
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
472
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
473 =head2 serial_number
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
474
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
475 Title : serial_number
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
476 Usage : $EC1->serial_number( 482 );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
477 or
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
478 print $EC1->serial_number();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
479 Function: Set/get for the serial number of ECnumbers.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
480 Returns : The serial number of this ECnumber.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
481 Args : A positive integer or "-".
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
482
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
483 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
484
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
485 sub serial_number {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
486 my ( $self, $value ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
487
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
488 if ( defined $value) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
489 $self->{ "_serial_number" } = $self->_check_number( $value );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
490 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
491
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
492 return $self->{ "_serial_number" };
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
493
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
494 } # serial_number
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
495
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
496
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
497
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
498 =head2 comment
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
499
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
500 Title : comment
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
501 Usage : $EC1->comment( "deprecated" );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
502 or
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
503 print $EC1->comment();
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
504 Function: Set/get for a arbitrary comment.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
505 Returns : A comment [scalar].
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
506 Args : A comment [scalar].
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
507
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
508 =cut
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
509
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
510 sub comment {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
511 my ( $self, $value ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
512
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
513 if ( defined $value) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
514 $self->{ "_comment" } = $value;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
515 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
516
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
517 return $self->{ "_comment" };
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
518
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
519 } # comment
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
520
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
521
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
522
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
523 # Title : _check_number
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
524 # Function: Checks and standardizes the individual numbers of a EC number
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
525 # (removes leading zeros, removes white spaces).
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
526 # Returns : A standardized number.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
527 # Args : A string representing a number in a EC number.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
528 sub _check_number {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
529 my ( $self, $value ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
530
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
531 my $original_value = $value;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
532 $value =~ s/\s+//g; # Removes white space.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
533 if ( $value eq "" ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
534 $value = DEFAULT;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
535 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
536 $value =~ s/^0+//; # Removes leading zeros.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
537 if ( $value eq "" ) { # If it was "0" (or "00"), it would be "" now.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
538 $value = "0";
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
539 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
540 elsif ( $value ne DEFAULT
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
541 && $value =~ /\D/ ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
542 $self->throw( "Illegal format error [$original_value]" );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
543 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
544 return $value;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
545
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
546 } # _check_number
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
547
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
548
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
549
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
550 # Title : _check_for_illegal_defaults()
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
551 # Function: Checks for situations like "1.-.1.1", which
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
552 # are illegal in membership tests.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
553 # Returns :
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
554 # Args :
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
555 sub _check_for_illegal_defaults {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
556 my ( $self ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
557
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
558 if ( ( $self->sub_sub_class() eq DEFAULT
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
559 && $self->serial_number() ne DEFAULT ) ||
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
560 ( $self->sub_class() eq DEFAULT
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
561 && $self->sub_sub_class() ne DEFAULT ) ||
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
562 ( $self->enzyme_class() eq DEFAULT
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
563 && $self->sub_class() ne DEFAULT ) ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
564 $self->throw( "Illegal format error for comparison ["
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
565 . $self->to_string() . "]" );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
566 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
567
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
568 } # _check_for_illegal_defaults
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
569
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
570
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
571
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
572 # Title : _is_not_reference
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
573 # Function: Checks whether the argument is not a reference.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
574 # Returns : True or false.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
575 # Args : A scalar.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
576 sub _is_not_reference {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
577 my ( $self, $value ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
578
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
579 return ( ! ref( $value ) );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
580
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
581 } # _is_not_reference
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
582
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
583
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
584
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
585 # Title : _is_ECnumber_object
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
586 # Function: Checks whether the arument is a ECnumber.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
587 # Returns :
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
588 # Args : A reference.
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
589 sub _is_ECnumber_object {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
590 my ( $self, $value ) = @_;
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
591
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
592 unless( $value->isa( "Bio::Tools::ECnumber" ) ) {
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
593 $self->throw( "Found [". ref( $value )
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
594 ."] where [Bio::Tools::ECnumber] expected" );
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
595 }
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
596
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
597 } # _is_ECnumber_object
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
598
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
599
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
600
2bc9b66ada89 Uploaded
mahtabm
parents:
diff changeset
601 1;