-/* Jalview - a java multiple alignment editor\r
- * Copyright (C) 1998 Michele Clamp\r
- *\r
- * This program is free software; you can redistribute it and/or\r
- * modify it under the terms of the GNU General Public License\r
- * as published by the Free Software Foundation; either version 2\r
- * of the License, or (at your option) any later version.\r
- *\r
- * This program is distributed in the hope that it will be useful,\r
- * but WITHOUT ANY WARRANTY; without even the implied warranty of\r
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\r
- * GNU General Public License for more details.\r
- *\r
- * You should have received a copy of the GNU General Public License\r
- * along with this program; if not, write to the Free Software\r
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.\r
- */\r
-package jalview.analysis;\r
-\r
-\r
-import java.util.*;\r
-import jalview.gui.*;\r
-import jalview.datamodel.*;\r
-\r
-\r
-public class Conservation {\r
- Vector sequences;\r
- int start;\r
- int end;\r
-\r
- Vector total = new Vector();\r
-\r
- String consString = "";\r
-\r
- DrawableSequence consSequence;\r
- Hashtable propHash;\r
- int threshold;\r
- Hashtable[] freqs;\r
-\r
- String name = "";\r
-\r
- public Conservation(String name,Hashtable[] freqs,Hashtable propHash, int threshold, Vector sequences, int start, int end) {\r
- this.name = name;\r
- this.freqs = freqs;\r
- this.propHash = propHash;\r
- this.threshold = threshold;\r
- this.sequences = sequences;\r
- this.start = start;\r
- this.end = end;\r
- }\r
-\r
-\r
- public void calculate() {\r
-\r
- for (int i = start;i <= end; i++) {\r
- Hashtable resultHash = null;\r
- Hashtable residueHash = null;\r
-\r
- resultHash = new Hashtable();\r
- residueHash = new Hashtable();\r
-\r
- for (int j=0; j < sequences.size(); j++) {\r
-\r
- if (sequences.elementAt(j) instanceof Sequence) {\r
- Sequence s = (Sequence)sequences.elementAt(j);\r
-\r
- if (s.getLength() > i) {\r
- String res = s.getSequence().substring(i,i+1);\r
-\r
- if (residueHash.containsKey(res)) {\r
- int count = ((Integer)residueHash.get(res)).intValue() ;\r
- count++;\r
- residueHash.put(res,new Integer(count));\r
- } else {\r
- residueHash.put(res,new Integer(1));\r
- }\r
- } else {\r
- if (residueHash.containsKey("-")) {\r
- int count = ((Integer)residueHash.get("-")).intValue() ;\r
- count++;\r
- residueHash.put("-",new Integer(count));\r
- } else {\r
- residueHash.put("-",new Integer(1));\r
- }\r
- }\r
- }\r
- }\r
-\r
- //What is the count threshold to count the residues in residueHash()\r
- int thresh = threshold*(sequences.size())/100;\r
-\r
- //loop over all the found residues\r
- Enumeration e = residueHash.keys();\r
-\r
- while (e.hasMoreElements()) {\r
-\r
- String res = (String)e.nextElement();\r
- if (((Integer)residueHash.get(res)).intValue() > thresh) {\r
-\r
- //Now loop over the properties\r
- Enumeration e2 = propHash.keys();\r
-\r
- while (e2.hasMoreElements()) {\r
- String type = (String)e2.nextElement();\r
- Hashtable ht = (Hashtable)propHash.get(type);\r
-\r
- //Have we ticked this before?\r
- if (! resultHash.containsKey(type)) {\r
- if (ht.containsKey(res)) {\r
- resultHash.put(type,ht.get(res));\r
- } else {\r
- resultHash.put(type,ht.get("-"));\r
- }\r
- } else if ( ((Integer)resultHash.get(type)).equals((Integer)ht.get(res)) == false) {\r
- resultHash.put(type,new Integer(-1));\r
- }\r
- }\r
- }\r
- }\r
- total.addElement(resultHash);\r
- }\r
- }\r
-\r
- public int countGaps(int j) {\r
- int count = 0;\r
-\r
- for (int i = 0; i < sequences.size();i++) {\r
- if( j+1 > ((Sequence)sequences.elementAt(i)).getSequence().length())\r
- { count++; continue;}\r
-\r
- String tmp = ((Sequence)sequences.elementAt(i)).getSequence().substring(j,j+1);\r
- if (tmp.equals(" ") || tmp.equals(".") || tmp.equals("-")) {\r
- count++;\r
- }\r
- }\r
- return count;\r
- }\r
-\r
- public void verdict(boolean consflag, float percentageGaps) {\r
- String consString = "";\r
-\r
- for (int i=start; i <= end; i++) {\r
- int totGaps = countGaps(i);\r
- float pgaps = (float)totGaps*100/(float)sequences.size();\r
-\r
- if (percentageGaps > pgaps)\r
- {\r
- Hashtable resultHash = (Hashtable)total.elementAt(i-start);\r
-\r
- //Now find the verdict\r
- int count = 0;\r
- Enumeration e3 = resultHash.keys();\r
-\r
- while (e3.hasMoreElements())\r
- {\r
- String type = (String)e3.nextElement();\r
- Integer result = (Integer)resultHash.get(type);\r
-\r
- //Do we want to count +ve conservation or +ve and -ve cons.?\r
-\r
- if (consflag)\r
- {\r
- if (result.intValue() == 1)\r
- count++;\r
- }\r
- else\r
- {\r
- if (result.intValue() != -1)\r
- count++;\r
- }\r
- }\r
-\r
- if (count < 10)\r
- consString = consString + String.valueOf(count);\r
- else\r
- consString = consString + "*";\r
-\r
- }\r
- else\r
- {\r
- consString = consString + "-";\r
- }\r
- }\r
-\r
- consSequence = new DrawableSequence(name,consString,start,end);\r
- }\r
-\r
- public jalview.gui.DrawableSequence getConsSequence() {\r
- return consSequence;\r
- }\r
-\r
-}\r
+/*
+ * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
+ * Copyright (C) $$Year-Rel$$ The Jalview Authors
+ *
+ * This file is part of Jalview.
+ *
+ * Jalview is free software: you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation, either version 3
+ * of the License, or (at your option) any later version.
+ *
+ * Jalview is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty
+ * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
+ * PURPOSE. See the GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with Jalview. If not, see <http://www.gnu.org/licenses/>.
+ * The Jalview Authors are detailed in the 'AUTHORS' file.
+ */
+package jalview.analysis;
+
+import jalview.analysis.scoremodels.ScoreMatrix;
+import jalview.analysis.scoremodels.ScoreModels;
+import jalview.datamodel.AlignmentAnnotation;
+import jalview.datamodel.Annotation;
+import jalview.datamodel.ResidueCount;
+import jalview.datamodel.ResidueCount.SymbolCounts;
+import jalview.datamodel.Sequence;
+import jalview.datamodel.SequenceI;
+import jalview.schemes.ResidueProperties;
+import jalview.util.Comparison;
+
+import java.awt.Color;
+import java.util.List;
+import java.util.Map;
+import java.util.Map.Entry;
+import java.util.SortedMap;
+import java.util.TreeMap;
+import java.util.Vector;
+
+/**
+ * Calculates conservation values for a given set of sequences
+ */
+public class Conservation
+{
+ /*
+ * need to have a minimum of 3% of sequences with a residue
+ * for it to be included in the conservation calculation
+ */
+ private static final int THRESHOLD_PERCENT = 3;
+
+ private static final int TOUPPERCASE = 'a' - 'A';
+
+ SequenceI[] sequences;
+
+ int start;
+
+ int end;
+
+ Vector<int[]> seqNums; // vector of int vectors where first is sequence
+ // checksum
+
+ int maxLength = 0; // used by quality calcs
+
+ boolean seqNumsChanged = false; // updated after any change via calcSeqNum;
+
+ /*
+ * a map per column with {property, conservation} where conservation value is
+ * 1 (property is conserved), 0 (absence of property is conserved) or -1
+ * (property is not conserved i.e. column has residues with and without it)
+ */
+ Map<String, Integer>[] total;
+
+ boolean canonicaliseAa = true; // if true then conservation calculation will
+
+ // map all symbols to canonical aa numbering
+ // rather than consider conservation of that
+ // symbol
+
+ /** Stores calculated quality values */
+ private Vector<Double> quality;
+
+ /** Stores maximum and minimum values of quality values */
+ private double[] qualityRange = new double[2];
+
+ private Sequence consSequence;
+
+ /*
+ * percentage of residues in a column to qualify for counting conservation
+ */
+ private int threshold;
+
+ private String name = "";
+
+ private int[][] cons2;
+
+ private String[] consSymbs;
+
+ /**
+ * Constructor using default threshold of 3%
+ *
+ * @param name
+ * Name of conservation
+ * @param sequences
+ * sequences to be used in calculation
+ * @param start
+ * start residue position
+ * @param end
+ * end residue position
+ */
+ public Conservation(String name, List<SequenceI> sequences, int start,
+ int end)
+ {
+ this(name, THRESHOLD_PERCENT, sequences, start, end);
+ }
+
+ /**
+ * Constructor
+ *
+ * @param name
+ * Name of conservation
+ * @param threshold
+ * percentage of sequences at or below which property conservation is
+ * ignored
+ * @param sequences
+ * sequences to be used in calculation
+ * @param start
+ * start column position
+ * @param end
+ * end column position
+ */
+ public Conservation(String name, int threshold,
+ List<SequenceI> sequences, int start, int end)
+ {
+ this.name = name;
+ this.threshold = threshold;
+ this.start = start;
+ this.end = end;
+
+ maxLength = end - start + 1; // default width includes bounds of
+ // calculation
+
+ int s, sSize = sequences.size();
+ SequenceI[] sarray = new SequenceI[sSize];
+ this.sequences = sarray;
+ try
+ {
+ for (s = 0; s < sSize; s++)
+ {
+ sarray[s] = sequences.get(s);
+ if (sarray[s].getLength() > maxLength)
+ {
+ maxLength = sarray[s].getLength();
+ }
+ }
+ } catch (ArrayIndexOutOfBoundsException ex)
+ {
+ // bail - another thread has modified the sequence array, so the current
+ // calculation is probably invalid.
+ this.sequences = new SequenceI[0];
+ maxLength = 0;
+ }
+ }
+
+ /**
+ * Translate sequence i into score matrix indices and store it in the i'th
+ * position of the seqNums array.
+ *
+ * @param i
+ * @param sm
+ */
+ private void calcSeqNum(int i, ScoreMatrix sm)
+ {
+ int gapIndex = sm.getGapIndex();
+ int sSize = sequences.length;
+
+ if ((i > -1) && (i < sSize))
+ {
+ String sq = sequences[i].getSequenceAsString();
+
+ if (seqNums.size() <= i)
+ {
+ seqNums.addElement(new int[sq.length() + 1]);
+ }
+
+ /*
+ * the first entry in the array is the sequence's hashcode,
+ * following entries are matrix indices of sequence characters
+ */
+ if (sq.hashCode() != seqNums.elementAt(i)[0])
+ {
+ int j;
+ int len;
+ seqNumsChanged = true;
+ len = sq.length();
+
+ if (maxLength < len)
+ {
+ maxLength = len;
+ }
+
+ int[] sqnum = new int[len + 1]; // better to always make a new array -
+ // sequence can change its length
+ sqnum[0] = sq.hashCode();
+
+ for (j = 1; j <= len; j++)
+ {
+ // sqnum[j] = ResidueProperties.aaIndex[sq.charAt(j - 1)];
+ sqnum[j] = sm.getMatrixIndex(sq.charAt(j - 1));
+ if (sqnum[j] == -1)
+ {
+ sqnum[j] = gapIndex;
+ }
+ }
+
+ seqNums.setElementAt(sqnum, i);
+ }
+ else
+ {
+ System.out.println("SEQUENCE HAS BEEN DELETED!!!");
+ }
+ }
+ else
+ {
+ // JBPNote INFO level debug
+ System.err
+ .println("ERROR: calcSeqNum called with out of range sequence index for Alignment\n");
+ }
+ }
+
+ /**
+ * Calculates the conservation values for given set of sequences
+ */
+ public void calculate()
+ {
+ int height = sequences.length;
+
+ total = new Map[maxLength];
+
+ for (int column = start; column <= end; column++)
+ {
+ ResidueCount values = countResidues(column);
+
+ /*
+ * percentage count at or below which we ignore residues
+ */
+ int thresh = (threshold * height) / 100;
+
+ /*
+ * check observed residues in column and record whether each
+ * physico-chemical property is conserved (+1), absence conserved (0),
+ * or not conserved (-1)
+ * Using TreeMap means properties are displayed in alphabetical order
+ */
+ SortedMap<String, Integer> resultHash = new TreeMap<String, Integer>();
+ SymbolCounts symbolCounts = values.getSymbolCounts();
+ char[] symbols = symbolCounts.symbols;
+ int[] counts = symbolCounts.values;
+ for (int j = 0; j < symbols.length; j++)
+ {
+ char c = symbols[j];
+ if (counts[j] > thresh)
+ {
+ recordConservation(resultHash, String.valueOf(c));
+ }
+ }
+ if (values.getGapCount() > thresh)
+ {
+ recordConservation(resultHash, "-");
+ }
+
+ if (total.length > 0)
+ {
+ total[column - start] = resultHash;
+ }
+ }
+ }
+
+ /**
+ * Updates the conservation results for an observed residue
+ *
+ * @param resultMap
+ * a map of {property, conservation} where conservation value is +1
+ * (all residues have the property), 0 (no residue has the property)
+ * or -1 (some do, some don't)
+ * @param res
+ */
+ protected static void recordConservation(Map<String, Integer> resultMap,
+ String res)
+ {
+ res = res.toUpperCase();
+ for (Entry<String, Map<String, Integer>> property : ResidueProperties.propHash
+ .entrySet())
+ {
+ String propertyName = property.getKey();
+ Integer residuePropertyValue = property.getValue().get(res);
+
+ if (!resultMap.containsKey(propertyName))
+ {
+ /*
+ * first time we've seen this residue - note whether it has this property
+ */
+ if (residuePropertyValue != null)
+ {
+ resultMap.put(propertyName, residuePropertyValue);
+ }
+ else
+ {
+ /*
+ * unrecognised residue - use default value for property
+ */
+ resultMap.put(propertyName, property.getValue().get("-"));
+ }
+ }
+ else
+ {
+ Integer currentResult = resultMap.get(propertyName);
+ if (currentResult.intValue() != -1
+ && !currentResult.equals(residuePropertyValue))
+ {
+ /*
+ * property is unconserved - residues seen both with and without it
+ */
+ resultMap.put(propertyName, Integer.valueOf(-1));
+ }
+ }
+ }
+ }
+
+ /**
+ * Counts residues (upper-cased) and gaps in the given column
+ *
+ * @param column
+ * @return
+ */
+ protected ResidueCount countResidues(int column)
+ {
+ ResidueCount values = new ResidueCount(false);
+
+ for (int row = 0; row < sequences.length; row++)
+ {
+ if (sequences[row].getLength() > column)
+ {
+ char c = sequences[row].getCharAt(column);
+ if (canonicaliseAa)
+ {
+ int index = ResidueProperties.aaIndex[c];
+ c = index > 20 ? '-' : ResidueProperties.aa[index].charAt(0);
+ }
+ else
+ {
+ c = toUpperCase(c);
+ }
+ if (Comparison.isGap(c))
+ {
+ values.addGap();
+ }
+ else
+ {
+ values.add(c);
+ }
+ }
+ else
+ {
+ values.addGap();
+ }
+ }
+ return values;
+ }
+
+ /**
+ * Counts conservation and gaps for a column of the alignment
+ *
+ * @return { 1 if fully conserved, else 0, gap count }
+ */
+ public int[] countConservationAndGaps(int column)
+ {
+ int gapCount = 0;
+ boolean fullyConserved = true;
+ int iSize = sequences.length;
+
+ if (iSize == 0)
+ {
+ return new int[] { 0, 0 };
+ }
+
+ char lastRes = '0';
+ for (int i = 0; i < iSize; i++)
+ {
+ if (column >= sequences[i].getLength())
+ {
+ gapCount++;
+ continue;
+ }
+
+ char c = sequences[i].getCharAt(column); // gaps do not have upper/lower case
+
+ if (Comparison.isGap((c)))
+ {
+ gapCount++;
+ }
+ else
+ {
+ c = toUpperCase(c);
+ if (lastRes == '0')
+ {
+ lastRes = c;
+ }
+ if (c != lastRes)
+ {
+ fullyConserved = false;
+ }
+ }
+ }
+
+ int[] r = new int[] { fullyConserved ? 1 : 0, gapCount };
+ return r;
+ }
+
+ /**
+ * Returns the upper-cased character if between 'a' and 'z', else the
+ * unchanged value
+ *
+ * @param c
+ * @return
+ */
+ char toUpperCase(char c)
+ {
+ if ('a' <= c && c <= 'z')
+ {
+ c -= TOUPPERCASE;
+ }
+ return c;
+ }
+
+ /**
+ * Calculates the conservation sequence
+ *
+ * @param positiveOnly
+ * if true, calculate positive conservation; else calculate both
+ * positive and negative conservation
+ * @param maxPercentageGaps
+ * the percentage of gaps in a column, at or above which no
+ * conservation is asserted
+ */
+ public void verdict(boolean positiveOnly, float maxPercentageGaps)
+ {
+ // TODO call this at the end of calculate(), should not be a public method
+
+ StringBuilder consString = new StringBuilder(end);
+
+ // NOTE THIS SHOULD CHECK IF THE CONSEQUENCE ALREADY
+ // EXISTS AND NOT OVERWRITE WITH '-', BUT THIS CASE
+ // DOES NOT EXIST IN JALVIEW 2.1.2
+ for (int i = 0; i < start; i++)
+ {
+ consString.append('-');
+ }
+ consSymbs = new String[end - start + 1];
+ for (int i = start; i <= end; i++)
+ {
+ int[] gapcons = countConservationAndGaps(i);
+ boolean fullyConserved = gapcons[0] == 1;
+ int totGaps = gapcons[1];
+ float pgaps = (totGaps * 100f) / sequences.length;
+
+ if (maxPercentageGaps > pgaps)
+ {
+ Map<String, Integer> resultHash = total[i - start];
+ int count = 0;
+ StringBuilder positives = new StringBuilder(64);
+ StringBuilder negatives = new StringBuilder(32);
+ for (String type : resultHash.keySet())
+ {
+ int result = resultHash.get(type).intValue();
+ if (result == -1)
+ {
+ /*
+ * not conserved (present or absent)
+ */
+ continue;
+ }
+ count++;
+ if (result == 1)
+ {
+ /*
+ * positively conserved property (all residues have it)
+ */
+ positives.append(positives.length() == 0 ? "" : " ");
+ positives.append(type);
+ }
+ if (result == 0 && !positiveOnly)
+ {
+ /*
+ * absense of property is conserved (all residues lack it)
+ */
+ negatives.append(negatives.length() == 0 ? "" : " ");
+ negatives.append("!").append(type);
+ }
+ }
+ if (negatives.length() > 0)
+ {
+ positives.append(" ").append(negatives);
+ }
+ consSymbs[i - start] = positives.toString();
+
+ if (count < 10)
+ {
+ consString.append(count); // Conserved props!=Identity
+ }
+ else
+ {
+ consString.append(fullyConserved ? "*" : "+");
+ }
+ }
+ else
+ {
+ consString.append('-');
+ }
+ }
+
+ consSequence = new Sequence(name, consString.toString(), start, end);
+ }
+
+ /**
+ *
+ *
+ * @return Conservation sequence
+ */
+ public SequenceI getConsSequence()
+ {
+ return consSequence;
+ }
+
+ // From Alignment.java in jalview118
+ public void findQuality()
+ {
+ findQuality(0, maxLength - 1);
+ }
+
+ /**
+ * DOCUMENT ME!
+ *
+ * @param sm
+ */
+ private void percentIdentity(ScoreMatrix sm)
+ {
+ seqNums = new Vector<int[]>();
+ int i = 0, iSize = sequences.length;
+ // Do we need to calculate this again?
+ for (i = 0; i < iSize; i++)
+ {
+ calcSeqNum(i, sm);
+ }
+
+ int gapIndex = sm.getGapIndex();
+
+ if ((cons2 == null) || seqNumsChanged)
+ {
+ // FIXME remove magic number 24 without changing calc
+ // sm.getSize() returns 25 so doesn't quite do it...
+ cons2 = new int[maxLength][24];
+
+ int j = 0;
+
+ while (j < sequences.length)
+ {
+ int[] sqnum = seqNums.elementAt(j);
+
+ for (i = 1; i < sqnum.length; i++)
+ {
+ cons2[i - 1][sqnum[i]]++;
+ }
+
+ for (i = sqnum.length - 1; i < maxLength; i++)
+ {
+ cons2[i][gapIndex]++; // gap count
+ }
+ j++;
+ }
+ }
+ }
+
+ /**
+ * Calculates the quality of the set of sequences
+ *
+ * @param startRes
+ * Start residue
+ * @param endRes
+ * End residue
+ */
+ public void findQuality(int startRes, int endRes)
+ {
+ quality = new Vector<Double>();
+
+ double max = -Double.MAX_VALUE;
+ ScoreMatrix blosum62 = ScoreModels.getInstance().getBlosum62();
+ float[][] blosumScores = blosum62.getMatrix();
+
+ // Loop over columns // JBPNote Profiling info
+ // long ts = System.currentTimeMillis();
+ // long te = System.currentTimeMillis();
+ percentIdentity(blosum62);
+
+ int size = seqNums.size();
+ int[] lengths = new int[size];
+ double tot, bigtot, sr, tmp;
+ double[] x, xx;
+ int l, j, i, ii, i2, k, seqNum;
+
+ for (l = 0; l < size; l++)
+ {
+ lengths[l] = seqNums.elementAt(l).length - 1;
+ }
+
+ // todo ? remove '*' (unused?) from score matrix and
+ // use getSize() here instead of getSize() - 1 ??
+ final int symbolCount = blosum62.getSize() - 1; // 24;
+ int gapIndex = blosum62.getGapIndex();
+
+ for (j = startRes; j <= endRes; j++)
+ {
+ bigtot = 0;
+
+ // First Xr = depends on column only
+ x = new double[symbolCount];
+
+ for (ii = 0; ii < symbolCount; ii++)
+ {
+ x[ii] = 0;
+
+ for (i2 = 0; i2 < symbolCount; i2++)
+ {
+ x[ii] += (((double) cons2[j][i2] * blosumScores[ii][i2]) + 4);
+ }
+
+ x[ii] /= size;
+ }
+
+ // Now calculate D for each position and sum
+ for (k = 0; k < size; k++)
+ {
+ tot = 0;
+ xx = new double[symbolCount];
+ seqNum = (j < lengths[k]) ? seqNums.elementAt(k)[j + 1] : gapIndex;
+ // Sequence, or gap at the end
+
+ // This is a loop over r
+ for (i = 0; i < symbolCount - 1; i++)
+ {
+ sr = 0;
+
+ sr = (double) blosumScores[i][seqNum] + 4;
+
+ // Calculate X with another loop over residues
+ // System.out.println("Xi " + i + " " + x[i] + " " + sr);
+ xx[i] = x[i] - sr;
+
+ tot += (xx[i] * xx[i]);
+ }
+
+ bigtot += Math.sqrt(tot);
+ }
+
+ // This is the quality for one column
+ if (max < bigtot)
+ {
+ max = bigtot;
+ }
+
+ // bigtot = bigtot * (size-cons2[j][23])/size;
+ quality.addElement(new Double(bigtot));
+
+ // Need to normalize by gaps
+ }
+
+ double newmax = -Double.MAX_VALUE;
+
+ for (j = startRes; j <= endRes; j++)
+ {
+ tmp = quality.elementAt(j).doubleValue();
+ // tmp = ((max - tmp) * (size - cons2[j][23])) / size;
+ tmp = ((max - tmp) * (size - cons2[j][gapIndex])) / size;
+
+ // System.out.println(tmp+ " " + j);
+ quality.setElementAt(new Double(tmp), j);
+
+ if (tmp > newmax)
+ {
+ newmax = tmp;
+ }
+ }
+
+ // System.out.println("Quality " + s);
+ qualityRange[0] = 0D;
+ qualityRange[1] = newmax;
+ }
+
+ /**
+ * Complete the given consensus and quuality annotation rows. Note: currently
+ * this method will enlarge the given annotation row if it is too small,
+ * otherwise will leave its length unchanged.
+ *
+ * @param conservation
+ * conservation annotation row
+ * @param quality2
+ * (optional - may be null)
+ * @param istart
+ * first column for conservation
+ * @param alWidth
+ * extent of conservation
+ */
+ public void completeAnnotations(AlignmentAnnotation conservation,
+ AlignmentAnnotation quality2, int istart, int alWidth)
+ {
+ char[] sequence = getConsSequence().getSequence();
+ float minR;
+ float minG;
+ float minB;
+ float maxR;
+ float maxG;
+ float maxB;
+ minR = 0.3f;
+ minG = 0.0f;
+ minB = 0f;
+ maxR = 1.0f - minR;
+ maxG = 0.9f - minG;
+ maxB = 0f - minB; // scalable range for colouring both Conservation and
+ // Quality
+
+ float min = 0f;
+ float max = 11f;
+ float qmin = 0f;
+ float qmax = 0f;
+
+ char c;
+
+ if (conservation != null && conservation.annotations != null
+ && conservation.annotations.length < alWidth)
+ {
+ conservation.annotations = new Annotation[alWidth];
+ }
+
+ if (quality2 != null)
+ {
+ quality2.graphMax = (float) qualityRange[1];
+ if (quality2.annotations != null
+ && quality2.annotations.length < alWidth)
+ {
+ quality2.annotations = new Annotation[alWidth];
+ }
+ qmin = (float) qualityRange[0];
+ qmax = (float) qualityRange[1];
+ }
+
+ for (int i = istart; i < alWidth; i++)
+ {
+ float value = 0;
+
+ c = sequence[i];
+
+ if (Character.isDigit(c))
+ {
+ value = c - '0';
+ }
+ else if (c == '*')
+ {
+ value = 11;
+ }
+ else if (c == '+')
+ {
+ value = 10;
+ }
+
+ if (conservation != null)
+ {
+ float vprop = value - min;
+ vprop /= max;
+ int consp = i - start;
+ String conssym = (value > 0 && consp > -1 && consp < consSymbs.length) ? consSymbs[consp]
+ : "";
+ conservation.annotations[i] = new Annotation(String.valueOf(c),
+ conssym, ' ', value, new Color(minR + (maxR * vprop), minG
+ + (maxG * vprop), minB + (maxB * vprop)));
+ }
+
+ // Quality calc
+ if (quality2 != null)
+ {
+ value = quality.elementAt(i).floatValue();
+ float vprop = value - qmin;
+ vprop /= qmax;
+ quality2.annotations[i] = new Annotation(" ",
+ String.valueOf(value), ' ', value, new Color(minR
+ + (maxR * vprop), minG + (maxG * vprop), minB
+ + (maxB * vprop)));
+ }
+ }
+ }
+
+ /**
+ * construct and call the calculation methods on a new Conservation object
+ *
+ * @param name
+ * - name of conservation
+ * @param seqs
+ * @param start
+ * first column in calculation window
+ * @param end
+ * last column in calculation window
+ * @param positiveOnly
+ * calculate positive (true) or positive and negative (false)
+ * conservation
+ * @param maxPercentGaps
+ * percentage of gaps tolerated in column
+ * @param calcQuality
+ * flag indicating if alignment quality should be calculated
+ * @return Conservation object ready for use in visualization
+ */
+ public static Conservation calculateConservation(String name,
+ List<SequenceI> seqs, int start, int end, boolean positiveOnly,
+ int maxPercentGaps, boolean calcQuality)
+ {
+ Conservation cons = new Conservation(name, seqs, start, end);
+ cons.calculate();
+ cons.verdict(positiveOnly, maxPercentGaps);
+
+ if (calcQuality)
+ {
+ cons.findQuality();
+ }
+
+ return cons;
+ }
+
+ /**
+ * Returns the computed tooltip (annotation description) for a given column.
+ * The tip is empty if the conservation score is zero, otherwise holds the
+ * conserved properties (and, optionally, properties whose absence is
+ * conserved).
+ *
+ * @param column
+ * @return
+ */
+ String getTooltip(int column)
+ {
+ char[] sequence = getConsSequence().getSequence();
+ char val = column < sequence.length ? sequence[column] : '-';
+ boolean hasConservation = val != '-' && val != '0';
+ int consp = column - start;
+ String tip = (hasConservation && consp > -1 && consp < consSymbs.length) ? consSymbs[consp]
+ : "";
+ return tip;
+ }
+}