e55ce18b3bbd6a14dcdcd364fb27251e2c820470
[jalview.git] / src / jalview / schemes / ResidueProperties.java
1 /*
2  * Jalview - A Sequence Alignment Editor and Viewer
3  * Copyright (C) 2007 AM Waterhouse, J Procter, G Barton, M Clamp, S Searle
4  *
5  * This program is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU General Public License
7  * as published by the Free Software Foundation; either version 2
8  * of the License, or (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program; if not, write to the Free Software
17  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
18  */
19 package jalview.schemes;
20
21 import java.util.*;
22
23 import java.awt.*;
24
25 public class ResidueProperties
26 {
27   public static Hashtable scoreMatrices = new Hashtable();
28   //Stores residue codes/names and colours and other things
29   public static final int[] aaIndex; // aaHash version 2.1.1 and below
30   public static final int[] nucleotideIndex;
31   public static final Hashtable aa3Hash = new Hashtable();
32   public static final Hashtable aa2Triplet = new Hashtable();
33   public static final Hashtable nucleotideName = new Hashtable();
34
35   static
36   {
37     aaIndex = new int[255];
38     for (int i = 0; i < 255; i++)
39     {
40       aaIndex[i] = 23;
41     }
42
43     aaIndex['A'] = 0;
44     aaIndex['R'] = 1;
45     aaIndex['N'] = 2;
46     aaIndex['D'] = 3;
47     aaIndex['C'] = 4;
48     aaIndex['Q'] = 5;
49     aaIndex['E'] = 6;
50     aaIndex['G'] = 7;
51     aaIndex['H'] = 8;
52     aaIndex['I'] = 9;
53     aaIndex['L'] = 10;
54     aaIndex['K'] = 11;
55     aaIndex['M'] = 12;
56     aaIndex['F'] = 13;
57     aaIndex['P'] = 14;
58     aaIndex['S'] = 15;
59     aaIndex['T'] = 16;
60     aaIndex['W'] = 17;
61     aaIndex['Y'] = 18;
62     aaIndex['V'] = 19;
63     aaIndex['B'] = 20;
64     aaIndex['Z'] = 21;
65     aaIndex['X'] = 22;
66     aaIndex['U'] = 22;
67     aaIndex['a'] = 0;
68     aaIndex['r'] = 1;
69     aaIndex['n'] = 2;
70     aaIndex['d'] = 3;
71     aaIndex['c'] = 4;
72     aaIndex['q'] = 5;
73     aaIndex['e'] = 6;
74     aaIndex['g'] = 7;
75     aaIndex['h'] = 8;
76     aaIndex['i'] = 9;
77     aaIndex['l'] = 10;
78     aaIndex['k'] = 11;
79     aaIndex['m'] = 12;
80     aaIndex['f'] = 13;
81     aaIndex['p'] = 14;
82     aaIndex['s'] = 15;
83     aaIndex['t'] = 16;
84     aaIndex['w'] = 17;
85     aaIndex['y'] = 18;
86     aaIndex['v'] = 19;
87     aaIndex['b'] = 20;
88     aaIndex['z'] = 21;
89     aaIndex['x'] = 22;
90     aaIndex['u'] = 22; // TODO: selenocystine triplet and codons needed. also extend subt. matrices
91   }
92
93   static
94   {
95     nucleotideIndex = new int[255];
96     for (int i = 0; i < 255; i++)
97     {
98       nucleotideIndex[i] = -1;
99     }
100
101     nucleotideIndex['A'] = 0;
102     nucleotideIndex['a'] = 0;
103     nucleotideIndex['C'] = 1;
104     nucleotideIndex['c'] = 1;
105     nucleotideIndex['G'] = 2;
106     nucleotideIndex['g'] = 2;
107     nucleotideIndex['T'] = 3;
108     nucleotideIndex['t'] = 3;
109     nucleotideIndex['U'] = 4;
110     nucleotideIndex['u'] = 4;
111     nucleotideIndex['I'] = 5;
112     nucleotideIndex['i'] = 5;
113     nucleotideIndex['X'] = 6;
114     nucleotideIndex['x'] = 6;
115     nucleotideIndex['R'] = 7;
116     nucleotideIndex['r'] = 7;
117     nucleotideIndex['Y'] = 8;
118     nucleotideIndex['y'] = 8;
119     nucleotideIndex['N'] = 9;
120     nucleotideIndex['n'] = 9;
121
122     nucleotideName.put("A", "Adenine");
123     nucleotideName.put("a", "Adenine");
124     nucleotideName.put("G", "Guanine");
125     nucleotideName.put("g", "Guanine");
126     nucleotideName.put("C", "Cytosine");
127     nucleotideName.put("c", "Cytosine");
128     nucleotideName.put("T", "Thymine");
129     nucleotideName.put("t", "Thymine");
130     nucleotideName.put("U", "Uracil");
131     nucleotideName.put("u", "Uracil");
132     nucleotideName.put("I", "Inosine");
133     nucleotideName.put("i", "Inosine");
134     nucleotideName.put("X", "Xanthine");
135     nucleotideName.put("x", "Xanthine");
136     nucleotideName.put("R", "Unknown Purine");
137     nucleotideName.put("r", "Unknown Purine");
138     nucleotideName.put("Y", "Unknown Pyrimidine");
139     nucleotideName.put("y", "Unknown Pyrimidine");
140     nucleotideName.put("N", "Unknown");
141     nucleotideName.put("n", "Unknown");
142   }
143
144   static
145   {
146     aa3Hash.put("ALA", new Integer(0));
147     aa3Hash.put("ARG", new Integer(1));
148     aa3Hash.put("ASN", new Integer(2));
149     aa3Hash.put("ASP", new Integer(3)); //D
150     aa3Hash.put("CYS", new Integer(4));
151     aa3Hash.put("GLN", new Integer(5)); //Q
152     aa3Hash.put("GLU", new Integer(6)); // E
153     aa3Hash.put("GLY", new Integer(7));
154     aa3Hash.put("HIS", new Integer(8));
155     aa3Hash.put("ILE", new Integer(9));
156     aa3Hash.put("LEU", new Integer(10));
157     aa3Hash.put("LYS", new Integer(11));
158     aa3Hash.put("MET", new Integer(12));
159     aa3Hash.put("PHE", new Integer(13));
160     aa3Hash.put("PRO", new Integer(14));
161     aa3Hash.put("SER", new Integer(15));
162     aa3Hash.put("THR", new Integer(16));
163     aa3Hash.put("TRP", new Integer(17));
164     aa3Hash.put("TYR", new Integer(18));
165     aa3Hash.put("VAL", new Integer(19));
166     // IUB Nomenclature for ambiguous peptides
167     aa3Hash.put("ASX", new Integer(20)); // "B";
168     aa3Hash.put("GLX", new Integer(21)); // X
169     aa3Hash.put("XAA", new Integer(22)); // X unknown
170     aa3Hash.put("-", new Integer(23));
171     aa3Hash.put("*", new Integer(23));
172     aa3Hash.put(".", new Integer(23));
173     aa3Hash.put(" ", new Integer(23));
174     aa3Hash.put("Gap", new Integer(23));
175   }
176
177   static
178   {
179     aa2Triplet.put("A", "ALA");
180     aa2Triplet.put("a", "ALA");
181     aa2Triplet.put("R", "ARG");
182     aa2Triplet.put("r", "ARG");
183     aa2Triplet.put("N", "ASN");
184     aa2Triplet.put("n", "ASN");
185     aa2Triplet.put("D", "ASP");
186     aa2Triplet.put("d", "ASP");
187     aa2Triplet.put("C", "CYS");
188     aa2Triplet.put("c", "CYS");
189     aa2Triplet.put("Q", "GLN");
190     aa2Triplet.put("q", "GLN");
191     aa2Triplet.put("E", "GLU");
192     aa2Triplet.put("e", "GLU");
193     aa2Triplet.put("G", "GLY");
194     aa2Triplet.put("g", "GLY");
195     aa2Triplet.put("H", "HIS");
196     aa2Triplet.put("h", "HIS");
197     aa2Triplet.put("I", "ILE");
198     aa2Triplet.put("i", "ILE");
199     aa2Triplet.put("L", "LEU");
200     aa2Triplet.put("l", "LEU");
201     aa2Triplet.put("K", "LYS");
202     aa2Triplet.put("k", "LYS");
203     aa2Triplet.put("M", "MET");
204     aa2Triplet.put("m", "MET");
205     aa2Triplet.put("F", "PHE");
206     aa2Triplet.put("f", "PHE");
207     aa2Triplet.put("P", "PRO");
208     aa2Triplet.put("p", "PRO");
209     aa2Triplet.put("S", "SER");
210     aa2Triplet.put("s", "SER");
211     aa2Triplet.put("T", "THR");
212     aa2Triplet.put("t", "THR");
213     aa2Triplet.put("W", "TRP");
214     aa2Triplet.put("w", "TRP");
215     aa2Triplet.put("Y", "TYR");
216     aa2Triplet.put("y", "TYR");
217     aa2Triplet.put("V", "VAL");
218     aa2Triplet.put("v", "VAL");
219   }
220
221   public static final String[] aa =
222       {
223       "A", "R", "N", "D", "C", "Q", "E", "G", "H", "I", "L", "K", "M", "F",
224       "P", "S", "T", "W", "Y", "V", "B", "Z", "X", "_", "*", ".", " "
225   };
226   public static final Color midBlue = new Color(100, 100, 255);
227   public static final Vector scaleColours = new Vector();
228
229   static
230   {
231     scaleColours.addElement(new Color(114, 0, 147));
232     scaleColours.addElement(new Color(156, 0, 98));
233     scaleColours.addElement(new Color(190, 0, 0));
234     scaleColours.addElement(Color.red);
235     scaleColours.addElement(new Color(255, 125, 0));
236     scaleColours.addElement(Color.orange);
237     scaleColours.addElement(new Color(255, 194, 85));
238     scaleColours.addElement(Color.yellow);
239     scaleColours.addElement(new Color(255, 255, 181));
240     scaleColours.addElement(Color.white);
241   }
242
243   public static final Color[] taylor =
244       {
245       new Color(204, 255, 0), // A  Greenish-yellowy-yellow
246       new Color(0, 0, 255), // R  Blueish-bluey-blue
247       new Color(204, 0, 255), // N  Blueish-reddy-blue
248       new Color(255, 0, 0), // D  Reddish-reddy-red
249       new Color(255, 255, 0), // C  Yellowish-yellowy-yellow
250       new Color(255, 0, 204), // Q  Reddish-bluey-red
251       new Color(255, 0, 102), // E  Blueish-reddy-red
252       new Color(255, 153, 0), // G  Yellowy-reddy-yellow
253       new Color(0, 102, 255), // H  Greenish-bluey-blue
254       new Color(102, 255, 0), // I  Greenish-yellowy-green
255       new Color(51, 255, 0), // L  Yellowish-greeny-green
256       new Color(102, 0, 255), // K  Reddish-bluey-blue
257       new Color(0, 255, 0), // M  Greenish-greeny-green
258       new Color(0, 255, 102), // F  Blueish-greeny-green
259       new Color(255, 204, 0), // P  Reddish-yellowy-yellow
260       new Color(255, 51, 0), // S  Yellowish-reddy-red
261       new Color(255, 102, 0), // T  Reddish-yellowy-red
262       new Color(0, 204, 255), // W  Blueish-greeny-green
263       new Color(0, 255, 204), // Y  Greenish-bluey-green
264       new Color(153, 255, 0), // V  Yellowish-greeny-yellow
265       Color.white, // B
266       Color.white, // Z
267       Color.white, // X
268       Color.white, // -
269       Color.white, // *
270       Color.white // .
271   };
272   public static final Color[] nucleotide =
273       {
274       new Color(100, 247, 63), // A
275       new Color(255, 179, 64), // C
276       new Color(235, 65, 60), // G
277       new Color(60, 136, 238), // T
278       new Color(60, 136, 238) // U
279   };
280   // Zappo
281   public static final Color[] zappo =
282       {
283       Color.pink, // A
284       midBlue, // R
285       Color.green, // N
286       Color.red, // D
287       Color.yellow, // C
288       Color.green, // Q
289       Color.red, // E
290       Color.magenta, // G
291       midBlue,// Color.red, // H
292       Color.pink, // I
293       Color.pink, // L
294       midBlue, // K
295       Color.pink, // M
296       Color.orange, // F
297       Color.magenta, // P
298       Color.green, // S
299       Color.green, // T
300       Color.orange, // W
301       Color.orange, // Y
302       Color.pink, // V
303       Color.white, // B
304       Color.white, // Z
305       Color.white, // X
306       Color.white, // -
307       Color.white, // *
308       Color.white, // .
309       Color.white // ' '
310   };
311
312   // Dunno where I got these numbers from
313   public static final double[] hyd2 =
314       {
315       0.62, //A
316       0.29, //R
317       -0.90, //N
318       -0.74, //D
319       1.19, //C
320       0.48, //Q
321       -0.40, //E
322       1.38, //G
323       -1.50, //H
324       1.06, //I
325       0.64, //L
326       -0.78, //K
327       0.12, //M
328       -0.85, //F
329       -2.53, //P
330       -0.18, //S
331       -0.05, //T
332       1.08, //W
333       0.81, //Y
334       0.0, //V
335       0.26, //B
336       0.0, //Z
337       0.0 //X
338   };
339   public static final double[] helix =
340       {
341       1.42, 0.98, 0.67, 1.01, 0.70, 1.11, 1.51, 0.57, 1.00, 1.08, 1.21, 1.16,
342       1.45, 1.13, 0.57, 0.77, 0.83, 1.08, 0.69, 1.06, 0.84, 1.31, 1.00, 0.0
343   };
344   public static final double helixmin = 0.57;
345   public static final double helixmax = 1.51;
346   public static final double[] strand =
347       {
348       0.83, 0.93, 0.89, 0.54, 1.19, 1.10, 0.37, 0.75, 0.87, 1.60, 1.30, 0.74,
349       1.05, 1.38, 0.55, 0.75, 1.19, 1.37, 1.47, 1.70, 0.72, 0.74, 1.0, 0.0
350   };
351   public static final double strandmin = 0.37;
352   public static final double strandmax = 1.7;
353   public static final double[] turn =
354       {
355       0.66, 0.95, 1.56, 1.46, 1.19, 0.98, 0.74, 1.56, 0.95, 0.47, 0.59, 1.01,
356       0.60, 0.60, 1.52, 1.43, 0.96, 0.96, 1.14, 0.50, 1.51, 0.86, 1.00, 0, 0
357   };
358   public static final double turnmin = 0.47;
359   public static final double turnmax = 1.56;
360   public static final double[] buried =
361       {
362       1.7, 0.1, 0.4, 0.4, 4.6, 0.3, 0.3, 1.8, 0.8, 3.1, 2.4, 0.05, 1.9, 2.2,
363       0.6, 0.8, 0.7, 1.6, 0.5, 2.9, 0.4, 0.3, 1.358, 0.00
364   };
365   public static final double buriedmin = 0.05;
366   public static final double buriedmax = 4.6;
367
368   // This is hydropathy index
369   // Kyte, J., and Doolittle, R.F., J. Mol. Biol.
370   // 1157, 105-132, 1982
371   public static final double[] hyd =
372       {
373       1.8, -4.5, -3.5, -3.5, 2.5, -3.5, -3.5, -0.4, -3.2, 4.5, 3.8, -3.9, 1.9,
374       2.8, -1.6, -0.8, -0.7, -0.9, -1.3, 4.2, -3.5, -3.5, -0.49, 0.0
375   };
376   public static final double hydmax = 4.5;
377   public static final double hydmin = -3.9;
378
379   //public static final double hydmax = 1.38;
380   //public static final double hydmin = -2.53;
381   private static final int[][] BLOSUM62 =
382       {
383       {
384       4, -1, -2, -2, 0, -1, -1, 0, -2, -1, -1, -1, -1, -2, -1, 1, 0, -3,
385       -2, 0, -2, -1, 0, -4
386   },
387       {
388       -1, 5, 0, -2, -3, 1, 0, -2, 0, -3, -2, 2, -1, -3, -2, -1, -1, -3, -2,
389       -3, -1, 0, -1, -4
390   },
391       {
392       -2, 0, 6, 1, -3, 0, 0, 0, 1, -3, -3, 0, -2, -3, -2, 1, 0, -4, -2, -3,
393       3, 0, -1, -4
394   },
395       {
396       -2, -2, 1, 6, -3, 0, 2, -1, -1, -3, -4, -1, -3, -3, -1, 0, -1, -4,
397       -3, -3, 4, 1, -1, -4
398   },
399       {
400       0, 3, -3, -3, 9, -3, -4, -3, -3, -1, -1, -3, -1, -2, -3, -1, -1, -2,
401       -2, -1, -3, -3, -2, -4
402   },
403       {
404       -1, 1, 0, 0, -3, 5, 2, -2, 0, -3, -2, 1, 0, -3, -1, 0, -1, -2, -1,
405       -2, 0, 3, -1, -4
406   },
407       {
408       -1, 0, 0, 2, -4, 2, 5, -2, 0, -3, -3, 1, -2, -3, -1, 0, -1, -3, -2,
409       -2, 1, 4, -1, -4
410   },
411       {
412       0, -2, 0, -1, -3, -2, -2, 6, -2, -4, -4, -2, -3, -3, -2, 0, -2, -2,
413       -3, -3, -1, -2, -1, -4
414   },
415       {
416       -2, 0, 1, -1, -3, 0, 0, -2, 8, -3, -3, -1, -2, -1, -2, -1, -2, -2, 2,
417       -3, 0, 0, -1, -4
418   },
419       {
420       -1, -3, -3, -3, -1, -3, -3, -4, -3, 4, 2, -3, 1, 0, -3, -2, -1, -3,
421       -1, 3, -3, -3, -1, -4
422   },
423       {
424       -1, -2, -3, -4, -1, -2, -3, -4, -3, 2, 4, -2, 2, 0, -3, -2, -1, -2,
425       -1, 1, -4, -3, -1, -4
426   },
427       {
428       -1, 2, 0, -1, -3, 1, 1, -2, -1, -3, -2, 5, -1, -3, -1, 0, -1, -3, -2,
429       -2, 0, 1, -1, -4
430   },
431       {
432       -1, -1, -2, -3, -1, 0, -2, -3, -2, 1, 2, -1, 5, 0, -2, -1, -1, -1,
433       -1, 1, -3, -1, -1, -4
434   },
435       {
436       -2, -3, -3, -3, -2, -3, -3, -3, -1, 0, 0, -3, 0, 6, -4, -2, -2, 1, 3,
437       -1, -3, -3, -1, -4
438   },
439       {
440       -1, -2, -2, -1, -3, -1, -1, -2, -2, -3, -3, -1, -2, -4, 7, -1, -1,
441       -4, -3, -2, -2, -1, -2, -4
442   },
443       {
444       1, -1, 1, 0, -1, 0, 0, 0, -1, -2, -2, 0, -1, -2, -1, 4, 1, -3, -2,
445       -2, 0, 0, 0, -4
446   },
447       {
448       0, -1, 0, -1, -1, -1, -1, -2, -2, -1, -1, -1, -1, -2, -1, 1, 5, -2,
449       -2, 0, -1, -1, 0, -4
450   },
451       {
452       -3, -3, -4, -4, -2, -2, -3, -2, -2, -3, -2, -3, -1, 1, -4, -3, -2,
453       11, 2, -3, -4, -3, -2, -4
454   },
455       {
456       -2, -2, -2, -3, -2, -1, -2, -3, 2, -1, -1, -2, -1, 3, -3, -2, -2, 2,
457       7, -1, -3, -2, -1, -4
458   },
459       {
460       0, -3, -3, -3, -1, -2, -2, -3, -3, 3, 1, -2, 1, -1, -2, -2, 0, -3,
461       -1, 4, -3, -2, -1, -4
462   },
463       {
464       -2, -1, 3, 4, -3, 0, 1, -1, 0, -3, -4, 0, -3, -3, -2, 0, -1, -4, -3,
465       -3, 4, 1, -1, -4
466   },
467       {
468       -1, 0, 0, 1, -3, 3, 4, -2, 0, -3, -3, 1, -1, -3, -1, 0, -1, -3, -2,
469       -2, 1, 4, -1, -4
470   },
471       {
472       0, -1, -1, -1, -2, -1, -1, -1, -1, -1, -1, -1, -1, -1, -2, 0, 0, -2,
473       -1, -1, -1, -1, -1, -4
474   },
475       {
476       -4, -4, -4, -4, -4, -4, -4, -4, -4, -4, -4, -4, -4, -4, -4, -4, -4,
477       -4, -4, -4, -4, -4, -4, 1
478   },
479   };
480   static final int[][] PAM250 =
481       {
482       {
483       2, -2, 0, 0, -2, 0, 0, 1, -1, -1, -2, -1, -1, -3, 1, 1, 1, -6, -3, 0,
484       0, 0, 0, -8
485   },
486       {
487       -2, 6, 0, -1, -4, 1, -1, -3, 2, -2, -3, 3, 0, -4, 0, 0, -1, 2, -4,
488       -2, -1, 0, -1, -8
489   },
490       {
491       0, 0, 2, 2, -4, 1, 1, 0, 2, -2, -3, 1, -2, -3, 0, 1, 0, -4, -2, -2,
492       2, 1, 0, -8
493   },
494       {
495       0, -1, 2, 4, -5, 2, 3, 1, 1, -2, -4, 0, -3, -6, -1, 0, 0, -7, -4, -2,
496       3, 3, -1, -8
497   },
498       {
499       -2, -4, -4, -5, 12, -5, -5, -3, -3, -2, -6, -5, -5, -4, -3, 0, -2,
500       -8, 0, -2, -4, -5, -3, -8
501   },
502       {
503       0, 1, 1, 2, -5, 4, 2, -1, 3, -2, -2, 1, -1, -5, 0, -1, -1, -5, -4,
504       -2, 1, 3, -1, -8
505   },
506       {
507       0, -1, 1, 3, -5, 2, 4, 0, 1, -2, -3, 0, -2, -5, -1, 0, 0, -7, -4, -2,
508       3, 3, -1, -8
509   },
510       {
511       1, -3, 0, 1, -3, -1, 0, 5, -2, -3, -4, -2, -3, -5, 0, 1, 0, -7, -5,
512       -1, 0, 0, -1, -8
513   },
514       {
515       -1, 2, 2, 1, -3, 3, 1, -2, 6, -2, -2, 0, -2, -2, 0, -1, -1, -3, 0,
516       -2, 1, 2, -1, -8
517   },
518       {
519       -1, -2, -2, -2, -2, -2, -2, -3, -2, 5, 2, -2, 2, 1, -2, -1, 0, -5,
520       -1, 4, -2, -2, -1, -8
521   },
522       {
523       -2, -3, -3, -4, -6, -2, -3, -4, -2, 2, 6, -3, 4, 2, -3, -3, -2, -2,
524       -1, 2, -3, -3, -1, -8
525   },
526       {
527       -1, 3, 1, 0, -5, 1, 0, -2, 0, -2, -3, 5, 0, -5, -1, 0, 0, -3, -4, -2,
528       1, 0, -1, -8
529   },
530       {
531       -1, 0, -2, -3, -5, -1, -2, -3, -2, 2, 4, 0, 6, 0, -2, -2, -1, -4, -2,
532       2, -2, -2, -1, -8
533   },
534       {
535       -3, -4, -3, -6, -4, -5, -5, -5, -2, 1, 2, -5, 0, 9, -5, -3, -3, 0, 7,
536       -1, -4, -5, -2, -8
537   },
538       {
539       1, 0, 0, -1, -3, 0, -1, 0, 0, -2, -3, -1, -2, -5, 6, 1, 0, -6, -5,
540       -1, -1, 0, -1, -8
541   },
542       {
543       1, 0, 1, 0, 0, -1, 0, 1, -1, -1, -3, 0, -2, -3, 1, 2, 1, -2, -3, -1,
544       0, 0, 0, -8
545   },
546       {
547       1, -1, 0, 0, -2, -1, 0, 0, -1, 0, -2, 0, -1, -3, 0, 1, 3, -5, -3, 0,
548       0, -1, 0, -8
549   },
550       {
551       -6, 2, -4, -7, -8, -5, -7, -7, -3, -5, -2, -3, -4, 0, -6, -2, -5, 17,
552       0, -6, -5, -6, -4, -8
553   },
554       {
555       -3, -4, -2, -4, 0, -4, -4, -5, 0, -1, -1, -4, -2, 7, -5, -3, -3, 0,
556       10, -2, -3, -4, -2, -8
557   },
558       {
559       0, -2, -2, -2, -2, -2, -2, -1, -2, 4, 2, -2, 2, -1, -1, -1, 0, -6,
560       -2, 4, -2, -2, -1, -8
561   },
562       {
563       0, -1, 2, 3, -4, 1, 3, 0, 1, -2, -3, 1, -2, -4, -1, 0, 0, -5, -3, -2,
564       3, 2, -1, -8
565   },
566       {
567       0, 0, 1, 3, -5, 3, 3, 0, 2, -2, -3, 0, -2, -5, 0, 0, -1, -6, -4, -2,
568       2, 3, -1, -8
569   },
570       {
571       0, -1, 0, -1, -3, -1, -1, -1, -1, -1, -1, -1, -1, -2, -1, 0, 0, -4,
572       -2, -1, -1, -1, -1, -8
573   },
574       {
575       -8, -8, -8, -8, -8, -8, -8, -8, -8, -8, -8, -8, -8, -8, -8, -8, -8,
576       -8, -8, -8, -8, -8, -8, 1
577   },
578   };
579   public static final Hashtable ssHash = new Hashtable(); // stores the number value of the aa
580
581   static
582   {
583     ssHash.put("H", Color.magenta);
584     ssHash.put("E", Color.yellow);
585     ssHash.put("-", Color.white);
586     ssHash.put(".", Color.white);
587     ssHash.put("S", Color.cyan);
588     ssHash.put("T", Color.blue);
589     ssHash.put("G", Color.pink);
590     ssHash.put("I", Color.pink);
591     ssHash.put("B", Color.yellow);
592   }
593
594   static final int[][] DNA =
595       {
596       {
597       5, -4, -4, -4, 1}, // C
598       {
599       -4, 5, -4, -4, 1}, // T
600       {
601       -4, -4, 5, -4, 1}, // A
602       {
603       -4, -4, -4, 5, 1}, // G
604       {
605       1, 1, 1, 1, 1}, // -
606   };
607   /**
608    * register matrices in list
609    */
610   static
611   {
612     scoreMatrices.put("BLOSUM62", new ScoreMatrix("BLOSUM62", BLOSUM62, 0));
613     scoreMatrices.put("PAM250", new ScoreMatrix("PAM250", PAM250, 0));
614     scoreMatrices.put("DNA", new ScoreMatrix("DNA", DNA, 1));
615   }
616
617   public static final Color[] pidColours =
618       {
619       midBlue, new Color(153, 153, 255),
620       //    Color.lightGray,
621       new Color(204, 204, 255),
622   };
623   public static final float[] pidThresholds =
624       {
625       80, 60, 40, };
626   public static Hashtable codonHash = new Hashtable();
627   public static Vector Lys = new Vector();
628   public static Vector Asn = new Vector();
629   public static Vector Gln = new Vector();
630   public static Vector His = new Vector();
631   public static Vector Glu = new Vector();
632   public static Vector Asp = new Vector();
633   public static Vector Tyr = new Vector();
634   public static Vector Thr = new Vector();
635   public static Vector Pro = new Vector();
636   public static Vector Ala = new Vector();
637   public static Vector Ser = new Vector();
638   public static Vector Arg = new Vector();
639   public static Vector Gly = new Vector();
640   public static Vector Trp = new Vector();
641   public static Vector Cys = new Vector();
642   public static Vector Ile = new Vector();
643   public static Vector Met = new Vector();
644   public static Vector Leu = new Vector();
645   public static Vector Val = new Vector();
646   public static Vector Phe = new Vector();
647   public static Vector STOP = new Vector();
648
649   static
650   {
651     codonHash.put("K", Lys);
652     codonHash.put("N", Asn);
653     codonHash.put("Q", Gln);
654     codonHash.put("H", His);
655     codonHash.put("E", Glu);
656     codonHash.put("D", Asp);
657     codonHash.put("Y", Tyr);
658     codonHash.put("T", Thr);
659     codonHash.put("P", Pro);
660     codonHash.put("A", Ala);
661     codonHash.put("S", Ser);
662     codonHash.put("R", Arg);
663     codonHash.put("G", Gly);
664     codonHash.put("W", Trp);
665     codonHash.put("C", Cys);
666     codonHash.put("I", Ile);
667     codonHash.put("M", Met);
668     codonHash.put("L", Leu);
669     codonHash.put("V", Val);
670     codonHash.put("F", Phe);
671     codonHash.put("STOP", STOP);
672   }
673
674   public static Hashtable codonHash2 = new Hashtable();
675
676   static
677   {
678     codonHash2.put("AAA", "K");
679     codonHash2.put("AAG", "K");
680     codonHash2.put("AAC", "N");
681     codonHash2.put("AAT", "N");
682
683     codonHash2.put("CAA", "E");
684     codonHash2.put("CAG", "E");
685     codonHash2.put("CAC", "H");
686     codonHash2.put("CAT", "H");
687
688     codonHash2.put("GAA", "Q");
689     codonHash2.put("GAG", "Q");
690     codonHash2.put("GAC", "D");
691     codonHash2.put("GAT", "D");
692
693     codonHash2.put("TAC", "Y");
694     codonHash2.put("TAT", "Y");
695
696     codonHash2.put("ACA", "T");
697     codonHash2.put("AAG", "T");
698     codonHash2.put("ACC", "T");
699     codonHash2.put("ACT", "T");
700
701     codonHash2.put("CCA", "P");
702     codonHash2.put("CCG", "P");
703     codonHash2.put("CCC", "P");
704     codonHash2.put("CCT", "P");
705
706     codonHash2.put("GCA", "A");
707     codonHash2.put("GCG", "A");
708     codonHash2.put("GCC", "A");
709     codonHash2.put("GCT", "A");
710
711     codonHash2.put("TCA", "S");
712     codonHash2.put("TCG", "S");
713     codonHash2.put("TCC", "S");
714     codonHash2.put("TCT", "S");
715     codonHash2.put("AGC", "S");
716     codonHash2.put("AGT", "S");
717
718     codonHash2.put("AGA", "R");
719     codonHash2.put("AGG", "R");
720     codonHash2.put("CGA", "R");
721     codonHash2.put("CGG", "R");
722     codonHash2.put("CGC", "R");
723     codonHash2.put("CGT", "R");
724
725     codonHash2.put("GGA", "G");
726     codonHash2.put("GGG", "G");
727     codonHash2.put("GGC", "G");
728     codonHash2.put("GGT", "G");
729
730     codonHash2.put("TGA", "*");
731     codonHash2.put("TAA", "*");
732     codonHash2.put("TAG", "*");
733
734     codonHash2.put("TGG", "W");
735
736     codonHash2.put("TGC", "C");
737     codonHash2.put("TGT", "C");
738
739     codonHash2.put("ATA", "I");
740     codonHash2.put("ATC", "I");
741     codonHash2.put("ATT", "I");
742
743     codonHash2.put("ATG", "M");
744
745     codonHash2.put("CTA", "L");
746     codonHash2.put("CTG", "L");
747     codonHash2.put("CTC", "L");
748     codonHash2.put("CTT", "L");
749     codonHash2.put("TTA", "L");
750     codonHash2.put("TTG", "L");
751
752     codonHash2.put("GTA", "V");
753     codonHash2.put("GTG", "V");
754     codonHash2.put("GTC", "V");
755     codonHash2.put("GTT", "V");
756
757     codonHash2.put("TTC", "F");
758     codonHash2.put("TTT", "F");
759   }
760
761   static
762   {
763     Lys.addElement("AAA");
764     Lys.addElement("AAG");
765     Asn.addElement("AAC");
766     Asn.addElement("AAT");
767
768     Gln.addElement("CAA");
769     Gln.addElement("CAG");
770     His.addElement("CAC");
771     His.addElement("CAT");
772
773     Glu.addElement("GAA");
774     Glu.addElement("GAG");
775     Asp.addElement("GAC");
776     Asp.addElement("GAT");
777
778     Tyr.addElement("TAC");
779     Tyr.addElement("TAT");
780
781     Thr.addElement("ACA");
782     Thr.addElement("ACG");
783     Thr.addElement("ACC");
784     Thr.addElement("ACT");
785
786     Pro.addElement("CCA");
787     Pro.addElement("CCG");
788     Pro.addElement("CCC");
789     Pro.addElement("CCT");
790
791     Ala.addElement("GCA");
792     Ala.addElement("GCG");
793     Ala.addElement("GCC");
794     Ala.addElement("GCT");
795
796     Ser.addElement("TCA");
797     Ser.addElement("TCG");
798     Ser.addElement("TCC");
799     Ser.addElement("TCT");
800     Ser.addElement("AGC");
801     Ser.addElement("AGT");
802
803     Arg.addElement("AGA");
804     Arg.addElement("AGG");
805     Arg.addElement("CGA");
806     Arg.addElement("CGG");
807     Arg.addElement("CGC");
808     Arg.addElement("CGT");
809
810     Gly.addElement("GGA");
811     Gly.addElement("GGG");
812     Gly.addElement("GGC");
813     Gly.addElement("GGT");
814
815     STOP.addElement("TGA");
816     STOP.addElement("TAA");
817     STOP.addElement("TAG");
818
819     Trp.addElement("TGG");
820
821     Cys.addElement("TGC");
822     Cys.addElement("TGT");
823
824     Ile.addElement("ATA");
825     Ile.addElement("ATC");
826     Ile.addElement("ATT");
827
828     Met.addElement("ATG");
829
830     Leu.addElement("CTA");
831     Leu.addElement("CTG");
832     Leu.addElement("CTC");
833     Leu.addElement("CTT");
834     Leu.addElement("TTA");
835     Leu.addElement("TTG");
836
837     Val.addElement("GTA");
838     Val.addElement("GTG");
839     Val.addElement("GTC");
840     Val.addElement("GTT");
841
842     Phe.addElement("TTC");
843     Phe.addElement("TTT");
844   }
845
846   //Stores residue codes/names and colours and other things
847   public static Hashtable propHash = new Hashtable();
848   public static Hashtable hydrophobic = new Hashtable();
849   public static Hashtable polar = new Hashtable();
850   public static Hashtable small = new Hashtable();
851   public static Hashtable positive = new Hashtable();
852   public static Hashtable negative = new Hashtable();
853   public static Hashtable charged = new Hashtable();
854   public static Hashtable aromatic = new Hashtable();
855   public static Hashtable aliphatic = new Hashtable();
856   public static Hashtable tiny = new Hashtable();
857   public static Hashtable proline = new Hashtable();
858
859   static
860   {
861     hydrophobic.put("I", new Integer(1));
862     hydrophobic.put("L", new Integer(1));
863     hydrophobic.put("V", new Integer(1));
864     hydrophobic.put("C", new Integer(1));
865     hydrophobic.put("A", new Integer(1));
866     hydrophobic.put("G", new Integer(1));
867     hydrophobic.put("M", new Integer(1));
868     hydrophobic.put("F", new Integer(1));
869     hydrophobic.put("Y", new Integer(1));
870     hydrophobic.put("W", new Integer(1));
871     hydrophobic.put("H", new Integer(1));
872     hydrophobic.put("K", new Integer(1));
873     hydrophobic.put("X", new Integer(1));
874     hydrophobic.put("-", new Integer(1));
875     hydrophobic.put("*", new Integer(1));
876     hydrophobic.put("R", new Integer(0));
877     hydrophobic.put("E", new Integer(0));
878     hydrophobic.put("Q", new Integer(0));
879     hydrophobic.put("D", new Integer(0));
880     hydrophobic.put("N", new Integer(0));
881     hydrophobic.put("S", new Integer(0));
882     hydrophobic.put("T", new Integer(0));
883     hydrophobic.put("P", new Integer(0));
884   }
885
886   static
887   {
888     polar.put("Y", new Integer(1));
889     polar.put("W", new Integer(1));
890     polar.put("H", new Integer(1));
891     polar.put("K", new Integer(1));
892     polar.put("R", new Integer(1));
893     polar.put("E", new Integer(1));
894     polar.put("Q", new Integer(1));
895     polar.put("D", new Integer(1));
896     polar.put("N", new Integer(1));
897     polar.put("S", new Integer(1));
898     polar.put("T", new Integer(1));
899     polar.put("X", new Integer(1));
900     polar.put("-", new Integer(1));
901     polar.put("*", new Integer(1));
902     polar.put("I", new Integer(0));
903     polar.put("L", new Integer(0));
904     polar.put("V", new Integer(0));
905     polar.put("C", new Integer(0));
906     polar.put("A", new Integer(0));
907     polar.put("G", new Integer(0));
908     polar.put("M", new Integer(0));
909     polar.put("F", new Integer(0));
910     polar.put("P", new Integer(0));
911   }
912
913   static
914   {
915     small.put("I", new Integer(0));
916     small.put("L", new Integer(0));
917     small.put("V", new Integer(1));
918     small.put("C", new Integer(1));
919     small.put("A", new Integer(1));
920     small.put("G", new Integer(1));
921     small.put("M", new Integer(0));
922     small.put("F", new Integer(0));
923     small.put("Y", new Integer(0));
924     small.put("W", new Integer(0));
925     small.put("H", new Integer(0));
926     small.put("K", new Integer(0));
927     small.put("R", new Integer(0));
928     small.put("E", new Integer(0));
929     small.put("Q", new Integer(0));
930     small.put("D", new Integer(1));
931     small.put("N", new Integer(1));
932     small.put("S", new Integer(1));
933     small.put("T", new Integer(1));
934     small.put("P", new Integer(1));
935     small.put("-", new Integer(1));
936     small.put("*", new Integer(1));
937   }
938
939   static
940   {
941     positive.put("I", new Integer(0));
942     positive.put("L", new Integer(0));
943     positive.put("V", new Integer(0));
944     positive.put("C", new Integer(0));
945     positive.put("A", new Integer(0));
946     positive.put("G", new Integer(0));
947     positive.put("M", new Integer(0));
948     positive.put("F", new Integer(0));
949     positive.put("Y", new Integer(0));
950     positive.put("W", new Integer(0));
951     positive.put("H", new Integer(1));
952     positive.put("K", new Integer(1));
953     positive.put("R", new Integer(1));
954     positive.put("E", new Integer(0));
955     positive.put("Q", new Integer(0));
956     positive.put("D", new Integer(0));
957     positive.put("N", new Integer(0));
958     positive.put("S", new Integer(0));
959     positive.put("T", new Integer(0));
960     positive.put("P", new Integer(0));
961     positive.put("-", new Integer(1));
962     positive.put("*", new Integer(1));
963   }
964
965   static
966   {
967     negative.put("I", new Integer(0));
968     negative.put("L", new Integer(0));
969     negative.put("V", new Integer(0));
970     negative.put("C", new Integer(0));
971     negative.put("A", new Integer(0));
972     negative.put("G", new Integer(0));
973     negative.put("M", new Integer(0));
974     negative.put("F", new Integer(0));
975     negative.put("Y", new Integer(0));
976     negative.put("W", new Integer(0));
977     negative.put("H", new Integer(0));
978     negative.put("K", new Integer(0));
979     negative.put("R", new Integer(0));
980     negative.put("E", new Integer(1));
981     negative.put("Q", new Integer(0));
982     negative.put("D", new Integer(1));
983     negative.put("N", new Integer(0));
984     negative.put("S", new Integer(0));
985     negative.put("T", new Integer(0));
986     negative.put("P", new Integer(0));
987     negative.put("-", new Integer(1));
988     negative.put("*", new Integer(1));
989   }
990
991   static
992   {
993     charged.put("I", new Integer(0));
994     charged.put("L", new Integer(0));
995     charged.put("V", new Integer(0));
996     charged.put("C", new Integer(0));
997     charged.put("A", new Integer(0));
998     charged.put("G", new Integer(0));
999     charged.put("M", new Integer(0));
1000     charged.put("F", new Integer(0));
1001     charged.put("Y", new Integer(0));
1002     charged.put("W", new Integer(0));
1003     charged.put("H", new Integer(1));
1004     charged.put("K", new Integer(1));
1005     charged.put("R", new Integer(1));
1006     charged.put("E", new Integer(1));
1007     charged.put("Q", new Integer(0));
1008     charged.put("D", new Integer(1));
1009     charged.put("N", new Integer(1));
1010     charged.put("S", new Integer(0));
1011     charged.put("T", new Integer(0));
1012     charged.put("P", new Integer(0));
1013     charged.put("-", new Integer(1));
1014     charged.put("*", new Integer(1));
1015   }
1016
1017   static
1018   {
1019     aromatic.put("I", new Integer(0));
1020     aromatic.put("L", new Integer(0));
1021     aromatic.put("V", new Integer(0));
1022     aromatic.put("C", new Integer(0));
1023     aromatic.put("A", new Integer(0));
1024     aromatic.put("G", new Integer(0));
1025     aromatic.put("M", new Integer(0));
1026     aromatic.put("F", new Integer(1));
1027     aromatic.put("Y", new Integer(1));
1028     aromatic.put("W", new Integer(1));
1029     aromatic.put("H", new Integer(1));
1030     aromatic.put("K", new Integer(0));
1031     aromatic.put("R", new Integer(0));
1032     aromatic.put("E", new Integer(0));
1033     aromatic.put("Q", new Integer(0));
1034     aromatic.put("D", new Integer(0));
1035     aromatic.put("N", new Integer(0));
1036     aromatic.put("S", new Integer(0));
1037     aromatic.put("T", new Integer(0));
1038     aromatic.put("P", new Integer(0));
1039     aromatic.put("-", new Integer(1));
1040     aromatic.put("*", new Integer(1));
1041   }
1042
1043   static
1044   {
1045     aliphatic.put("I", new Integer(1));
1046     aliphatic.put("L", new Integer(1));
1047     aliphatic.put("V", new Integer(1));
1048     aliphatic.put("C", new Integer(0));
1049     aliphatic.put("A", new Integer(0));
1050     aliphatic.put("G", new Integer(0));
1051     aliphatic.put("M", new Integer(0));
1052     aliphatic.put("F", new Integer(0));
1053     aliphatic.put("Y", new Integer(0));
1054     aliphatic.put("W", new Integer(0));
1055     aliphatic.put("H", new Integer(0));
1056     aliphatic.put("K", new Integer(0));
1057     aliphatic.put("R", new Integer(0));
1058     aliphatic.put("E", new Integer(0));
1059     aliphatic.put("Q", new Integer(0));
1060     aliphatic.put("D", new Integer(0));
1061     aliphatic.put("N", new Integer(0));
1062     aliphatic.put("S", new Integer(0));
1063     aliphatic.put("T", new Integer(0));
1064     aliphatic.put("P", new Integer(0));
1065     aliphatic.put("-", new Integer(1));
1066     aliphatic.put("*", new Integer(1));
1067   }
1068
1069   static
1070   {
1071     tiny.put("I", new Integer(0));
1072     tiny.put("L", new Integer(0));
1073     tiny.put("V", new Integer(0));
1074     tiny.put("C", new Integer(0));
1075     tiny.put("A", new Integer(1));
1076     tiny.put("G", new Integer(1));
1077     tiny.put("M", new Integer(0));
1078     tiny.put("F", new Integer(0));
1079     tiny.put("Y", new Integer(0));
1080     tiny.put("W", new Integer(0));
1081     tiny.put("H", new Integer(0));
1082     tiny.put("K", new Integer(0));
1083     tiny.put("R", new Integer(0));
1084     tiny.put("E", new Integer(0));
1085     tiny.put("Q", new Integer(0));
1086     tiny.put("D", new Integer(0));
1087     tiny.put("N", new Integer(0));
1088     tiny.put("S", new Integer(1));
1089     tiny.put("T", new Integer(0));
1090     tiny.put("P", new Integer(0));
1091     tiny.put("-", new Integer(1));
1092     tiny.put("*", new Integer(1));
1093   }
1094
1095   static
1096   {
1097     proline.put("I", new Integer(0));
1098     proline.put("L", new Integer(0));
1099     proline.put("V", new Integer(0));
1100     proline.put("C", new Integer(0));
1101     proline.put("A", new Integer(0));
1102     proline.put("G", new Integer(0));
1103     proline.put("M", new Integer(0));
1104     proline.put("F", new Integer(0));
1105     proline.put("Y", new Integer(0));
1106     proline.put("W", new Integer(0));
1107     proline.put("H", new Integer(0));
1108     proline.put("K", new Integer(0));
1109     proline.put("R", new Integer(0));
1110     proline.put("E", new Integer(0));
1111     proline.put("Q", new Integer(0));
1112     proline.put("D", new Integer(0));
1113     proline.put("N", new Integer(0));
1114     proline.put("S", new Integer(0));
1115     proline.put("T", new Integer(0));
1116     proline.put("P", new Integer(1));
1117     proline.put("-", new Integer(1));
1118     proline.put("*", new Integer(1));
1119   }
1120
1121   static
1122   {
1123     propHash.put("hydrophobic", hydrophobic);
1124     propHash.put("small", small);
1125     propHash.put("positive", positive);
1126     propHash.put("negative", negative);
1127     propHash.put("charged", charged);
1128     propHash.put("aromatic", aromatic);
1129     propHash.put("aliphatic", aliphatic);
1130     propHash.put("tiny", tiny);
1131     propHash.put("proline", proline);
1132     propHash.put("polar", polar);
1133   }
1134
1135   private ResidueProperties()
1136   {
1137   }
1138
1139   public static double getHydmax()
1140   {
1141     return hydmax;
1142   }
1143
1144   public static double getHydmin()
1145   {
1146     return hydmin;
1147   }
1148
1149   public static double[] getHyd()
1150   {
1151     return hyd;
1152   }
1153
1154   public static Hashtable getAA3Hash()
1155   {
1156     return aa3Hash;
1157   }
1158
1159   public static int[][] getDNA()
1160   {
1161     return ResidueProperties.DNA;
1162   }
1163
1164   public static int[][] getBLOSUM62()
1165   {
1166     return ResidueProperties.BLOSUM62;
1167   }
1168
1169   public static int getPAM250(String A1, String A2)
1170   {
1171     return getPAM250(A1.charAt(0), A2.charAt(0));
1172   }
1173
1174   public static int getBLOSUM62(char c1, char c2)
1175   {
1176     int pog = 0;
1177
1178     try
1179     {
1180       int a = aaIndex[c1];
1181       int b = aaIndex[c2];
1182
1183       pog = ResidueProperties.BLOSUM62[a][b];
1184     }
1185     catch (Exception e)
1186     {
1187       //System.out.println("Unknown residue in " + A1 + " " + A2);
1188     }
1189
1190     return pog;
1191   }
1192
1193   public static Vector getCodons(String res)
1194   {
1195     if (codonHash.containsKey(res))
1196     {
1197       return (Vector) codonHash.get(res);
1198     }
1199
1200     return null;
1201   }
1202
1203   public static String codonTranslate(String codon)
1204   {
1205     Enumeration e = codonHash.keys();
1206
1207     while (e.hasMoreElements())
1208     {
1209       String key = (String) e.nextElement();
1210       Vector tmp = (Vector) codonHash.get(key);
1211
1212       if (tmp.contains(codon.toUpperCase()))
1213       {
1214         return key;
1215       }
1216     }
1217
1218     return null;
1219   }
1220
1221   public static int[][] getDefaultPeptideMatrix()
1222   {
1223     return ResidueProperties.getBLOSUM62();
1224   }
1225
1226   public static int[][] getDefaultDnaMatrix()
1227   {
1228     return ResidueProperties.getDNA();
1229   }
1230
1231   /**
1232    * get a ScoreMatrix based on its string name
1233    * @param pwtype
1234    * @return matrix in scoreMatrices with key pwtype or null
1235    */
1236   public static ScoreMatrix getScoreMatrix(String pwtype)
1237   {
1238     Object val = scoreMatrices.get(pwtype);
1239     if (val != null)
1240     {
1241       return (ScoreMatrix) val;
1242     }
1243     return null;
1244   }
1245
1246   public static int getPAM250(char c, char d)
1247   {
1248     int a = aaIndex[c];
1249     int b = aaIndex[d];
1250
1251     int pog = ResidueProperties.PAM250[a][b];
1252
1253     return pog;
1254   }
1255
1256   public static Hashtable toDssp3State;
1257   static {
1258     toDssp3State = new Hashtable();
1259     toDssp3State.put("H", "H");
1260     toDssp3State.put("E", "E");
1261     toDssp3State.put("C", " ");
1262     toDssp3State.put(" ", " ");
1263     toDssp3State.put("T", " ");
1264     toDssp3State.put("B", "E");
1265     toDssp3State.put("G", "H");
1266     toDssp3State.put("I", "H");
1267     toDssp3State.put("X", " ");
1268   }
1269   /**
1270    * translate from other dssp secondary structure alphabets to 3-state
1271    * @param ssstring
1272    * @return ssstring as a three-state secondary structure assignment.
1273    */
1274   public static String getDssp3state(String ssstring)
1275   {
1276     if (ssstring==null)
1277     {
1278       return null;
1279     }
1280     StringBuffer ss = new StringBuffer();
1281     for (int i=0; i<ssstring.length(); i++)
1282     {
1283       String ssc = ssstring.substring(i, i+1);
1284       if (toDssp3State.containsKey(ssc))
1285       {
1286         ss.append((String) toDssp3State.get(ssc));
1287       } else {
1288         ss.append(" ");
1289       }
1290     }
1291     return ss.toString();
1292   }
1293 }