X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=src%2Fjalview%2Fschemes%2FResidueColourScheme.java;h=fc8b1b13ca5d67207bf70c26a5f527758812418e;hb=09d9063e70931a6cb75d16b230f5cd0665f0f340;hp=92de7ac3a5cb541a66505863354581d83898ab83;hpb=92bd4313e2f23a65df1eb965e836d178c1eacdd1;p=jalview.git diff --git a/src/jalview/schemes/ResidueColourScheme.java b/src/jalview/schemes/ResidueColourScheme.java index 92de7ac..fc8b1b1 100755 --- a/src/jalview/schemes/ResidueColourScheme.java +++ b/src/jalview/schemes/ResidueColourScheme.java @@ -20,15 +20,10 @@ */ package jalview.schemes; -import jalview.analysis.Conservation; import jalview.datamodel.AlignmentI; import jalview.datamodel.AnnotatedCollectionI; -import jalview.datamodel.ProfileI; -import jalview.datamodel.ProfilesI; import jalview.datamodel.SequenceCollectionI; import jalview.datamodel.SequenceI; -import jalview.util.ColorUtils; -import jalview.util.Comparison; import java.awt.Color; import java.util.Map; @@ -48,33 +43,14 @@ public abstract class ResidueColourScheme implements ColourSchemeI */ final int[] symbolIndex; - boolean conservationColouring = false; - /* * colour for residue characters as indexed by symbolIndex */ Color[] colors = null; - int threshold = 0; - /* Set when threshold colouring to either pid_gaps or pid_nogaps */ protected boolean ignoreGaps = false; - /* - * Consensus data indexed by column - */ - ProfilesI consensus; - - /* - * Conservation string as a char array - */ - char[] conservation; - - /* - * The conservation slider percentage setting - */ - int inc = 30; - /** * Creates a new ResidueColourScheme object. * @@ -82,15 +58,11 @@ public abstract class ResidueColourScheme implements ColourSchemeI * ResidueProperties.aaIndex) * @param colors * colours for symbols in sequences - * @param threshold - * threshold for conservation shading */ - public ResidueColourScheme(int[] aaOrnaIndex, Color[] colours, - int threshold) + public ResidueColourScheme(int[] aaOrnaIndex, Color[] colours) { symbolIndex = aaOrnaIndex; this.colors = colours; - this.threshold = threshold; } /** @@ -112,17 +84,6 @@ public abstract class ResidueColourScheme implements ColourSchemeI } /** - * Returns the colour for symbol 'A'. Intended for use in a 'fixed colour' - * colour scheme (for example a feature colour). - */ - @Override - public Color findColour() - { - // TODO delete this method in favour of ColorUtils.parseColourString()? - return findColour('A'); - } - - /** * Find a colour without an index in a sequence */ @Override @@ -131,215 +92,30 @@ public abstract class ResidueColourScheme implements ColourSchemeI return colors == null ? Color.white : colors[symbolIndex[c]]; } - @Override - public Color findColour(char c, int j, SequenceI seq) - { - Color currentColour; - - if (colors != null && symbolIndex != null && (threshold == 0) - || aboveThreshold(c, j)) - { - currentColour = colors[symbolIndex[c]]; - } - else - { - currentColour = Color.white; - } - - if (conservationColouring) - { - currentColour = applyConservation(currentColour, j); - } - - return currentColour; - } - - /** - * Get the percentage threshold for this colour scheme - * - * @return Returns the percentage threshold - */ - @Override - public int getThreshold() - { - return threshold; - } - - /** - * Sets the percentage consensus threshold value, and whether gaps are ignored - * in percentage identity calculation - * - * @param consensusThreshold - * @param ignoreGaps - */ - @Override - public void setThreshold(int consensusThreshold, boolean ignoreGaps) - { - threshold = consensusThreshold; - this.ignoreGaps = ignoreGaps; - } - - /** - * Answers true if there is a consensus profile for the specified column, and - * the given residue matches the consensus (or joint consensus) residue for - * the column, and the percentage identity for the profile is equal to or - * greater than the current threshold; else answers false. The percentage - * calculation depends on whether or not we are ignoring gapped sequences. - * - * @param residue - * @param column - * (index into consensus profiles) - * - * @return - * @see #setThreshold(int, boolean) - */ - public boolean aboveThreshold(char residue, int column) - { - if ('a' <= residue && residue <= 'z') - { - // TO UPPERCASE !!! - // Faster than toUpperCase - residue -= ('a' - 'A'); - } - - if (consensus == null) - { - return false; - } - - ProfileI profile = consensus.get(column); - - /* - * test whether this is the consensus (or joint consensus) residue - */ - if (profile != null - && profile.getModalResidue().contains(String.valueOf(residue))) - { - if (profile.getPercentageIdentity(ignoreGaps) >= threshold) - { - return true; - } - } - - return false; - } - - @Override - public boolean conservationApplied() - { - return conservationColouring; - } - - @Override - public void setConservationApplied(boolean conservationApplied) - { - conservationColouring = conservationApplied; - } - - @Override - public void setConservationInc(int i) - { - inc = i; - } - - @Override - public int getConservationInc() - { - return inc; - } - /** - * DOCUMENT ME! - * - * @param consensus - * DOCUMENT ME! + * Default is to call the overloaded method that ignores consensus. A colour + * scheme that depends on consensus (for example, Blosum62), should override + * this method instead. */ @Override - public void setConsensus(ProfilesI consensus) - { - if (consensus == null) - { - return; - } - - this.consensus = consensus; - } - - @Override - public void setConservation(Conservation cons) + public Color findColour(char c, int j, SequenceI seq, + String consensusResidue, float pid) { - if (cons == null) - { - conservationColouring = false; - conservation = null; - } - else - { - conservationColouring = true; - int iSize = cons.getConsSequence().getLength(); - conservation = new char[iSize]; - for (int i = 0; i < iSize; i++) - { - conservation[i] = cons.getConsSequence().getCharAt(i); - } - } - + return findColour(c, j, seq); } - /** - * Applies a combination of column conservation score, and conservation - * percentage slider, to 'bleach' out the residue colours towards white. - *

- * If a column is fully conserved (identical residues, conservation score 11, - * shown as *), or all 10 physico-chemical properties are conserved - * (conservation score 10, shown as +), then the colour is left unchanged. - *

- * Otherwise a 'bleaching' factor is computed and applied to the colour. This - * is designed to fade colours for scores of 0-9 completely to white at slider - * positions ranging from 18% - 100% respectively. - * - * @param currentColour - * @param column - * - * @return bleached (or unmodified) colour - */ - Color applyConservation(Color currentColour, int column) + protected Color findColour(char c, int j, SequenceI seq) { - if (conservation == null || conservation.length <= column) - { - return currentColour; - } - char conservationScore = conservation[column]; + Color colour = Color.white; - /* - * if residues are fully conserved (* or 11), or all properties - * are conserved (+ or 10), leave colour unchanged - */ - if (conservationScore == '*' || conservationScore == '+' - || conservationScore == (char) 10 - || conservationScore == (char) 11) + if (colors != null && symbolIndex != null && c < symbolIndex.length + && symbolIndex[c] < colors.length) { - return currentColour; + colour = colors[symbolIndex[c]]; } + // colour = adjustColour(c, j, colour); - if (Comparison.isGap(conservationScore)) - { - return Color.white; - } - - /* - * convert score 0-9 to a bleaching factor 1.1 - 0.2 - */ - float bleachFactor = (11 - (conservationScore - '0')) / 10f; - - /* - * scale this up by 0-5 (percentage slider / 20) - * as a result, scores of: 0 1 2 3 4 5 6 7 8 9 - * fade to white at slider value: 18 20 22 25 29 33 40 50 67 100% - */ - bleachFactor *= (inc / 20f); - - return ColorUtils.bleachColour(currentColour, bleachFactor); + return colour; } @Override @@ -409,4 +185,14 @@ public abstract class ResidueColourScheme implements ColourSchemeI { return false; } + + /** + * Default method returns true. Override this to return false in colour + * schemes that are not determined solely by the sequence symbol. + */ + @Override + public boolean isSimple() + { + return true; + } }