JAL-2023 CDS sequences added to / share alignment dataset
[jalview.git] / src / jalview / viewmodel / AlignmentViewport.java
1 /*
2  * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
3  * Copyright (C) $$Year-Rel$$ The Jalview Authors
4  * 
5  * This file is part of Jalview.
6  * 
7  * Jalview is free software: you can redistribute it and/or
8  * modify it under the terms of the GNU General Public License 
9  * as published by the Free Software Foundation, either version 3
10  * of the License, or (at your option) any later version.
11  *  
12  * Jalview is distributed in the hope that it will be useful, but 
13  * WITHOUT ANY WARRANTY; without even the implied warranty 
14  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
15  * PURPOSE.  See the GNU General Public License for more details.
16  * 
17  * You should have received a copy of the GNU General Public License
18  * along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
19  * The Jalview Authors are detailed in the 'AUTHORS' file.
20  */
21 package jalview.viewmodel;
22
23 import jalview.analysis.AnnotationSorter.SequenceAnnotationOrder;
24 import jalview.analysis.Conservation;
25 import jalview.api.AlignCalcManagerI;
26 import jalview.api.AlignViewportI;
27 import jalview.api.AlignmentViewPanel;
28 import jalview.api.FeaturesDisplayedI;
29 import jalview.api.ViewStyleI;
30 import jalview.commands.CommandI;
31 import jalview.datamodel.AlignedCodonFrame;
32 import jalview.datamodel.AlignmentAnnotation;
33 import jalview.datamodel.AlignmentI;
34 import jalview.datamodel.AlignmentView;
35 import jalview.datamodel.Annotation;
36 import jalview.datamodel.CigarArray;
37 import jalview.datamodel.ColumnSelection;
38 import jalview.datamodel.HiddenSequences;
39 import jalview.datamodel.SearchResults;
40 import jalview.datamodel.Sequence;
41 import jalview.datamodel.SequenceCollectionI;
42 import jalview.datamodel.SequenceGroup;
43 import jalview.datamodel.SequenceI;
44 import jalview.schemes.Blosum62ColourScheme;
45 import jalview.schemes.ColourSchemeI;
46 import jalview.schemes.PIDColourScheme;
47 import jalview.schemes.ResidueProperties;
48 import jalview.structure.CommandListener;
49 import jalview.structure.StructureSelectionManager;
50 import jalview.structure.VamsasSource;
51 import jalview.util.Comparison;
52 import jalview.util.MapList;
53 import jalview.util.MappingUtils;
54 import jalview.viewmodel.styles.ViewStyle;
55 import jalview.workers.AlignCalcManager;
56 import jalview.workers.ComplementConsensusThread;
57 import jalview.workers.ConsensusThread;
58 import jalview.workers.StrucConsensusThread;
59
60 import java.awt.Color;
61 import java.util.ArrayDeque;
62 import java.util.ArrayList;
63 import java.util.BitSet;
64 import java.util.Deque;
65 import java.util.HashMap;
66 import java.util.Hashtable;
67 import java.util.List;
68 import java.util.Map;
69
70 /**
71  * base class holding visualization and analysis attributes and common logic for
72  * an active alignment view displayed in the GUI
73  * 
74  * @author jimp
75  * 
76  */
77 public abstract class AlignmentViewport implements AlignViewportI,
78         CommandListener, VamsasSource
79 {
80   protected ViewStyleI viewStyle = new ViewStyle();
81
82   /**
83    * A viewport that hosts the cDna view of this (protein), or vice versa (if
84    * set).
85    */
86   AlignViewportI codingComplement = null;
87
88   FeaturesDisplayedI featuresDisplayed = null;
89
90   protected Deque<CommandI> historyList = new ArrayDeque<CommandI>();
91
92   protected Deque<CommandI> redoList = new ArrayDeque<CommandI>();
93
94   /**
95    * @param name
96    * @see jalview.api.ViewStyleI#setFontName(java.lang.String)
97    */
98   @Override
99   public void setFontName(String name)
100   {
101     viewStyle.setFontName(name);
102   }
103
104   /**
105    * @param style
106    * @see jalview.api.ViewStyleI#setFontStyle(int)
107    */
108   @Override
109   public void setFontStyle(int style)
110   {
111     viewStyle.setFontStyle(style);
112   }
113
114   /**
115    * @param size
116    * @see jalview.api.ViewStyleI#setFontSize(int)
117    */
118   @Override
119   public void setFontSize(int size)
120   {
121     viewStyle.setFontSize(size);
122   }
123
124   /**
125    * @return
126    * @see jalview.api.ViewStyleI#getFontStyle()
127    */
128   @Override
129   public int getFontStyle()
130   {
131     return viewStyle.getFontStyle();
132   }
133
134   /**
135    * @return
136    * @see jalview.api.ViewStyleI#getFontName()
137    */
138   @Override
139   public String getFontName()
140   {
141     return viewStyle.getFontName();
142   }
143
144   /**
145    * @return
146    * @see jalview.api.ViewStyleI#getFontSize()
147    */
148   @Override
149   public int getFontSize()
150   {
151     return viewStyle.getFontSize();
152   }
153
154   /**
155    * @param upperCasebold
156    * @see jalview.api.ViewStyleI#setUpperCasebold(boolean)
157    */
158   @Override
159   public void setUpperCasebold(boolean upperCasebold)
160   {
161     viewStyle.setUpperCasebold(upperCasebold);
162   }
163
164   /**
165    * @return
166    * @see jalview.api.ViewStyleI#isUpperCasebold()
167    */
168   @Override
169   public boolean isUpperCasebold()
170   {
171     return viewStyle.isUpperCasebold();
172   }
173
174   /**
175    * @return
176    * @see jalview.api.ViewStyleI#isSeqNameItalics()
177    */
178   @Override
179   public boolean isSeqNameItalics()
180   {
181     return viewStyle.isSeqNameItalics();
182   }
183
184   /**
185    * @param colourByReferenceSeq
186    * @see jalview.api.ViewStyleI#setColourByReferenceSeq(boolean)
187    */
188   @Override
189   public void setColourByReferenceSeq(boolean colourByReferenceSeq)
190   {
191     viewStyle.setColourByReferenceSeq(colourByReferenceSeq);
192   }
193
194   /**
195    * @param b
196    * @see jalview.api.ViewStyleI#setColourAppliesToAllGroups(boolean)
197    */
198   @Override
199   public void setColourAppliesToAllGroups(boolean b)
200   {
201     viewStyle.setColourAppliesToAllGroups(b);
202   }
203
204   /**
205    * @return
206    * @see jalview.api.ViewStyleI#getColourAppliesToAllGroups()
207    */
208   @Override
209   public boolean getColourAppliesToAllGroups()
210   {
211     return viewStyle.getColourAppliesToAllGroups();
212   }
213
214   /**
215    * @return
216    * @see jalview.api.ViewStyleI#getAbovePIDThreshold()
217    */
218   @Override
219   public boolean getAbovePIDThreshold()
220   {
221     return viewStyle.getAbovePIDThreshold();
222   }
223
224   /**
225    * @param inc
226    * @see jalview.api.ViewStyleI#setIncrement(int)
227    */
228   @Override
229   public void setIncrement(int inc)
230   {
231     viewStyle.setIncrement(inc);
232   }
233
234   /**
235    * @return
236    * @see jalview.api.ViewStyleI#getIncrement()
237    */
238   @Override
239   public int getIncrement()
240   {
241     return viewStyle.getIncrement();
242   }
243
244   /**
245    * @param b
246    * @see jalview.api.ViewStyleI#setConservationSelected(boolean)
247    */
248   @Override
249   public void setConservationSelected(boolean b)
250   {
251     viewStyle.setConservationSelected(b);
252   }
253
254   /**
255    * @param show
256    * @see jalview.api.ViewStyleI#setShowHiddenMarkers(boolean)
257    */
258   @Override
259   public void setShowHiddenMarkers(boolean show)
260   {
261     viewStyle.setShowHiddenMarkers(show);
262   }
263
264   /**
265    * @return
266    * @see jalview.api.ViewStyleI#getShowHiddenMarkers()
267    */
268   @Override
269   public boolean getShowHiddenMarkers()
270   {
271     return viewStyle.getShowHiddenMarkers();
272   }
273
274   /**
275    * @param b
276    * @see jalview.api.ViewStyleI#setScaleRightWrapped(boolean)
277    */
278   @Override
279   public void setScaleRightWrapped(boolean b)
280   {
281     viewStyle.setScaleRightWrapped(b);
282   }
283
284   /**
285    * @param b
286    * @see jalview.api.ViewStyleI#setScaleLeftWrapped(boolean)
287    */
288   @Override
289   public void setScaleLeftWrapped(boolean b)
290   {
291     viewStyle.setScaleLeftWrapped(b);
292   }
293
294   /**
295    * @param b
296    * @see jalview.api.ViewStyleI#setScaleAboveWrapped(boolean)
297    */
298   @Override
299   public void setScaleAboveWrapped(boolean b)
300   {
301     viewStyle.setScaleAboveWrapped(b);
302   }
303
304   /**
305    * @return
306    * @see jalview.api.ViewStyleI#getScaleLeftWrapped()
307    */
308   @Override
309   public boolean getScaleLeftWrapped()
310   {
311     return viewStyle.getScaleLeftWrapped();
312   }
313
314   /**
315    * @return
316    * @see jalview.api.ViewStyleI#getScaleAboveWrapped()
317    */
318   @Override
319   public boolean getScaleAboveWrapped()
320   {
321     return viewStyle.getScaleAboveWrapped();
322   }
323
324   /**
325    * @return
326    * @see jalview.api.ViewStyleI#getScaleRightWrapped()
327    */
328   @Override
329   public boolean getScaleRightWrapped()
330   {
331     return viewStyle.getScaleRightWrapped();
332   }
333
334   /**
335    * @param b
336    * @see jalview.api.ViewStyleI#setAbovePIDThreshold(boolean)
337    */
338   @Override
339   public void setAbovePIDThreshold(boolean b)
340   {
341     viewStyle.setAbovePIDThreshold(b);
342   }
343
344   /**
345    * @param thresh
346    * @see jalview.api.ViewStyleI#setThreshold(int)
347    */
348   @Override
349   public void setThreshold(int thresh)
350   {
351     viewStyle.setThreshold(thresh);
352   }
353
354   /**
355    * @return
356    * @see jalview.api.ViewStyleI#getThreshold()
357    */
358   @Override
359   public int getThreshold()
360   {
361     return viewStyle.getThreshold();
362   }
363
364   /**
365    * @return
366    * @see jalview.api.ViewStyleI#getShowJVSuffix()
367    */
368   @Override
369   public boolean getShowJVSuffix()
370   {
371     return viewStyle.getShowJVSuffix();
372   }
373
374   /**
375    * @param b
376    * @see jalview.api.ViewStyleI#setShowJVSuffix(boolean)
377    */
378   @Override
379   public void setShowJVSuffix(boolean b)
380   {
381     viewStyle.setShowJVSuffix(b);
382   }
383
384   /**
385    * @param state
386    * @see jalview.api.ViewStyleI#setWrapAlignment(boolean)
387    */
388   @Override
389   public void setWrapAlignment(boolean state)
390   {
391     viewStyle.setWrapAlignment(state);
392   }
393
394   /**
395    * @param state
396    * @see jalview.api.ViewStyleI#setShowText(boolean)
397    */
398   @Override
399   public void setShowText(boolean state)
400   {
401     viewStyle.setShowText(state);
402   }
403
404   /**
405    * @param state
406    * @see jalview.api.ViewStyleI#setRenderGaps(boolean)
407    */
408   @Override
409   public void setRenderGaps(boolean state)
410   {
411     viewStyle.setRenderGaps(state);
412   }
413
414   /**
415    * @return
416    * @see jalview.api.ViewStyleI#getColourText()
417    */
418   @Override
419   public boolean getColourText()
420   {
421     return viewStyle.getColourText();
422   }
423
424   /**
425    * @param state
426    * @see jalview.api.ViewStyleI#setColourText(boolean)
427    */
428   @Override
429   public void setColourText(boolean state)
430   {
431     viewStyle.setColourText(state);
432   }
433
434   /**
435    * @return
436    * @see jalview.api.ViewStyleI#getWrapAlignment()
437    */
438   @Override
439   public boolean getWrapAlignment()
440   {
441     return viewStyle.getWrapAlignment();
442   }
443
444   /**
445    * @return
446    * @see jalview.api.ViewStyleI#getShowText()
447    */
448   @Override
449   public boolean getShowText()
450   {
451     return viewStyle.getShowText();
452   }
453
454   /**
455    * @return
456    * @see jalview.api.ViewStyleI#getWrappedWidth()
457    */
458   @Override
459   public int getWrappedWidth()
460   {
461     return viewStyle.getWrappedWidth();
462   }
463
464   /**
465    * @param w
466    * @see jalview.api.ViewStyleI#setWrappedWidth(int)
467    */
468   @Override
469   public void setWrappedWidth(int w)
470   {
471     viewStyle.setWrappedWidth(w);
472   }
473
474   /**
475    * @return
476    * @see jalview.api.ViewStyleI#getCharHeight()
477    */
478   @Override
479   public int getCharHeight()
480   {
481     return viewStyle.getCharHeight();
482   }
483
484   /**
485    * @param h
486    * @see jalview.api.ViewStyleI#setCharHeight(int)
487    */
488   @Override
489   public void setCharHeight(int h)
490   {
491     viewStyle.setCharHeight(h);
492   }
493
494   /**
495    * @return
496    * @see jalview.api.ViewStyleI#getCharWidth()
497    */
498   @Override
499   public int getCharWidth()
500   {
501     return viewStyle.getCharWidth();
502   }
503
504   /**
505    * @param w
506    * @see jalview.api.ViewStyleI#setCharWidth(int)
507    */
508   @Override
509   public void setCharWidth(int w)
510   {
511     viewStyle.setCharWidth(w);
512   }
513
514   /**
515    * @return
516    * @see jalview.api.ViewStyleI#getShowBoxes()
517    */
518   @Override
519   public boolean getShowBoxes()
520   {
521     return viewStyle.getShowBoxes();
522   }
523
524   /**
525    * @return
526    * @see jalview.api.ViewStyleI#getShowUnconserved()
527    */
528   @Override
529   public boolean getShowUnconserved()
530   {
531     return viewStyle.getShowUnconserved();
532   }
533
534   /**
535    * @param showunconserved
536    * @see jalview.api.ViewStyleI#setShowUnconserved(boolean)
537    */
538   @Override
539   public void setShowUnconserved(boolean showunconserved)
540   {
541     viewStyle.setShowUnconserved(showunconserved);
542   }
543
544   /**
545    * @param default1
546    * @see jalview.api.ViewStyleI#setSeqNameItalics(boolean)
547    */
548   @Override
549   public void setSeqNameItalics(boolean default1)
550   {
551     viewStyle.setSeqNameItalics(default1);
552   }
553
554   /**
555    * alignment displayed in the viewport. Please use get/setter
556    */
557   protected AlignmentI alignment;
558
559   @Override
560   public AlignmentI getAlignment()
561   {
562     return alignment;
563   }
564
565   @Override
566   public char getGapCharacter()
567   {
568     return alignment.getGapCharacter();
569   }
570
571   protected String sequenceSetID;
572
573   /**
574    * probably unused indicator that view is of a dataset rather than an
575    * alignment
576    */
577   protected boolean isDataset = false;
578
579   public void setDataset(boolean b)
580   {
581     isDataset = b;
582   }
583
584   public boolean isDataset()
585   {
586     return isDataset;
587   }
588
589   private Map<SequenceI, SequenceCollectionI> hiddenRepSequences;
590
591   protected ColumnSelection colSel = new ColumnSelection();
592
593   public boolean autoCalculateConsensus = true;
594
595   protected boolean autoCalculateStrucConsensus = true;
596
597   protected boolean ignoreGapsInConsensusCalculation = false;
598
599   protected ColourSchemeI globalColourScheme = null;
600
601   @Override
602   public void setGlobalColourScheme(ColourSchemeI cs)
603   {
604     // TODO: logic refactored from AlignFrame changeColour -
605     // TODO: autorecalc stuff should be changed to rely on the worker system
606     // check to see if we should implement a changeColour(cs) method rather than
607     // put th logic in here
608     // - means that caller decides if they want to just modify state and defer
609     // calculation till later or to do all calculations in thread.
610     // via changecolour
611     globalColourScheme = cs;
612     boolean recalc = false;
613     if (cs != null)
614     {
615       cs.setConservationApplied(recalc = getConservationSelected());
616       if (getAbovePIDThreshold() || cs instanceof PIDColourScheme
617               || cs instanceof Blosum62ColourScheme)
618       {
619         recalc = true;
620         cs.setThreshold(viewStyle.getThreshold(),
621                 ignoreGapsInConsensusCalculation);
622       }
623       else
624       {
625         cs.setThreshold(0, ignoreGapsInConsensusCalculation);
626       }
627       if (recalc)
628       {
629         cs.setConsensus(hconsensus);
630         cs.setConservation(hconservation);
631       }
632       cs.alignmentChanged(alignment, hiddenRepSequences);
633     }
634     if (getColourAppliesToAllGroups())
635     {
636       for (SequenceGroup sg : getAlignment().getGroups())
637       {
638         if (cs == null)
639         {
640           sg.cs = null;
641           continue;
642         }
643         sg.cs = cs.applyTo(sg, getHiddenRepSequences());
644         sg.setConsPercGaps(ConsPercGaps);
645         if (getAbovePIDThreshold() || cs instanceof PIDColourScheme
646                 || cs instanceof Blosum62ColourScheme)
647         {
648           sg.cs.setThreshold(viewStyle.getThreshold(),
649                   isIgnoreGapsConsensus());
650           recalc = true;
651         }
652         else
653         {
654           sg.cs.setThreshold(0, isIgnoreGapsConsensus());
655         }
656
657         if (getConservationSelected())
658         {
659           sg.cs.setConservationApplied(true);
660           recalc = true;
661         }
662         else
663         {
664           sg.cs.setConservation(null);
665           // sg.cs.setThreshold(0, getIgnoreGapsConsensus());
666         }
667         if (recalc)
668         {
669           sg.recalcConservation();
670         }
671         else
672         {
673           sg.cs.alignmentChanged(sg, hiddenRepSequences);
674         }
675       }
676     }
677   }
678
679   @Override
680   public ColourSchemeI getGlobalColourScheme()
681   {
682     return globalColourScheme;
683   }
684
685   protected AlignmentAnnotation consensus;
686
687   protected AlignmentAnnotation complementConsensus;
688
689   protected AlignmentAnnotation strucConsensus;
690
691   protected AlignmentAnnotation conservation;
692
693   protected AlignmentAnnotation quality;
694
695   protected AlignmentAnnotation[] groupConsensus;
696
697   protected AlignmentAnnotation[] groupConservation;
698
699   /**
700    * results of alignment consensus analysis for visible portion of view
701    */
702   protected Hashtable[] hconsensus = null;
703
704   /**
705    * results of cDNA complement consensus visible portion of view
706    */
707   protected Hashtable[] hcomplementConsensus = null;
708
709   /**
710    * results of secondary structure base pair consensus for visible portion of
711    * view
712    */
713   protected Hashtable[] hStrucConsensus = null;
714
715   protected Conservation hconservation = null;
716
717   @Override
718   public void setConservation(Conservation cons)
719   {
720     hconservation = cons;
721   }
722
723   /**
724    * percentage gaps allowed in a column before all amino acid properties should
725    * be considered unconserved
726    */
727   int ConsPercGaps = 25; // JBPNote : This should be a scalable property!
728
729   @Override
730   public int getConsPercGaps()
731   {
732     return ConsPercGaps;
733   }
734
735   @Override
736   public void setSequenceConsensusHash(Hashtable[] hconsensus)
737   {
738     this.hconsensus = hconsensus;
739   }
740
741   @Override
742   public void setComplementConsensusHash(Hashtable[] hconsensus)
743   {
744     this.hcomplementConsensus = hconsensus;
745   }
746
747   @Override
748   public Hashtable[] getSequenceConsensusHash()
749   {
750     return hconsensus;
751   }
752
753   @Override
754   public Hashtable[] getComplementConsensusHash()
755   {
756     return hcomplementConsensus;
757   }
758
759   @Override
760   public Hashtable[] getRnaStructureConsensusHash()
761   {
762     return hStrucConsensus;
763   }
764
765   @Override
766   public void setRnaStructureConsensusHash(Hashtable[] hStrucConsensus)
767   {
768     this.hStrucConsensus = hStrucConsensus;
769
770   }
771
772   @Override
773   public AlignmentAnnotation getAlignmentQualityAnnot()
774   {
775     return quality;
776   }
777
778   @Override
779   public AlignmentAnnotation getAlignmentConservationAnnotation()
780   {
781     return conservation;
782   }
783
784   @Override
785   public AlignmentAnnotation getAlignmentConsensusAnnotation()
786   {
787     return consensus;
788   }
789
790   @Override
791   public AlignmentAnnotation getComplementConsensusAnnotation()
792   {
793     return complementConsensus;
794   }
795
796   @Override
797   public AlignmentAnnotation getAlignmentStrucConsensusAnnotation()
798   {
799     return strucConsensus;
800   }
801
802   protected AlignCalcManagerI calculator = new AlignCalcManager();
803
804   /**
805    * trigger update of conservation annotation
806    */
807   public void updateConservation(final AlignmentViewPanel ap)
808   {
809     // see note in mantis : issue number 8585
810     if (alignment.isNucleotide() || conservation == null
811             || !autoCalculateConsensus)
812     {
813       return;
814     }
815     if (calculator
816             .getRegisteredWorkersOfClass(jalview.workers.ConservationThread.class) == null)
817     {
818       calculator.registerWorker(new jalview.workers.ConservationThread(
819               this, ap));
820     }
821   }
822
823   /**
824    * trigger update of consensus annotation
825    */
826   public void updateConsensus(final AlignmentViewPanel ap)
827   {
828     // see note in mantis : issue number 8585
829     if (consensus == null || !autoCalculateConsensus)
830     {
831       return;
832     }
833     if (calculator.getRegisteredWorkersOfClass(ConsensusThread.class) == null)
834     {
835       calculator.registerWorker(new ConsensusThread(this, ap));
836     }
837
838     /*
839      * A separate thread to compute cDNA consensus for a protein alignment
840      * which has mapping to cDNA
841      */
842     final AlignmentI al = this.getAlignment();
843     if (!al.isNucleotide() && al.getCodonFrames() != null
844             && !al.getCodonFrames().isEmpty())
845     {
846       /*
847        * fudge - check first mapping is protein-to-nucleotide
848        * (we don't want to do this for protein-to-protein)
849        */
850       AlignedCodonFrame mapping = al.getCodonFrames().iterator().next();
851       // TODO hold mapping type e.g. dna-to-protein in AlignedCodonFrame?
852       MapList[] mapLists = mapping.getdnaToProt();
853       // mapLists can be empty if project load has not finished resolving seqs
854       if (mapLists.length > 0 && mapLists[0].getFromRatio() == 3)
855       {
856         if (calculator
857                 .getRegisteredWorkersOfClass(ComplementConsensusThread.class) == null)
858         {
859           calculator
860                   .registerWorker(new ComplementConsensusThread(this, ap));
861         }
862       }
863     }
864   }
865
866   // --------START Structure Conservation
867   public void updateStrucConsensus(final AlignmentViewPanel ap)
868   {
869     if (autoCalculateStrucConsensus && strucConsensus == null
870             && alignment.isNucleotide() && alignment.hasRNAStructure())
871     {
872       // secondary structure has been added - so init the consensus line
873       initRNAStructure();
874     }
875
876     // see note in mantis : issue number 8585
877     if (strucConsensus == null || !autoCalculateStrucConsensus)
878     {
879       return;
880     }
881     if (calculator.getRegisteredWorkersOfClass(StrucConsensusThread.class) == null)
882     {
883       calculator.registerWorker(new StrucConsensusThread(this, ap));
884     }
885   }
886
887   public boolean isCalcInProgress()
888   {
889     return calculator.isWorking();
890   }
891
892   @Override
893   public boolean isCalculationInProgress(
894           AlignmentAnnotation alignmentAnnotation)
895   {
896     if (!alignmentAnnotation.autoCalculated)
897     {
898       return false;
899     }
900     if (calculator.workingInvolvedWith(alignmentAnnotation))
901     {
902       // System.err.println("grey out ("+alignmentAnnotation.label+")");
903       return true;
904     }
905     return false;
906   }
907
908   @Override
909   public boolean isClosed()
910   {
911     // TODO: check that this isClosed is only true after panel is closed, not
912     // before it is fully constructed.
913     return alignment == null;
914   }
915
916   @Override
917   public AlignCalcManagerI getCalcManager()
918   {
919     return calculator;
920   }
921
922   /**
923    * should conservation rows be shown for groups
924    */
925   protected boolean showGroupConservation = false;
926
927   /**
928    * should consensus rows be shown for groups
929    */
930   protected boolean showGroupConsensus = false;
931
932   /**
933    * should consensus profile be rendered by default
934    */
935   protected boolean showSequenceLogo = false;
936
937   /**
938    * should consensus profile be rendered normalised to row height
939    */
940   protected boolean normaliseSequenceLogo = false;
941
942   /**
943    * should consensus histograms be rendered by default
944    */
945   protected boolean showConsensusHistogram = true;
946
947   /**
948    * @return the showConsensusProfile
949    */
950   @Override
951   public boolean isShowSequenceLogo()
952   {
953     return showSequenceLogo;
954   }
955
956   /**
957    * @param showSequenceLogo
958    *          the new value
959    */
960   public void setShowSequenceLogo(boolean showSequenceLogo)
961   {
962     if (showSequenceLogo != this.showSequenceLogo)
963     {
964       // TODO: decouple settings setting from calculation when refactoring
965       // annotation update method from alignframe to viewport
966       this.showSequenceLogo = showSequenceLogo;
967       calculator.updateAnnotationFor(ConsensusThread.class);
968       calculator.updateAnnotationFor(ComplementConsensusThread.class);
969       calculator.updateAnnotationFor(StrucConsensusThread.class);
970     }
971     this.showSequenceLogo = showSequenceLogo;
972   }
973
974   /**
975    * @param showConsensusHistogram
976    *          the showConsensusHistogram to set
977    */
978   public void setShowConsensusHistogram(boolean showConsensusHistogram)
979   {
980     this.showConsensusHistogram = showConsensusHistogram;
981   }
982
983   /**
984    * @return the showGroupConservation
985    */
986   public boolean isShowGroupConservation()
987   {
988     return showGroupConservation;
989   }
990
991   /**
992    * @param showGroupConservation
993    *          the showGroupConservation to set
994    */
995   public void setShowGroupConservation(boolean showGroupConservation)
996   {
997     this.showGroupConservation = showGroupConservation;
998   }
999
1000   /**
1001    * @return the showGroupConsensus
1002    */
1003   public boolean isShowGroupConsensus()
1004   {
1005     return showGroupConsensus;
1006   }
1007
1008   /**
1009    * @param showGroupConsensus
1010    *          the showGroupConsensus to set
1011    */
1012   public void setShowGroupConsensus(boolean showGroupConsensus)
1013   {
1014     this.showGroupConsensus = showGroupConsensus;
1015   }
1016
1017   /**
1018    * 
1019    * @return flag to indicate if the consensus histogram should be rendered by
1020    *         default
1021    */
1022   @Override
1023   public boolean isShowConsensusHistogram()
1024   {
1025     return this.showConsensusHistogram;
1026   }
1027
1028   /**
1029    * when set, updateAlignment will always ensure sequences are of equal length
1030    */
1031   private boolean padGaps = false;
1032
1033   /**
1034    * when set, alignment should be reordered according to a newly opened tree
1035    */
1036   public boolean sortByTree = false;
1037
1038   /**
1039    * 
1040    * 
1041    * @return null or the currently selected sequence region
1042    */
1043   @Override
1044   public SequenceGroup getSelectionGroup()
1045   {
1046     return selectionGroup;
1047   }
1048
1049   /**
1050    * Set the selection group for this window.
1051    * 
1052    * @param sg
1053    *          - group holding references to sequences in this alignment view
1054    * 
1055    */
1056   @Override
1057   public void setSelectionGroup(SequenceGroup sg)
1058   {
1059     selectionGroup = sg;
1060   }
1061
1062   public void setHiddenColumns(ColumnSelection colsel)
1063   {
1064     this.colSel = colsel;
1065   }
1066
1067   @Override
1068   public ColumnSelection getColumnSelection()
1069   {
1070     return colSel;
1071   }
1072
1073   @Override
1074   public void setColumnSelection(ColumnSelection colSel)
1075   {
1076     this.colSel = colSel;
1077     if (colSel != null)
1078     {
1079       updateHiddenColumns();
1080     }
1081   }
1082
1083   /**
1084    * 
1085    * @return
1086    */
1087   @Override
1088   public Map<SequenceI, SequenceCollectionI> getHiddenRepSequences()
1089   {
1090     return hiddenRepSequences;
1091   }
1092
1093   @Override
1094   public void setHiddenRepSequences(
1095           Map<SequenceI, SequenceCollectionI> hiddenRepSequences)
1096   {
1097     this.hiddenRepSequences = hiddenRepSequences;
1098   }
1099
1100   @Override
1101   public boolean hasHiddenColumns()
1102   {
1103     return colSel != null && colSel.hasHiddenColumns();
1104   }
1105
1106   public void updateHiddenColumns()
1107   {
1108     // this method doesn't really do anything now. But - it could, since a
1109     // column Selection could be in the process of modification
1110     // hasHiddenColumns = colSel.hasHiddenColumns();
1111   }
1112
1113   @Override
1114   public boolean hasHiddenRows()
1115   {
1116     return alignment.getHiddenSequences().getSize() > 0;
1117   }
1118
1119   protected SequenceGroup selectionGroup;
1120
1121   public void setSequenceSetId(String newid)
1122   {
1123     if (sequenceSetID != null)
1124     {
1125       System.err
1126               .println("Warning - overwriting a sequenceSetId for a viewport!");
1127     }
1128     sequenceSetID = new String(newid);
1129   }
1130
1131   @Override
1132   public String getSequenceSetId()
1133   {
1134     if (sequenceSetID == null)
1135     {
1136       sequenceSetID = alignment.hashCode() + "";
1137     }
1138
1139     return sequenceSetID;
1140   }
1141
1142   /**
1143    * unique viewId for synchronizing state (e.g. with stored Jalview Project)
1144    * 
1145    */
1146   protected String viewId = null;
1147
1148   @Override
1149   public String getViewId()
1150   {
1151     if (viewId == null)
1152     {
1153       viewId = this.getSequenceSetId() + "." + this.hashCode() + "";
1154     }
1155     return viewId;
1156   }
1157
1158   public void setIgnoreGapsConsensus(boolean b, AlignmentViewPanel ap)
1159   {
1160     ignoreGapsInConsensusCalculation = b;
1161     if (ap != null)
1162     {
1163       updateConsensus(ap);
1164       if (globalColourScheme != null)
1165       {
1166         globalColourScheme.setThreshold(globalColourScheme.getThreshold(),
1167                 ignoreGapsInConsensusCalculation);
1168       }
1169     }
1170
1171   }
1172
1173   private long sgrouphash = -1, colselhash = -1;
1174
1175   /**
1176    * checks current SelectionGroup against record of last hash value, and
1177    * updates record.
1178    * 
1179    * @param b
1180    *          update the record of last hash value
1181    * 
1182    * @return true if SelectionGroup changed since last call (when b is true)
1183    */
1184   public boolean isSelectionGroupChanged(boolean b)
1185   {
1186     int hc = (selectionGroup == null || selectionGroup.getSize() == 0) ? -1
1187             : selectionGroup.hashCode();
1188     if (hc != -1 && hc != sgrouphash)
1189     {
1190       if (b)
1191       {
1192         sgrouphash = hc;
1193       }
1194       return true;
1195     }
1196     return false;
1197   }
1198
1199   /**
1200    * checks current colsel against record of last hash value, and optionally
1201    * updates record.
1202    * 
1203    * @param b
1204    *          update the record of last hash value
1205    * @return true if colsel changed since last call (when b is true)
1206    */
1207   public boolean isColSelChanged(boolean b)
1208   {
1209     int hc = (colSel == null || colSel.isEmpty()) ? -1 : colSel
1210             .hashCode();
1211     if (hc != -1 && hc != colselhash)
1212     {
1213       if (b)
1214       {
1215         colselhash = hc;
1216       }
1217       return true;
1218     }
1219     return false;
1220   }
1221
1222   @Override
1223   public boolean isIgnoreGapsConsensus()
1224   {
1225     return ignoreGapsInConsensusCalculation;
1226   }
1227
1228   // / property change stuff
1229
1230   // JBPNote Prolly only need this in the applet version.
1231   private final java.beans.PropertyChangeSupport changeSupport = new java.beans.PropertyChangeSupport(
1232           this);
1233
1234   protected boolean showConservation = true;
1235
1236   protected boolean showQuality = true;
1237
1238   protected boolean showConsensus = true;
1239
1240   private Map<SequenceI, Color> sequenceColours = new HashMap<SequenceI, Color>();
1241
1242   protected SequenceAnnotationOrder sortAnnotationsBy = null;
1243
1244   protected boolean showAutocalculatedAbove;
1245
1246   /**
1247    * when set, view will scroll to show the highlighted position
1248    */
1249   private boolean followHighlight = true;
1250
1251   // TODO private with getters and setters?
1252   public int startRes;
1253
1254   public int endRes;
1255
1256   public int startSeq;
1257
1258   public int endSeq;
1259
1260   /**
1261    * Property change listener for changes in alignment
1262    * 
1263    * @param listener
1264    *          DOCUMENT ME!
1265    */
1266   public void addPropertyChangeListener(
1267           java.beans.PropertyChangeListener listener)
1268   {
1269     changeSupport.addPropertyChangeListener(listener);
1270   }
1271
1272   /**
1273    * DOCUMENT ME!
1274    * 
1275    * @param listener
1276    *          DOCUMENT ME!
1277    */
1278   public void removePropertyChangeListener(
1279           java.beans.PropertyChangeListener listener)
1280   {
1281     changeSupport.removePropertyChangeListener(listener);
1282   }
1283
1284   /**
1285    * Property change listener for changes in alignment
1286    * 
1287    * @param prop
1288    *          DOCUMENT ME!
1289    * @param oldvalue
1290    *          DOCUMENT ME!
1291    * @param newvalue
1292    *          DOCUMENT ME!
1293    */
1294   public void firePropertyChange(String prop, Object oldvalue,
1295           Object newvalue)
1296   {
1297     changeSupport.firePropertyChange(prop, oldvalue, newvalue);
1298   }
1299
1300   // common hide/show column stuff
1301
1302   public void hideSelectedColumns()
1303   {
1304     if (colSel.isEmpty())
1305     {
1306       return;
1307     }
1308
1309     colSel.hideSelectedColumns();
1310     setSelectionGroup(null);
1311
1312   }
1313
1314   public void hideColumns(int start, int end)
1315   {
1316     if (start == end)
1317     {
1318       colSel.hideColumns(start);
1319     }
1320     else
1321     {
1322       colSel.hideColumns(start, end);
1323     }
1324   }
1325
1326   public void showColumn(int col)
1327   {
1328     colSel.revealHiddenColumns(col);
1329
1330   }
1331
1332   public void showAllHiddenColumns()
1333   {
1334     colSel.revealAllHiddenColumns();
1335   }
1336
1337   // common hide/show seq stuff
1338   public void showAllHiddenSeqs()
1339   {
1340     if (alignment.getHiddenSequences().getSize() > 0)
1341     {
1342       if (selectionGroup == null)
1343       {
1344         selectionGroup = new SequenceGroup();
1345         selectionGroup.setEndRes(alignment.getWidth() - 1);
1346       }
1347       List<SequenceI> tmp = alignment.getHiddenSequences().showAll(
1348               hiddenRepSequences);
1349       for (SequenceI seq : tmp)
1350       {
1351         selectionGroup.addSequence(seq, false);
1352         setSequenceAnnotationsVisible(seq, true);
1353       }
1354
1355       hiddenRepSequences = null;
1356
1357       firePropertyChange("alignment", null, alignment.getSequences());
1358       // used to set hasHiddenRows/hiddenRepSequences here, after the property
1359       // changed event
1360       sendSelection();
1361     }
1362   }
1363
1364   public void showSequence(int index)
1365   {
1366     List<SequenceI> tmp = alignment.getHiddenSequences().showSequence(
1367             index, hiddenRepSequences);
1368     if (tmp.size() > 0)
1369     {
1370       if (selectionGroup == null)
1371       {
1372         selectionGroup = new SequenceGroup();
1373         selectionGroup.setEndRes(alignment.getWidth() - 1);
1374       }
1375
1376       for (SequenceI seq : tmp)
1377       {
1378         selectionGroup.addSequence(seq, false);
1379         setSequenceAnnotationsVisible(seq, true);
1380       }
1381       firePropertyChange("alignment", null, alignment.getSequences());
1382       sendSelection();
1383     }
1384   }
1385
1386   public void hideAllSelectedSeqs()
1387   {
1388     if (selectionGroup == null || selectionGroup.getSize() < 1)
1389     {
1390       return;
1391     }
1392
1393     SequenceI[] seqs = selectionGroup.getSequencesInOrder(alignment);
1394
1395     hideSequence(seqs);
1396
1397     setSelectionGroup(null);
1398   }
1399
1400   public void hideSequence(SequenceI[] seq)
1401   {
1402     if (seq != null)
1403     {
1404       for (int i = 0; i < seq.length; i++)
1405       {
1406         alignment.getHiddenSequences().hideSequence(seq[i]);
1407         setSequenceAnnotationsVisible(seq[i], false);
1408       }
1409       firePropertyChange("alignment", null, alignment.getSequences());
1410     }
1411   }
1412
1413   /**
1414    * Set visibility for any annotations for the given sequence.
1415    * 
1416    * @param sequenceI
1417    */
1418   protected void setSequenceAnnotationsVisible(SequenceI sequenceI,
1419           boolean visible)
1420   {
1421     for (AlignmentAnnotation ann : alignment.getAlignmentAnnotation())
1422     {
1423       if (ann.sequenceRef == sequenceI)
1424       {
1425         ann.visible = visible;
1426       }
1427     }
1428   }
1429
1430   public void hideRepSequences(SequenceI repSequence, SequenceGroup sg)
1431   {
1432     int sSize = sg.getSize();
1433     if (sSize < 2)
1434     {
1435       return;
1436     }
1437
1438     if (hiddenRepSequences == null)
1439     {
1440       hiddenRepSequences = new Hashtable<SequenceI, SequenceCollectionI>();
1441     }
1442
1443     hiddenRepSequences.put(repSequence, sg);
1444
1445     // Hide all sequences except the repSequence
1446     SequenceI[] seqs = new SequenceI[sSize - 1];
1447     int index = 0;
1448     for (int i = 0; i < sSize; i++)
1449     {
1450       if (sg.getSequenceAt(i) != repSequence)
1451       {
1452         if (index == sSize - 1)
1453         {
1454           return;
1455         }
1456
1457         seqs[index++] = sg.getSequenceAt(i);
1458       }
1459     }
1460     sg.setSeqrep(repSequence); // note: not done in 2.7applet
1461     sg.setHidereps(true); // note: not done in 2.7applet
1462     hideSequence(seqs);
1463
1464   }
1465
1466   public boolean isHiddenRepSequence(SequenceI seq)
1467   {
1468     return alignment.getSeqrep() == seq
1469             || (hiddenRepSequences != null && hiddenRepSequences
1470                     .containsKey(seq));
1471   }
1472
1473   public SequenceGroup getRepresentedSequences(SequenceI seq)
1474   {
1475     return (SequenceGroup) (hiddenRepSequences == null ? null
1476             : hiddenRepSequences.get(seq));
1477   }
1478
1479   @Override
1480   public int adjustForHiddenSeqs(int alignmentIndex)
1481   {
1482     return alignment.getHiddenSequences().adjustForHiddenSeqs(
1483             alignmentIndex);
1484   }
1485
1486   @Override
1487   public void invertColumnSelection()
1488   {
1489     colSel.invertColumnSelection(0, alignment.getWidth());
1490   }
1491
1492   @Override
1493   public SequenceI[] getSelectionAsNewSequence()
1494   {
1495     SequenceI[] sequences;
1496     // JBPNote: Need to test jalviewLite.getSelectedSequencesAsAlignmentFrom -
1497     // this was the only caller in the applet for this method
1498     // JBPNote: in applet, this method returned references to the alignment
1499     // sequences, and it did not honour the presence/absence of annotation
1500     // attached to the alignment (probably!)
1501     if (selectionGroup == null || selectionGroup.getSize() == 0)
1502     {
1503       sequences = alignment.getSequencesArray();
1504       AlignmentAnnotation[] annots = alignment.getAlignmentAnnotation();
1505       for (int i = 0; i < sequences.length; i++)
1506       {
1507         // construct new sequence with subset of visible annotation
1508         sequences[i] = new Sequence(sequences[i], annots);
1509       }
1510     }
1511     else
1512     {
1513       sequences = selectionGroup.getSelectionAsNewSequences(alignment);
1514     }
1515
1516     return sequences;
1517   }
1518
1519   @Override
1520   public SequenceI[] getSequenceSelection()
1521   {
1522     SequenceI[] sequences = null;
1523     if (selectionGroup != null)
1524     {
1525       sequences = selectionGroup.getSequencesInOrder(alignment);
1526     }
1527     if (sequences == null)
1528     {
1529       sequences = alignment.getSequencesArray();
1530     }
1531     return sequences;
1532   }
1533
1534   @Override
1535   public CigarArray getViewAsCigars(boolean selectedRegionOnly)
1536   {
1537     return new CigarArray(alignment, colSel,
1538             (selectedRegionOnly ? selectionGroup : null));
1539   }
1540
1541   @Override
1542   public jalview.datamodel.AlignmentView getAlignmentView(
1543           boolean selectedOnly)
1544   {
1545     return getAlignmentView(selectedOnly, false);
1546   }
1547
1548   @Override
1549   public jalview.datamodel.AlignmentView getAlignmentView(
1550           boolean selectedOnly, boolean markGroups)
1551   {
1552     return new AlignmentView(alignment, colSel, selectionGroup,
1553             colSel != null && colSel.hasHiddenColumns(), selectedOnly,
1554             markGroups);
1555   }
1556
1557   @Override
1558   public String[] getViewAsString(boolean selectedRegionOnly)
1559   {
1560     String[] selection = null;
1561     SequenceI[] seqs = null;
1562     int i, iSize;
1563     int start = 0, end = 0;
1564     if (selectedRegionOnly && selectionGroup != null)
1565     {
1566       iSize = selectionGroup.getSize();
1567       seqs = selectionGroup.getSequencesInOrder(alignment);
1568       start = selectionGroup.getStartRes();
1569       end = selectionGroup.getEndRes() + 1;
1570     }
1571     else
1572     {
1573       if (hasHiddenRows())
1574       {
1575         iSize = alignment.getHiddenSequences().getFullAlignment()
1576                 .getHeight();
1577         seqs = alignment.getHiddenSequences().getFullAlignment()
1578                 .getSequencesArray();
1579         end = alignment.getHiddenSequences().getFullAlignment().getWidth();
1580       }
1581       else
1582       {
1583         iSize = alignment.getHeight();
1584         seqs = alignment.getSequencesArray();
1585         end = alignment.getWidth();
1586       }
1587     }
1588
1589     selection = new String[iSize];
1590     if (colSel != null && colSel.hasHiddenColumns())
1591     {
1592       selection = colSel.getVisibleSequenceStrings(start, end, seqs);
1593     }
1594     else
1595     {
1596       for (i = 0; i < iSize; i++)
1597       {
1598         selection[i] = seqs[i].getSequenceAsString(start, end);
1599       }
1600
1601     }
1602     return selection;
1603   }
1604
1605   @Override
1606   public List<int[]> getVisibleRegionBoundaries(int min, int max)
1607   {
1608     ArrayList<int[]> regions = new ArrayList<int[]>();
1609     int start = min;
1610     int end = max;
1611
1612     do
1613     {
1614       if (colSel != null && colSel.hasHiddenColumns())
1615       {
1616         if (start == 0)
1617         {
1618           start = colSel.adjustForHiddenColumns(start);
1619         }
1620
1621         end = colSel.getHiddenBoundaryRight(start);
1622         if (start == end)
1623         {
1624           end = max;
1625         }
1626         if (end > max)
1627         {
1628           end = max;
1629         }
1630       }
1631
1632       regions.add(new int[] { start, end });
1633
1634       if (colSel != null && colSel.hasHiddenColumns())
1635       {
1636         start = colSel.adjustForHiddenColumns(end);
1637         start = colSel.getHiddenBoundaryLeft(start) + 1;
1638       }
1639     } while (end < max);
1640
1641     int[][] startEnd = new int[regions.size()][2];
1642
1643     return regions;
1644   }
1645
1646   @Override
1647   public List<AlignmentAnnotation> getVisibleAlignmentAnnotation(
1648           boolean selectedOnly)
1649   {
1650     ArrayList<AlignmentAnnotation> ala = new ArrayList<AlignmentAnnotation>();
1651     AlignmentAnnotation[] aa;
1652     if ((aa = alignment.getAlignmentAnnotation()) != null)
1653     {
1654       for (AlignmentAnnotation annot : aa)
1655       {
1656         AlignmentAnnotation clone = new AlignmentAnnotation(annot);
1657         if (selectedOnly && selectionGroup != null)
1658         {
1659           colSel.makeVisibleAnnotation(selectionGroup.getStartRes(),
1660                   selectionGroup.getEndRes(), clone);
1661         }
1662         else
1663         {
1664           colSel.makeVisibleAnnotation(clone);
1665         }
1666         ala.add(clone);
1667       }
1668     }
1669     return ala;
1670   }
1671
1672   @Override
1673   public boolean isPadGaps()
1674   {
1675     return padGaps;
1676   }
1677
1678   @Override
1679   public void setPadGaps(boolean padGaps)
1680   {
1681     this.padGaps = padGaps;
1682   }
1683
1684   /**
1685    * apply any post-edit constraints and trigger any calculations needed after
1686    * an edit has been performed on the alignment
1687    * 
1688    * @param ap
1689    */
1690   @Override
1691   public void alignmentChanged(AlignmentViewPanel ap)
1692   {
1693     if (isPadGaps())
1694     {
1695       alignment.padGaps();
1696     }
1697     if (autoCalculateConsensus)
1698     {
1699       updateConsensus(ap);
1700     }
1701     if (hconsensus != null && autoCalculateConsensus)
1702     {
1703       updateConservation(ap);
1704     }
1705     if (autoCalculateStrucConsensus)
1706     {
1707       updateStrucConsensus(ap);
1708     }
1709
1710     // Reset endRes of groups if beyond alignment width
1711     int alWidth = alignment.getWidth();
1712     List<SequenceGroup> groups = alignment.getGroups();
1713     if (groups != null)
1714     {
1715       for (SequenceGroup sg : groups)
1716       {
1717         if (sg.getEndRes() > alWidth)
1718         {
1719           sg.setEndRes(alWidth - 1);
1720         }
1721       }
1722     }
1723
1724     if (selectionGroup != null && selectionGroup.getEndRes() > alWidth)
1725     {
1726       selectionGroup.setEndRes(alWidth - 1);
1727     }
1728
1729     resetAllColourSchemes();
1730     calculator.restartWorkers();
1731     // alignment.adjustSequenceAnnotations();
1732   }
1733
1734   /**
1735    * reset scope and do calculations for all applied colourschemes on alignment
1736    */
1737   void resetAllColourSchemes()
1738   {
1739     ColourSchemeI cs = globalColourScheme;
1740     if (cs != null)
1741     {
1742       cs.alignmentChanged(alignment, hiddenRepSequences);
1743
1744       cs.setConsensus(hconsensus);
1745       if (cs.conservationApplied())
1746       {
1747         cs.setConservation(Conservation.calculateConservation("All",
1748                 ResidueProperties.propHash, 3, alignment.getSequences(), 0,
1749                 alignment.getWidth(), false, getConsPercGaps(), false));
1750       }
1751     }
1752
1753     for (SequenceGroup sg : alignment.getGroups())
1754     {
1755       if (sg.cs != null)
1756       {
1757         sg.cs.alignmentChanged(sg, hiddenRepSequences);
1758       }
1759       sg.recalcConservation();
1760     }
1761   }
1762
1763   protected void initAutoAnnotation()
1764   {
1765     // TODO: add menu option action that nulls or creates consensus object
1766     // depending on if the user wants to see the annotation or not in a
1767     // specific alignment
1768
1769     if (hconsensus == null && !isDataset)
1770     {
1771       if (!alignment.isNucleotide())
1772       {
1773         initConservation();
1774         initQuality();
1775       }
1776       else
1777       {
1778         initRNAStructure();
1779       }
1780       consensus = new AlignmentAnnotation("Consensus", "PID",
1781               new Annotation[1], 0f, 100f, AlignmentAnnotation.BAR_GRAPH);
1782       initConsensus(consensus);
1783
1784       initComplementConsensus();
1785     }
1786   }
1787
1788   /**
1789    * If this is a protein alignment and there are mappings to cDNA, add the cDNA
1790    * consensus annotation.
1791    */
1792   public void initComplementConsensus()
1793   {
1794     if (!alignment.isNucleotide())
1795     {
1796       final List<AlignedCodonFrame> codonMappings = alignment
1797               .getCodonFrames();
1798       if (codonMappings != null && !codonMappings.isEmpty())
1799       {
1800         // fudge: check mappings are not protein-to-protein
1801         // TODO: nicer
1802         AlignedCodonFrame mapping = codonMappings.iterator().next();
1803         MapList[] mapLists = mapping.getdnaToProt();
1804         // mapLists can be empty if project load has not finished resolving seqs
1805         if (mapLists.length > 0 && mapLists[0].getFromRatio() == 3)
1806         {
1807           complementConsensus = new AlignmentAnnotation("cDNA Consensus",
1808                   "PID for cDNA", new Annotation[1], 0f, 100f,
1809                   AlignmentAnnotation.BAR_GRAPH);
1810           initConsensus(complementConsensus);
1811         }
1812       }
1813     }
1814   }
1815
1816   private void initConsensus(AlignmentAnnotation aa)
1817   {
1818     aa.hasText = true;
1819     aa.autoCalculated = true;
1820
1821     if (showConsensus)
1822     {
1823       alignment.addAnnotation(aa);
1824     }
1825   }
1826
1827   private void initConservation()
1828   {
1829     if (showConservation)
1830     {
1831       if (conservation == null)
1832       {
1833         conservation = new AlignmentAnnotation("Conservation",
1834                 "Conservation of total alignment less than "
1835                         + getConsPercGaps() + "% gaps", new Annotation[1],
1836                 0f, 11f, AlignmentAnnotation.BAR_GRAPH);
1837         conservation.hasText = true;
1838         conservation.autoCalculated = true;
1839         alignment.addAnnotation(conservation);
1840       }
1841     }
1842   }
1843
1844   private void initQuality()
1845   {
1846     if (showQuality)
1847     {
1848       if (quality == null)
1849       {
1850         quality = new AlignmentAnnotation("Quality",
1851                 "Alignment Quality based on Blosum62 scores",
1852                 new Annotation[1], 0f, 11f, AlignmentAnnotation.BAR_GRAPH);
1853         quality.hasText = true;
1854         quality.autoCalculated = true;
1855         alignment.addAnnotation(quality);
1856       }
1857     }
1858   }
1859
1860   private void initRNAStructure()
1861   {
1862     if (alignment.hasRNAStructure() && strucConsensus == null)
1863     {
1864       strucConsensus = new AlignmentAnnotation("StrucConsensus", "PID",
1865               new Annotation[1], 0f, 100f, AlignmentAnnotation.BAR_GRAPH);
1866       strucConsensus.hasText = true;
1867       strucConsensus.autoCalculated = true;
1868
1869       if (showConsensus)
1870       {
1871         alignment.addAnnotation(strucConsensus);
1872       }
1873     }
1874   }
1875
1876   /*
1877    * (non-Javadoc)
1878    * 
1879    * @see jalview.api.AlignViewportI#calcPanelHeight()
1880    */
1881   @Override
1882   public int calcPanelHeight()
1883   {
1884     // setHeight of panels
1885     AlignmentAnnotation[] anns = getAlignment().getAlignmentAnnotation();
1886     int height = 0;
1887     int charHeight = getCharHeight();
1888     if (anns != null)
1889     {
1890       BitSet graphgrp = new BitSet();
1891       for (AlignmentAnnotation aa : anns)
1892       {
1893         if (aa == null)
1894         {
1895           System.err.println("Null annotation row: ignoring.");
1896           continue;
1897         }
1898         if (!aa.visible)
1899         {
1900           continue;
1901         }
1902         if (aa.graphGroup > -1)
1903         {
1904           if (graphgrp.get(aa.graphGroup))
1905           {
1906             continue;
1907           }
1908           else
1909           {
1910             graphgrp.set(aa.graphGroup);
1911           }
1912         }
1913         aa.height = 0;
1914
1915         if (aa.hasText)
1916         {
1917           aa.height += charHeight;
1918         }
1919
1920         if (aa.hasIcons)
1921         {
1922           aa.height += 16;
1923         }
1924
1925         if (aa.graph > 0)
1926         {
1927           aa.height += aa.graphHeight;
1928         }
1929
1930         if (aa.height == 0)
1931         {
1932           aa.height = 20;
1933         }
1934
1935         height += aa.height;
1936       }
1937     }
1938     if (height == 0)
1939     {
1940       // set minimum
1941       height = 20;
1942     }
1943     return height;
1944   }
1945
1946   @Override
1947   public void updateGroupAnnotationSettings(boolean applyGlobalSettings,
1948           boolean preserveNewGroupSettings)
1949   {
1950     boolean updateCalcs = false;
1951     boolean conv = isShowGroupConservation();
1952     boolean cons = isShowGroupConsensus();
1953     boolean showprf = isShowSequenceLogo();
1954     boolean showConsHist = isShowConsensusHistogram();
1955     boolean normLogo = isNormaliseSequenceLogo();
1956
1957     /**
1958      * TODO reorder the annotation rows according to group/sequence ordering on
1959      * alignment
1960      */
1961     boolean sortg = true;
1962
1963     // remove old automatic annotation
1964     // add any new annotation
1965
1966     // intersect alignment annotation with alignment groups
1967
1968     AlignmentAnnotation[] aan = alignment.getAlignmentAnnotation();
1969     List<SequenceGroup> oldrfs = new ArrayList<SequenceGroup>();
1970     if (aan != null)
1971     {
1972       for (int an = 0; an < aan.length; an++)
1973       {
1974         if (aan[an].autoCalculated && aan[an].groupRef != null)
1975         {
1976           oldrfs.add(aan[an].groupRef);
1977           alignment.deleteAnnotation(aan[an], false);
1978         }
1979       }
1980     }
1981     if (alignment.getGroups() != null)
1982     {
1983       for (SequenceGroup sg : alignment.getGroups())
1984       {
1985         updateCalcs = false;
1986         if (applyGlobalSettings
1987                 || (!preserveNewGroupSettings && !oldrfs.contains(sg)))
1988         {
1989           // set defaults for this group's conservation/consensus
1990           sg.setshowSequenceLogo(showprf);
1991           sg.setShowConsensusHistogram(showConsHist);
1992           sg.setNormaliseSequenceLogo(normLogo);
1993         }
1994         if (conv)
1995         {
1996           updateCalcs = true;
1997           alignment.addAnnotation(sg.getConservationRow(), 0);
1998         }
1999         if (cons)
2000         {
2001           updateCalcs = true;
2002           alignment.addAnnotation(sg.getConsensus(), 0);
2003         }
2004         // refresh the annotation rows
2005         if (updateCalcs)
2006         {
2007           sg.recalcConservation();
2008         }
2009       }
2010     }
2011     oldrfs.clear();
2012   }
2013
2014   @Override
2015   public boolean isDisplayReferenceSeq()
2016   {
2017     return alignment.hasSeqrep() && viewStyle.isDisplayReferenceSeq();
2018   }
2019
2020   @Override
2021   public void setDisplayReferenceSeq(boolean displayReferenceSeq)
2022   {
2023     viewStyle.setDisplayReferenceSeq(displayReferenceSeq);
2024   }
2025
2026   @Override
2027   public boolean isColourByReferenceSeq()
2028   {
2029     return alignment.hasSeqrep() && viewStyle.isColourByReferenceSeq();
2030   }
2031
2032   @Override
2033   public Color getSequenceColour(SequenceI seq)
2034   {
2035     Color sqc = sequenceColours.get(seq);
2036     return (sqc == null ? Color.white : sqc);
2037   }
2038
2039   @Override
2040   public void setSequenceColour(SequenceI seq, Color col)
2041   {
2042     if (col == null)
2043     {
2044       sequenceColours.remove(seq);
2045     }
2046     else
2047     {
2048       sequenceColours.put(seq, col);
2049     }
2050   }
2051
2052   @Override
2053   public void updateSequenceIdColours()
2054   {
2055     for (SequenceGroup sg : alignment.getGroups())
2056     {
2057       if (sg.idColour != null)
2058       {
2059         for (SequenceI s : sg.getSequences(getHiddenRepSequences()))
2060         {
2061           sequenceColours.put(s, sg.idColour);
2062         }
2063       }
2064     }
2065   }
2066
2067   @Override
2068   public void clearSequenceColours()
2069   {
2070     sequenceColours.clear();
2071   };
2072
2073   @Override
2074   public AlignViewportI getCodingComplement()
2075   {
2076     return this.codingComplement;
2077   }
2078
2079   /**
2080    * Set this as the (cDna/protein) complement of the given viewport. Also
2081    * ensures the reverse relationship is set on the given viewport.
2082    */
2083   @Override
2084   public void setCodingComplement(AlignViewportI av)
2085   {
2086     if (this == av)
2087     {
2088       System.err.println("Ignoring recursive setCodingComplement request");
2089     }
2090     else
2091     {
2092       this.codingComplement = av;
2093       // avoid infinite recursion!
2094       if (av.getCodingComplement() != this)
2095       {
2096         av.setCodingComplement(this);
2097       }
2098     }
2099   }
2100
2101   @Override
2102   public boolean isNucleotide()
2103   {
2104     return getAlignment() == null ? false : getAlignment().isNucleotide();
2105   }
2106
2107   @Override
2108   public FeaturesDisplayedI getFeaturesDisplayed()
2109   {
2110     return featuresDisplayed;
2111   }
2112
2113   @Override
2114   public void setFeaturesDisplayed(FeaturesDisplayedI featuresDisplayedI)
2115   {
2116     featuresDisplayed = featuresDisplayedI;
2117   }
2118
2119   @Override
2120   public boolean areFeaturesDisplayed()
2121   {
2122     return featuresDisplayed != null
2123             && featuresDisplayed.getRegisteredFeaturesCount() > 0;
2124   }
2125
2126   /**
2127    * set the flag
2128    * 
2129    * @param b
2130    *          features are displayed if true
2131    */
2132   @Override
2133   public void setShowSequenceFeatures(boolean b)
2134   {
2135     viewStyle.setShowSequenceFeatures(b);
2136   }
2137
2138   @Override
2139   public boolean isShowSequenceFeatures()
2140   {
2141     return viewStyle.isShowSequenceFeatures();
2142   }
2143
2144   @Override
2145   public void setShowSequenceFeaturesHeight(boolean selected)
2146   {
2147     viewStyle.setShowSequenceFeaturesHeight(selected);
2148   }
2149
2150   @Override
2151   public boolean isShowSequenceFeaturesHeight()
2152   {
2153     return viewStyle.isShowSequenceFeaturesHeight();
2154   }
2155
2156   @Override
2157   public void setShowAnnotation(boolean b)
2158   {
2159     viewStyle.setShowAnnotation(b);
2160   }
2161
2162   @Override
2163   public boolean isShowAnnotation()
2164   {
2165     return viewStyle.isShowAnnotation();
2166   }
2167
2168   @Override
2169   public boolean isRightAlignIds()
2170   {
2171     return viewStyle.isRightAlignIds();
2172   }
2173
2174   @Override
2175   public void setRightAlignIds(boolean rightAlignIds)
2176   {
2177     viewStyle.setRightAlignIds(rightAlignIds);
2178   }
2179
2180   @Override
2181   public boolean getConservationSelected()
2182   {
2183     return viewStyle.getConservationSelected();
2184   }
2185
2186   @Override
2187   public void setShowBoxes(boolean state)
2188   {
2189     viewStyle.setShowBoxes(state);
2190   }
2191
2192   /**
2193    * @return
2194    * @see jalview.api.ViewStyleI#getTextColour()
2195    */
2196   @Override
2197   public Color getTextColour()
2198   {
2199     return viewStyle.getTextColour();
2200   }
2201
2202   /**
2203    * @return
2204    * @see jalview.api.ViewStyleI#getTextColour2()
2205    */
2206   @Override
2207   public Color getTextColour2()
2208   {
2209     return viewStyle.getTextColour2();
2210   }
2211
2212   /**
2213    * @return
2214    * @see jalview.api.ViewStyleI#getThresholdTextColour()
2215    */
2216   @Override
2217   public int getThresholdTextColour()
2218   {
2219     return viewStyle.getThresholdTextColour();
2220   }
2221
2222   /**
2223    * @return
2224    * @see jalview.api.ViewStyleI#isConservationColourSelected()
2225    */
2226   @Override
2227   public boolean isConservationColourSelected()
2228   {
2229     return viewStyle.isConservationColourSelected();
2230   }
2231
2232   /**
2233    * @return
2234    * @see jalview.api.ViewStyleI#isRenderGaps()
2235    */
2236   @Override
2237   public boolean isRenderGaps()
2238   {
2239     return viewStyle.isRenderGaps();
2240   }
2241
2242   /**
2243    * @return
2244    * @see jalview.api.ViewStyleI#isShowColourText()
2245    */
2246   @Override
2247   public boolean isShowColourText()
2248   {
2249     return viewStyle.isShowColourText();
2250   }
2251
2252   /**
2253    * @param conservationColourSelected
2254    * @see jalview.api.ViewStyleI#setConservationColourSelected(boolean)
2255    */
2256   @Override
2257   public void setConservationColourSelected(
2258           boolean conservationColourSelected)
2259   {
2260     viewStyle.setConservationColourSelected(conservationColourSelected);
2261   }
2262
2263   /**
2264    * @param showColourText
2265    * @see jalview.api.ViewStyleI#setShowColourText(boolean)
2266    */
2267   @Override
2268   public void setShowColourText(boolean showColourText)
2269   {
2270     viewStyle.setShowColourText(showColourText);
2271   }
2272
2273   /**
2274    * @param textColour
2275    * @see jalview.api.ViewStyleI#setTextColour(java.awt.Color)
2276    */
2277   @Override
2278   public void setTextColour(Color textColour)
2279   {
2280     viewStyle.setTextColour(textColour);
2281   }
2282
2283   /**
2284    * @param thresholdTextColour
2285    * @see jalview.api.ViewStyleI#setThresholdTextColour(int)
2286    */
2287   @Override
2288   public void setThresholdTextColour(int thresholdTextColour)
2289   {
2290     viewStyle.setThresholdTextColour(thresholdTextColour);
2291   }
2292
2293   /**
2294    * @param textColour2
2295    * @see jalview.api.ViewStyleI#setTextColour2(java.awt.Color)
2296    */
2297   @Override
2298   public void setTextColour2(Color textColour2)
2299   {
2300     viewStyle.setTextColour2(textColour2);
2301   }
2302
2303   @Override
2304   public ViewStyleI getViewStyle()
2305   {
2306     return new ViewStyle(viewStyle);
2307   }
2308
2309   @Override
2310   public void setViewStyle(ViewStyleI settingsForView)
2311   {
2312     viewStyle = new ViewStyle(settingsForView);
2313   }
2314
2315   @Override
2316   public boolean sameStyle(ViewStyleI them)
2317   {
2318     return viewStyle.sameStyle(them);
2319   }
2320
2321   /**
2322    * @return
2323    * @see jalview.api.ViewStyleI#getIdWidth()
2324    */
2325   @Override
2326   public int getIdWidth()
2327   {
2328     return viewStyle.getIdWidth();
2329   }
2330
2331   /**
2332    * @param i
2333    * @see jalview.api.ViewStyleI#setIdWidth(int)
2334    */
2335   @Override
2336   public void setIdWidth(int i)
2337   {
2338     viewStyle.setIdWidth(i);
2339   }
2340
2341   /**
2342    * @return
2343    * @see jalview.api.ViewStyleI#isCentreColumnLabels()
2344    */
2345   @Override
2346   public boolean isCentreColumnLabels()
2347   {
2348     return viewStyle.isCentreColumnLabels();
2349   }
2350
2351   /**
2352    * @param centreColumnLabels
2353    * @see jalview.api.ViewStyleI#setCentreColumnLabels(boolean)
2354    */
2355   @Override
2356   public void setCentreColumnLabels(boolean centreColumnLabels)
2357   {
2358     viewStyle.setCentreColumnLabels(centreColumnLabels);
2359   }
2360
2361   /**
2362    * @param showdbrefs
2363    * @see jalview.api.ViewStyleI#setShowDBRefs(boolean)
2364    */
2365   @Override
2366   public void setShowDBRefs(boolean showdbrefs)
2367   {
2368     viewStyle.setShowDBRefs(showdbrefs);
2369   }
2370
2371   /**
2372    * @return
2373    * @see jalview.api.ViewStyleI#isShowDBRefs()
2374    */
2375   @Override
2376   public boolean isShowDBRefs()
2377   {
2378     return viewStyle.isShowDBRefs();
2379   }
2380
2381   /**
2382    * @return
2383    * @see jalview.api.ViewStyleI#isShowNPFeats()
2384    */
2385   @Override
2386   public boolean isShowNPFeats()
2387   {
2388     return viewStyle.isShowNPFeats();
2389   }
2390
2391   /**
2392    * @param shownpfeats
2393    * @see jalview.api.ViewStyleI#setShowNPFeats(boolean)
2394    */
2395   @Override
2396   public void setShowNPFeats(boolean shownpfeats)
2397   {
2398     viewStyle.setShowNPFeats(shownpfeats);
2399   }
2400
2401   public abstract StructureSelectionManager getStructureSelectionManager();
2402
2403   /**
2404    * Add one command to the command history list.
2405    * 
2406    * @param command
2407    */
2408   public void addToHistoryList(CommandI command)
2409   {
2410     if (this.historyList != null)
2411     {
2412       this.historyList.push(command);
2413       broadcastCommand(command, false);
2414     }
2415   }
2416
2417   protected void broadcastCommand(CommandI command, boolean undo)
2418   {
2419     getStructureSelectionManager().commandPerformed(command, undo,
2420             getVamsasSource());
2421   }
2422
2423   /**
2424    * Add one command to the command redo list.
2425    * 
2426    * @param command
2427    */
2428   public void addToRedoList(CommandI command)
2429   {
2430     if (this.redoList != null)
2431     {
2432       this.redoList.push(command);
2433     }
2434     broadcastCommand(command, true);
2435   }
2436
2437   /**
2438    * Clear the command redo list.
2439    */
2440   public void clearRedoList()
2441   {
2442     if (this.redoList != null)
2443     {
2444       this.redoList.clear();
2445     }
2446   }
2447
2448   public void setHistoryList(Deque<CommandI> list)
2449   {
2450     this.historyList = list;
2451   }
2452
2453   public Deque<CommandI> getHistoryList()
2454   {
2455     return this.historyList;
2456   }
2457
2458   public void setRedoList(Deque<CommandI> list)
2459   {
2460     this.redoList = list;
2461   }
2462
2463   public Deque<CommandI> getRedoList()
2464   {
2465     return this.redoList;
2466   }
2467
2468   @Override
2469   public VamsasSource getVamsasSource()
2470   {
2471     return this;
2472   }
2473
2474   public SequenceAnnotationOrder getSortAnnotationsBy()
2475   {
2476     return sortAnnotationsBy;
2477   }
2478
2479   public void setSortAnnotationsBy(SequenceAnnotationOrder sortAnnotationsBy)
2480   {
2481     this.sortAnnotationsBy = sortAnnotationsBy;
2482   }
2483
2484   public boolean isShowAutocalculatedAbove()
2485   {
2486     return showAutocalculatedAbove;
2487   }
2488
2489   public void setShowAutocalculatedAbove(boolean showAutocalculatedAbove)
2490   {
2491     this.showAutocalculatedAbove = showAutocalculatedAbove;
2492   }
2493
2494   @Override
2495   public boolean isScaleProteinAsCdna()
2496   {
2497     return viewStyle.isScaleProteinAsCdna();
2498   }
2499
2500   @Override
2501   public void setScaleProteinAsCdna(boolean b)
2502   {
2503     viewStyle.setScaleProteinAsCdna(b);
2504   }
2505
2506   /**
2507    * @return true if view should scroll to show the highlighted region of a
2508    *         sequence
2509    * @return
2510    */
2511   @Override
2512   public final boolean isFollowHighlight()
2513   {
2514     return followHighlight;
2515   }
2516
2517   @Override
2518   public final void setFollowHighlight(boolean b)
2519   {
2520     this.followHighlight = b;
2521   }
2522
2523   public int getStartRes()
2524   {
2525     return startRes;
2526   }
2527
2528   @Override
2529   public int getEndRes()
2530   {
2531     return endRes;
2532   }
2533
2534   public int getStartSeq()
2535   {
2536     return startSeq;
2537   }
2538
2539   public void setStartRes(int res)
2540   {
2541     this.startRes = res;
2542   }
2543
2544   public void setStartSeq(int seq)
2545   {
2546     this.startSeq = seq;
2547   }
2548
2549   public void setEndRes(int res)
2550   {
2551     if (res > alignment.getWidth() - 1)
2552     {
2553       // log.System.out.println(" Corrected res from " + res + " to maximum " +
2554       // (alignment.getWidth()-1));
2555       res = alignment.getWidth() - 1;
2556     }
2557     if (res < 0)
2558     {
2559       res = 0;
2560     }
2561     this.endRes = res;
2562   }
2563
2564   public void setEndSeq(int seq)
2565   {
2566     if (seq > alignment.getHeight())
2567     {
2568       seq = alignment.getHeight();
2569     }
2570     if (seq < 0)
2571     {
2572       seq = 0;
2573     }
2574     this.endSeq = seq;
2575   }
2576
2577   public int getEndSeq()
2578   {
2579     return endSeq;
2580   }
2581
2582   /**
2583    * Helper method to populate the SearchResults with the location in the
2584    * complementary alignment to scroll to, in order to match this one.
2585    * 
2586    * @param sr
2587    *          the SearchResults to add to
2588    * @return the offset (below top of visible region) of the matched sequence
2589    */
2590   protected int findComplementScrollTarget(SearchResults sr)
2591   {
2592     final AlignViewportI complement = getCodingComplement();
2593     if (complement == null || !complement.isFollowHighlight())
2594     {
2595       return 0;
2596     }
2597     boolean iAmProtein = !getAlignment().isNucleotide();
2598     AlignmentI proteinAlignment = iAmProtein ? getAlignment() : complement
2599             .getAlignment();
2600     if (proteinAlignment == null)
2601     {
2602       return 0;
2603     }
2604     final List<AlignedCodonFrame> mappings = proteinAlignment
2605             .getCodonFrames();
2606
2607     /*
2608      * Heuristic: find the first mapped sequence (if any) with a non-gapped
2609      * residue in the middle column of the visible region. Scroll the
2610      * complementary alignment to line up the corresponding residue.
2611      */
2612     int seqOffset = 0;
2613     SequenceI sequence = null;
2614
2615     /*
2616      * locate 'middle' column (true middle if an odd number visible, left of
2617      * middle if an even number visible)
2618      */
2619     int middleColumn = getStartRes() + (getEndRes() - getStartRes()) / 2;
2620     final HiddenSequences hiddenSequences = getAlignment()
2621             .getHiddenSequences();
2622
2623     /*
2624      * searching to the bottom of the alignment gives smoother scrolling across
2625      * all gapped visible regions
2626      */
2627     int lastSeq = alignment.getHeight() - 1;
2628     for (int seqNo = getStartSeq(); seqNo < lastSeq; seqNo++, seqOffset++)
2629     {
2630       sequence = getAlignment().getSequenceAt(seqNo);
2631       if (hiddenSequences != null && hiddenSequences.isHidden(sequence))
2632       {
2633         continue;
2634       }
2635       if (Comparison.isGap(sequence.getCharAt(middleColumn)))
2636       {
2637         continue;
2638       }
2639       List<AlignedCodonFrame> seqMappings = MappingUtils
2640               .findMappingsForSequence(sequence, mappings);
2641       if (!seqMappings.isEmpty())
2642       {
2643         break;
2644       }
2645     }
2646
2647     if (sequence == null)
2648     {
2649       /*
2650        * No ungapped mapped sequence in middle column - do nothing
2651        */
2652       return 0;
2653     }
2654     MappingUtils.addSearchResults(sr, sequence,
2655             sequence.findPosition(middleColumn), mappings);
2656     return seqOffset;
2657   }
2658 }