FileFormatI further tweaks, clean compile
[jalview.git] / src / jalview / appletgui / APopupMenu.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.appletgui;
22
23 import jalview.analysis.AAFrequency;
24 import jalview.analysis.AlignmentAnnotationUtils;
25 import jalview.analysis.AlignmentUtils;
26 import jalview.analysis.Conservation;
27 import jalview.bin.JalviewLite;
28 import jalview.commands.ChangeCaseCommand;
29 import jalview.commands.EditCommand;
30 import jalview.commands.EditCommand.Action;
31 import jalview.datamodel.AlignmentAnnotation;
32 import jalview.datamodel.AlignmentI;
33 import jalview.datamodel.DBRefEntry;
34 import jalview.datamodel.PDBEntry;
35 import jalview.datamodel.SequenceFeature;
36 import jalview.datamodel.SequenceGroup;
37 import jalview.datamodel.SequenceI;
38 import jalview.io.AppletFormatAdapter;
39 import jalview.io.DataSourceType;
40 import jalview.io.FileFormat;
41 import jalview.io.SequenceAnnotationReport;
42 import jalview.schemes.Blosum62ColourScheme;
43 import jalview.schemes.BuriedColourScheme;
44 import jalview.schemes.ClustalxColourScheme;
45 import jalview.schemes.HelixColourScheme;
46 import jalview.schemes.HydrophobicColourScheme;
47 import jalview.schemes.NucleotideColourScheme;
48 import jalview.schemes.PIDColourScheme;
49 import jalview.schemes.ResidueProperties;
50 import jalview.schemes.StrandColourScheme;
51 import jalview.schemes.TaylorColourScheme;
52 import jalview.schemes.TurnColourScheme;
53 import jalview.schemes.ZappoColourScheme;
54 import jalview.util.MessageManager;
55 import jalview.util.UrlLink;
56
57 import java.awt.CheckboxMenuItem;
58 import java.awt.Frame;
59 import java.awt.Menu;
60 import java.awt.MenuItem;
61 import java.awt.event.ActionEvent;
62 import java.awt.event.ActionListener;
63 import java.awt.event.ItemEvent;
64 import java.awt.event.ItemListener;
65 import java.util.Arrays;
66 import java.util.Collections;
67 import java.util.LinkedHashMap;
68 import java.util.List;
69 import java.util.Map;
70 import java.util.TreeMap;
71 import java.util.Vector;
72
73 public class APopupMenu extends java.awt.PopupMenu implements
74         ActionListener, ItemListener
75 {
76   Menu groupMenu = new Menu();
77
78   MenuItem editGroupName = new MenuItem();
79
80   protected MenuItem clustalColour = new MenuItem();
81
82   protected MenuItem zappoColour = new MenuItem();
83
84   protected MenuItem taylorColour = new MenuItem();
85
86   protected MenuItem hydrophobicityColour = new MenuItem();
87
88   protected MenuItem helixColour = new MenuItem();
89
90   protected MenuItem strandColour = new MenuItem();
91
92   protected MenuItem turnColour = new MenuItem();
93
94   protected MenuItem buriedColour = new MenuItem();
95
96   protected CheckboxMenuItem abovePIDColour = new CheckboxMenuItem();
97
98   protected MenuItem userDefinedColour = new MenuItem();
99
100   protected MenuItem PIDColour = new MenuItem();
101
102   protected MenuItem BLOSUM62Colour = new MenuItem();
103
104   MenuItem noColourmenuItem = new MenuItem();
105
106   protected CheckboxMenuItem conservationMenuItem = new CheckboxMenuItem();
107
108   final AlignmentPanel ap;
109
110   MenuItem unGroupMenuItem = new MenuItem();
111
112   MenuItem createGroupMenuItem = new MenuItem();
113
114   MenuItem nucleotideMenuItem = new MenuItem();
115
116   Menu colourMenu = new Menu();
117
118   CheckboxMenuItem showBoxes = new CheckboxMenuItem();
119
120   CheckboxMenuItem showText = new CheckboxMenuItem();
121
122   CheckboxMenuItem showColourText = new CheckboxMenuItem();
123
124   CheckboxMenuItem displayNonconserved = new CheckboxMenuItem();
125
126   Menu seqShowAnnotationsMenu = new Menu(
127           MessageManager.getString("label.show_annotations"));
128
129   Menu seqHideAnnotationsMenu = new Menu(
130           MessageManager.getString("label.hide_annotations"));
131
132   MenuItem seqAddReferenceAnnotations = new MenuItem(
133           MessageManager.getString("label.add_reference_annotations"));
134
135   Menu groupShowAnnotationsMenu = new Menu(
136           MessageManager.getString("label.show_annotations"));
137
138   Menu groupHideAnnotationsMenu = new Menu(
139           MessageManager.getString("label.hide_annotations"));
140
141   MenuItem groupAddReferenceAnnotations = new MenuItem(
142           MessageManager.getString("label.add_reference_annotations"));
143
144   Menu editMenu = new Menu(MessageManager.getString("action.edit"));
145
146   MenuItem copy = new MenuItem(MessageManager.getString("action.copy"));
147
148   MenuItem cut = new MenuItem(MessageManager.getString("action.cut"));
149
150   MenuItem toUpper = new MenuItem(
151           MessageManager.getString("label.to_upper_case"));
152
153   MenuItem toLower = new MenuItem(
154           MessageManager.getString("label.to_lower_case"));
155
156   MenuItem toggleCase = new MenuItem(
157           MessageManager.getString("label.toggle_case"));
158
159   Menu outputmenu = new Menu();
160
161   Menu seqMenu = new Menu();
162
163   MenuItem pdb = new MenuItem();
164
165   MenuItem hideSeqs = new MenuItem();
166
167   MenuItem repGroup = new MenuItem();
168
169   MenuItem sequenceName = new MenuItem(
170           MessageManager.getString("label.edit_name_description"));
171
172   MenuItem sequenceFeature = new MenuItem(
173           MessageManager.getString("label.create_sequence_feature"));
174
175   MenuItem editSequence = new MenuItem(
176           MessageManager.getString("label.edit_sequence"));
177
178   MenuItem sequenceDetails = new MenuItem(
179           MessageManager.getString("label.sequence_details"));
180
181   MenuItem selSeqDetails = new MenuItem(
182           MessageManager.getString("label.sequence_details"));
183
184   MenuItem makeReferenceSeq = new MenuItem();
185
186   SequenceI seq;
187
188   MenuItem revealAll = new MenuItem();
189
190   MenuItem revealSeq = new MenuItem();
191
192   /**
193    * index of sequence to be revealed
194    */
195   int revealSeq_index = -1;
196
197   Menu menu1 = new Menu();
198
199   public APopupMenu(AlignmentPanel apanel, final SequenceI seq,
200           Vector<String> links)
201   {
202     // /////////////////////////////////////////////////////////
203     // If this is activated from the sequence panel, the user may want to
204     // edit or annotate a particular residue. Therefore display the residue menu
205     //
206     // If from the IDPanel, we must display the sequence menu
207     // ////////////////////////////////////////////////////////
208
209     this.ap = apanel;
210     this.seq = seq;
211
212     try
213     {
214       jbInit();
215     } catch (Exception e)
216     {
217       e.printStackTrace();
218     }
219
220     for (String ff : FileFormat.getWritableFormats())
221     {
222       MenuItem item = new MenuItem(ff);
223
224       item.addActionListener(this);
225       outputmenu.add(item);
226     }
227
228     buildAnnotationSubmenus();
229
230     SequenceGroup sg = ap.av.getSelectionGroup();
231     if (sg != null && sg.getSize() > 0)
232     {
233       editGroupName.setLabel(MessageManager.formatMessage(
234               "label.name_param", new Object[] { sg.getName() }));
235       showText.setState(sg.getDisplayText());
236       showColourText.setState(sg.getColourText());
237       showBoxes.setState(sg.getDisplayBoxes());
238       displayNonconserved.setState(sg.getShowNonconserved());
239       if (!ap.av.getAlignment().getGroups().contains(sg))
240       {
241         menu1.setLabel(MessageManager.getString("action.edit_new_group"));
242         groupMenu.remove(unGroupMenuItem);
243       }
244       else
245       {
246         menu1.setLabel(MessageManager.getString("action.edit_group"));
247         groupMenu.remove(createGroupMenuItem);
248       }
249
250     }
251     else
252     {
253       remove(hideSeqs);
254       remove(groupMenu);
255     }
256
257     if (links != null && links.size() > 0)
258     {
259       Menu linkMenu = new Menu(MessageManager.getString("action.link"));
260       for (int i = 0; i < links.size(); i++)
261       {
262         String link = links.elementAt(i);
263         UrlLink urlLink = new UrlLink(link);
264         if (!urlLink.isValid())
265         {
266           System.err.println(urlLink.getInvalidMessage());
267           continue;
268         }
269         final String target = urlLink.getTarget(); // link.substring(0,
270         // link.indexOf("|"));
271         final String label = urlLink.getLabel();
272         if (seq != null && urlLink.isDynamic())
273         {
274
275           // collect matching db-refs
276           DBRefEntry[] dbr = jalview.util.DBRefUtils.selectRefs(
277                   seq.getDBRefs(), new String[] { target });
278           // collect id string too
279           String id = seq.getName();
280           String descr = seq.getDescription();
281           if (descr != null && descr.length() < 1)
282           {
283             descr = null;
284           }
285           if (dbr != null)
286           {
287             for (int r = 0; r < dbr.length; r++)
288             {
289               if (id != null && dbr[r].getAccessionId().equals(id))
290               {
291                 // suppress duplicate link creation for the bare sequence ID
292                 // string with this link
293                 id = null;
294               }
295               // create Bare ID link for this RUL
296               String[] urls = urlLink.makeUrls(dbr[r].getAccessionId(),
297                       true);
298               if (urls != null)
299               {
300                 for (int u = 0; u < urls.length; u += 2)
301                 {
302                   addshowLink(linkMenu, label + "|" + urls[u], urls[u + 1]);
303                 }
304               }
305             }
306           }
307           if (id != null)
308           {
309             // create Bare ID link for this RUL
310             String[] urls = urlLink.makeUrls(id, true);
311             if (urls != null)
312             {
313               for (int u = 0; u < urls.length; u += 2)
314               {
315                 addshowLink(linkMenu, label, urls[u + 1]);
316               }
317             }
318             // addshowLink(linkMenu, target, url_pref + id + url_suff);
319           }
320           // Now construct URLs from description but only try to do it for regex
321           // URL links
322           if (descr != null && urlLink.getRegexReplace() != null)
323           {
324             // create link for this URL from description only if regex matches
325             String[] urls = urlLink.makeUrls(descr, true);
326             if (urls != null)
327             {
328               for (int u = 0; u < urls.length; u += 2)
329               {
330                 addshowLink(linkMenu, label, urls[u + 1]);
331               }
332             }
333           }
334         }
335         else
336         {
337           addshowLink(linkMenu, target, urlLink.getUrl_prefix()); // link.substring(link.lastIndexOf("|")+1));
338         }
339         /*
340          * final String url;
341          * 
342          * if (link.indexOf("$SEQUENCE_ID$") > -1) { // Substitute SEQUENCE_ID
343          * string and any matching database reference accessions String url_pref
344          * = link.substring(link.indexOf("|") + 1,
345          * link.indexOf("$SEQUENCE_ID$"));
346          * 
347          * String url_suff = link.substring(link.indexOf("$SEQUENCE_ID$") + 13);
348          * // collect matching db-refs DBRefEntry[] dbr =
349          * jalview.util.DBRefUtils.selectRefs(seq.getDBRef(), new
350          * String[]{target}); // collect id string too String id =
351          * seq.getName(); if (id.indexOf("|") > -1) { id =
352          * id.substring(id.lastIndexOf("|") + 1); } if (dbr!=null) { for (int
353          * r=0;r<dbr.length; r++) { if (dbr[r].getAccessionId().equals(id)) { //
354          * suppress duplicate link creation for the bare sequence ID string with
355          * this link id = null; } addshowLink(linkMenu,
356          * dbr[r].getSource()+"|"+dbr[r].getAccessionId(), target,
357          * url_pref+dbr[r].getAccessionId()+url_suff); } } if (id!=null) { //
358          * create Bare ID link for this RUL addshowLink(linkMenu, target,
359          * url_pref + id + url_suff); } } else { addshowLink(linkMenu, target,
360          * link.substring(link.lastIndexOf("|")+1)); }
361          */
362       }
363       if (linkMenu.getItemCount() > 0)
364       {
365         if (seq != null)
366         {
367           seqMenu.add(linkMenu);
368         }
369         else
370         {
371           add(linkMenu);
372         }
373       }
374     }
375     // TODO: add group link menu entry here
376     if (seq != null)
377     {
378       seqMenu.setLabel(seq.getName());
379       if (seq == ap.av.getAlignment().getSeqrep())
380       {
381         makeReferenceSeq.setLabel(MessageManager
382                 .getString("action.unmark_as_reference"));// Unmark
383                                                           // representative");
384       }
385       else
386       {
387         makeReferenceSeq.setLabel(MessageManager
388                 .getString("action.set_as_reference")); // );
389       }
390       repGroup.setLabel(MessageManager.formatMessage(
391               "label.represent_group_with", new Object[] { seq.getName() }));
392     }
393     else
394     {
395       remove(seqMenu);
396     }
397
398     if (!ap.av.hasHiddenRows())
399     {
400       remove(revealAll);
401       remove(revealSeq);
402     }
403     else
404     {
405       final int index = ap.av.getAlignment().findIndex(seq);
406
407       if (ap.av.adjustForHiddenSeqs(index)
408               - ap.av.adjustForHiddenSeqs(index - 1) > 1)
409       {
410         revealSeq_index = index;
411       }
412       else
413       {
414         remove(revealSeq);
415       }
416     }
417   }
418
419   /**
420    * Build menus for annotation types that may be shown or hidden, and for
421    * 'reference annotations' that may be added to the alignment.
422    */
423   private void buildAnnotationSubmenus()
424   {
425     /*
426      * First for the currently selected sequence (if there is one):
427      */
428     final List<SequenceI> selectedSequence = (seq == null ? Collections
429             .<SequenceI> emptyList() : Arrays.asList(seq));
430     buildAnnotationTypesMenus(seqShowAnnotationsMenu,
431             seqHideAnnotationsMenu, selectedSequence);
432     configureReferenceAnnotationsMenu(seqAddReferenceAnnotations,
433             selectedSequence);
434
435     /*
436      * and repeat for the current selection group (if there is one):
437      */
438     final List<SequenceI> selectedGroup = (ap.av.getSelectionGroup() == null ? Collections
439             .<SequenceI> emptyList() : ap.av.getSelectionGroup()
440             .getSequences());
441     buildAnnotationTypesMenus(groupShowAnnotationsMenu,
442             groupHideAnnotationsMenu, selectedGroup);
443     configureReferenceAnnotationsMenu(groupAddReferenceAnnotations,
444             selectedGroup);
445   }
446
447   /**
448    * Determine whether or not to enable 'add reference annotations' menu item.
449    * It is enable if there are any annotations, on any of the selected
450    * sequences, which are not yet on the alignment (visible or not).
451    * 
452    * @param menu
453    * @param forSequences
454    */
455   private void configureReferenceAnnotationsMenu(MenuItem menuItem,
456           List<SequenceI> forSequences)
457   {
458     menuItem.setEnabled(false);
459
460     /*
461      * Temporary store to hold distinct calcId / type pairs for the tooltip.
462      * Using TreeMap means calcIds are shown in alphabetical order.
463      */
464     Map<String, String> tipEntries = new TreeMap<String, String>();
465     final Map<SequenceI, List<AlignmentAnnotation>> candidates = new LinkedHashMap<SequenceI, List<AlignmentAnnotation>>();
466     AlignmentI al = this.ap.av.getAlignment();
467     AlignmentUtils.findAddableReferenceAnnotations(forSequences,
468             tipEntries, candidates, al);
469     if (!candidates.isEmpty())
470     {
471       StringBuilder tooltip = new StringBuilder(64);
472       tooltip.append(MessageManager.getString("label.add_annotations_for"));
473
474       /*
475        * Found annotations that could be added. Enable the menu item, and
476        * configure its action.
477        */
478       menuItem.setEnabled(true);
479
480       menuItem.addActionListener(new ActionListener()
481       {
482         @Override
483         public void actionPerformed(ActionEvent e)
484         {
485           addReferenceAnnotations_actionPerformed(candidates);
486         }
487       });
488     }
489   }
490
491   /**
492    * Add annotations to the sequences and to the alignment.
493    * 
494    * @param candidates
495    *          a map whose keys are sequences on the alignment, and values a list
496    *          of annotations to add to each sequence
497    */
498   protected void addReferenceAnnotations_actionPerformed(
499           Map<SequenceI, List<AlignmentAnnotation>> candidates)
500   {
501     final SequenceGroup selectionGroup = this.ap.av.getSelectionGroup();
502     final AlignmentI alignment = this.ap.getAlignment();
503     AlignmentUtils.addReferenceAnnotations(candidates, alignment,
504             selectionGroup);
505     refresh();
506   }
507
508   /**
509    * add a show URL menu item to the given linkMenu
510    * 
511    * @param linkMenu
512    * @param target
513    *          - menu label string
514    * @param url
515    *          - url to open
516    */
517   private void addshowLink(Menu linkMenu, final String target,
518           final String url)
519   {
520     addshowLink(linkMenu, target, target, url);
521   }
522
523   /**
524    * add a show URL menu item to the given linkMenu
525    * 
526    * @param linkMenu
527    * @param target
528    *          - URL target window
529    * @param label
530    *          - menu label string
531    * @param url
532    *          - url to open
533    */
534   private void addshowLink(Menu linkMenu, final String target,
535           final String label, final String url)
536   {
537     MenuItem item = new MenuItem(label);
538     item.addActionListener(new java.awt.event.ActionListener()
539     {
540       @Override
541       public void actionPerformed(ActionEvent e)
542       {
543         ap.alignFrame.showURL(url, target);
544       }
545     });
546     linkMenu.add(item);
547   }
548
549   @Override
550   public void itemStateChanged(ItemEvent evt)
551   {
552     if (evt.getSource() == abovePIDColour)
553     {
554       abovePIDColour_itemStateChanged();
555     }
556     else if (evt.getSource() == showColourText)
557     {
558       showColourText_itemStateChanged();
559     }
560     else if (evt.getSource() == showText)
561     {
562       showText_itemStateChanged();
563     }
564     else if (evt.getSource() == showBoxes)
565     {
566       showBoxes_itemStateChanged();
567     }
568     else if (evt.getSource() == displayNonconserved)
569     {
570       this.showNonconserved_itemStateChanged();
571     }
572   }
573
574   @Override
575   public void actionPerformed(ActionEvent evt)
576   {
577     Object source = evt.getSource();
578     if (source == clustalColour)
579     {
580       clustalColour_actionPerformed();
581     }
582     else if (source == zappoColour)
583     {
584       zappoColour_actionPerformed();
585     }
586     else if (source == taylorColour)
587     {
588       taylorColour_actionPerformed();
589     }
590     else if (source == hydrophobicityColour)
591     {
592       hydrophobicityColour_actionPerformed();
593     }
594     else if (source == helixColour)
595     {
596       helixColour_actionPerformed();
597     }
598     else if (source == strandColour)
599     {
600       strandColour_actionPerformed();
601     }
602     else if (source == turnColour)
603     {
604       turnColour_actionPerformed();
605     }
606     else if (source == buriedColour)
607     {
608       buriedColour_actionPerformed();
609     }
610     else if (source == nucleotideMenuItem)
611     {
612       nucleotideMenuItem_actionPerformed();
613     }
614
615     else if (source == userDefinedColour)
616     {
617       userDefinedColour_actionPerformed();
618     }
619     else if (source == PIDColour)
620     {
621       PIDColour_actionPerformed();
622     }
623     else if (source == BLOSUM62Colour)
624     {
625       BLOSUM62Colour_actionPerformed();
626     }
627     else if (source == noColourmenuItem)
628     {
629       noColourmenuItem_actionPerformed();
630     }
631     else if (source == conservationMenuItem)
632     {
633       conservationMenuItem_itemStateChanged();
634     }
635     else if (source == unGroupMenuItem)
636     {
637       unGroupMenuItem_actionPerformed();
638     }
639
640     else if (source == createGroupMenuItem)
641     {
642       createGroupMenuItem_actionPerformed();
643     }
644
645     else if (source == sequenceName)
646     {
647       editName();
648     }
649     else if (source == makeReferenceSeq)
650     {
651       makeReferenceSeq_actionPerformed();
652     }
653     else if (source == sequenceDetails)
654     {
655       showSequenceDetails();
656     }
657     else if (source == selSeqDetails)
658     {
659       showSequenceSelectionDetails();
660     }
661     else if (source == pdb)
662     {
663       addPDB();
664     }
665     else if (source == hideSeqs)
666     {
667       hideSequences(false);
668     }
669     else if (source == repGroup)
670     {
671       hideSequences(true);
672     }
673     else if (source == revealSeq)
674     {
675       ap.av.showSequence(revealSeq_index);
676     }
677     else if (source == revealAll)
678     {
679       ap.av.showAllHiddenSeqs();
680     }
681
682     else if (source == editGroupName)
683     {
684       EditNameDialog dialog = new EditNameDialog(getGroup().getName(),
685               getGroup().getDescription(), "       Group Name",
686               "Group Description", ap.alignFrame,
687               "Edit Group Name / Description", 500, 100, true);
688
689       if (dialog.accept)
690       {
691         getGroup().setName(dialog.getName().replace(' ', '_'));
692         getGroup().setDescription(dialog.getDescription());
693       }
694
695     }
696     else if (source == copy)
697     {
698       ap.alignFrame.copy_actionPerformed();
699     }
700     else if (source == cut)
701     {
702       ap.alignFrame.cut_actionPerformed();
703     }
704     else if (source == editSequence)
705     {
706       SequenceGroup sg = ap.av.getSelectionGroup();
707
708       if (sg != null)
709       {
710         if (seq == null)
711         {
712           seq = sg.getSequenceAt(0);
713         }
714
715         EditNameDialog dialog = new EditNameDialog(seq.getSequenceAsString(
716                 sg.getStartRes(), sg.getEndRes() + 1), null,
717                 "Edit Sequence ", null,
718
719                 ap.alignFrame, "Edit Sequence", 500, 100, true);
720
721         if (dialog.accept)
722         {
723           EditCommand editCommand = new EditCommand(
724                   MessageManager.getString("label.edit_sequences"),
725                   Action.REPLACE, dialog.getName().replace(' ',
726                           ap.av.getGapCharacter()),
727                   sg.getSequencesAsArray(ap.av.getHiddenRepSequences()),
728                   sg.getStartRes(), sg.getEndRes() + 1,
729                   ap.av.getAlignment());
730
731           ap.alignFrame.addHistoryItem(editCommand);
732
733           ap.av.firePropertyChange("alignment", null, ap.av.getAlignment()
734                   .getSequences());
735         }
736       }
737     }
738     else if (source == toUpper || source == toLower || source == toggleCase)
739     {
740       SequenceGroup sg = ap.av.getSelectionGroup();
741       if (sg != null)
742       {
743         List<int[]> startEnd = ap.av.getVisibleRegionBoundaries(
744                 sg.getStartRes(), sg.getEndRes() + 1);
745
746         String description;
747         int caseChange;
748
749         if (source == toggleCase)
750         {
751           description = "Toggle Case";
752           caseChange = ChangeCaseCommand.TOGGLE_CASE;
753         }
754         else if (source == toUpper)
755         {
756           description = "To Upper Case";
757           caseChange = ChangeCaseCommand.TO_UPPER;
758         }
759         else
760         {
761           description = "To Lower Case";
762           caseChange = ChangeCaseCommand.TO_LOWER;
763         }
764
765         ChangeCaseCommand caseCommand = new ChangeCaseCommand(description,
766                 sg.getSequencesAsArray(ap.av.getHiddenRepSequences()),
767                 startEnd, caseChange);
768
769         ap.alignFrame.addHistoryItem(caseCommand);
770
771         ap.av.firePropertyChange("alignment", null, ap.av.getAlignment()
772                 .getSequences());
773
774       }
775     }
776     else if (source == sequenceFeature)
777     {
778       SequenceGroup sg = ap.av.getSelectionGroup();
779       if (sg == null)
780       {
781         return;
782       }
783
784       int rsize = 0, gSize = sg.getSize();
785       SequenceI[] rseqs, seqs = new SequenceI[gSize];
786       SequenceFeature[] tfeatures, features = new SequenceFeature[gSize];
787
788       for (int i = 0; i < gSize; i++)
789       {
790         int start = sg.getSequenceAt(i).findPosition(sg.getStartRes());
791         int end = sg.findEndRes(sg.getSequenceAt(i));
792         if (start <= end)
793         {
794           seqs[rsize] = sg.getSequenceAt(i);
795           features[rsize] = new SequenceFeature(null, null, null, start,
796                   end, "Jalview");
797           rsize++;
798         }
799       }
800       rseqs = new SequenceI[rsize];
801       tfeatures = new SequenceFeature[rsize];
802       System.arraycopy(seqs, 0, rseqs, 0, rsize);
803       System.arraycopy(features, 0, tfeatures, 0, rsize);
804       features = tfeatures;
805       seqs = rseqs;
806
807       if (ap.seqPanel.seqCanvas.getFeatureRenderer().amendFeatures(seqs,
808               features, true, ap))
809       {
810         ap.alignFrame.sequenceFeatures.setState(true);
811         ap.av.setShowSequenceFeatures(true);
812         ;
813         ap.highlightSearchResults(null);
814       }
815     }
816     else
817     {
818       outputText(evt);
819     }
820
821   }
822
823   void outputText(ActionEvent e)
824   {
825     CutAndPasteTransfer cap = new CutAndPasteTransfer(true, ap.alignFrame);
826
827     Frame frame = new Frame();
828     frame.add(cap);
829     JalviewLite.addFrame(frame, MessageManager.formatMessage(
830             "label.selection_output_command",
831             new Object[] { e.getActionCommand() }), 600, 500);
832     // JBPNote: getSelectionAsNewSequence behaviour has changed - this method
833     // now returns a full copy of sequence data
834     // TODO consider using getSequenceSelection instead here
835
836     FileFormat fileFormat = FileFormat.valueOf(e.getActionCommand());
837     cap.setText(new AppletFormatAdapter().formatSequences(fileFormat,
838             ap.av.getShowJVSuffix(), ap, true));
839
840   }
841
842   protected void showSequenceSelectionDetails()
843   {
844     createSequenceDetailsReport(ap.av.getSequenceSelection());
845   }
846
847   protected void showSequenceDetails()
848   {
849     createSequenceDetailsReport(new SequenceI[] { seq });
850   }
851
852   public void createSequenceDetailsReport(SequenceI[] sequences)
853   {
854
855     CutAndPasteTransfer cap = new CutAndPasteTransfer(false, ap.alignFrame);
856
857     StringBuffer contents = new StringBuffer();
858     for (SequenceI seq : sequences)
859     {
860       contents.append(MessageManager.formatMessage(
861               "label.annotation_for_displayid",
862               new Object[] { seq.getDisplayId(true) }));
863       new SequenceAnnotationReport(null).createSequenceAnnotationReport(
864               contents,
865               seq,
866               true,
867               true,
868               false,
869               (ap.seqPanel.seqCanvas.fr != null) ? ap.seqPanel.seqCanvas.fr
870                       .getMinMax() : null);
871       contents.append("</p>");
872     }
873     Frame frame = new Frame();
874     frame.add(cap);
875     jalview.bin.JalviewLite.addFrame(frame, "Sequence Details for "
876             + (sequences.length == 1 ? sequences[0].getDisplayId(true)
877                     : "Selection"), 600, 500);
878     cap.setText(MessageManager.formatMessage("label.html_content",
879             new Object[] { contents.toString() }));
880   }
881
882   void editName()
883   {
884     EditNameDialog dialog = new EditNameDialog(seq.getName(),
885             seq.getDescription(), "       Sequence Name",
886             "Sequence Description", ap.alignFrame,
887             "Edit Sequence Name / Description", 500, 100, true);
888
889     if (dialog.accept)
890     {
891       seq.setName(dialog.getName());
892       seq.setDescription(dialog.getDescription());
893       ap.paintAlignment(false);
894     }
895   }
896
897   void addPDB()
898   {
899     if (seq.getAllPDBEntries() != null)
900     {
901       PDBEntry entry = seq.getAllPDBEntries().firstElement();
902
903       if (ap.av.applet.jmolAvailable)
904       {
905         new jalview.appletgui.AppletJmol(entry, new SequenceI[] { seq },
906                 null, ap, DataSourceType.URL);
907       }
908       else
909       {
910         new MCview.AppletPDBViewer(entry, new SequenceI[] { seq }, null,
911                 ap, DataSourceType.URL);
912       }
913
914     }
915     else
916     {
917       CutAndPasteTransfer cap = new CutAndPasteTransfer(true, ap.alignFrame);
918       cap.setText(MessageManager.getString("label.paste_pdb_file"));
919       cap.setPDBImport(seq);
920       Frame frame = new Frame();
921       frame.add(cap);
922       jalview.bin.JalviewLite.addFrame(frame, MessageManager.formatMessage(
923               "label.paste_pdb_file_for_sequence",
924               new Object[] { seq.getName() }), 400, 300);
925     }
926   }
927
928   private void jbInit() throws Exception
929   {
930     groupMenu.setLabel(MessageManager.getString("label.selection"));
931     sequenceFeature.addActionListener(this);
932
933     editGroupName.addActionListener(this);
934     unGroupMenuItem.setLabel(MessageManager
935             .getString("action.remove_group"));
936     unGroupMenuItem.addActionListener(this);
937
938     createGroupMenuItem.setLabel(MessageManager
939             .getString("action.create_group"));
940     createGroupMenuItem.addActionListener(this);
941
942     nucleotideMenuItem.setLabel(MessageManager
943             .getString("label.nucleotide"));
944     nucleotideMenuItem.addActionListener(this);
945     conservationMenuItem.addItemListener(this);
946     abovePIDColour.addItemListener(this);
947     colourMenu.setLabel(MessageManager.getString("label.group_colour"));
948     showBoxes.setLabel(MessageManager.getString("action.boxes"));
949     showBoxes.setState(true);
950     showBoxes.addItemListener(this);
951     sequenceName.addActionListener(this);
952     sequenceDetails.addActionListener(this);
953     selSeqDetails.addActionListener(this);
954     displayNonconserved.setLabel(MessageManager
955             .getString("label.show_non_conversed"));
956     displayNonconserved.setState(false);
957     displayNonconserved.addItemListener(this);
958     showText.setLabel(MessageManager.getString("action.text"));
959     showText.addItemListener(this);
960     showColourText.setLabel(MessageManager.getString("label.colour_text"));
961     showColourText.addItemListener(this);
962     outputmenu.setLabel(MessageManager.getString("label.out_to_textbox"));
963     seqMenu.setLabel(MessageManager.getString("label.sequence"));
964     pdb.setLabel(MessageManager.getString("label.view_pdb_structure"));
965     hideSeqs.setLabel(MessageManager.getString("action.hide_sequences"));
966     repGroup.setLabel(MessageManager.formatMessage(
967             "label.represent_group_with", new Object[] { "" }));
968     revealAll.setLabel(MessageManager.getString("action.reveal_all"));
969     revealSeq.setLabel(MessageManager.getString("action.reveal_sequences"));
970     menu1.setLabel(MessageManager.getString("label.group:"));
971     add(groupMenu);
972     this.add(seqMenu);
973     this.add(hideSeqs);
974     this.add(revealSeq);
975     this.add(revealAll);
976     // groupMenu.add(selSeqDetails);
977     groupMenu.add(groupShowAnnotationsMenu);
978     groupMenu.add(groupHideAnnotationsMenu);
979     groupMenu.add(groupAddReferenceAnnotations);
980     groupMenu.add(editMenu);
981     groupMenu.add(outputmenu);
982     groupMenu.add(sequenceFeature);
983     groupMenu.add(createGroupMenuItem);
984     groupMenu.add(unGroupMenuItem);
985     groupMenu.add(menu1);
986
987     colourMenu.add(noColourmenuItem);
988     colourMenu.add(clustalColour);
989     colourMenu.add(BLOSUM62Colour);
990     colourMenu.add(PIDColour);
991     colourMenu.add(zappoColour);
992     colourMenu.add(taylorColour);
993     colourMenu.add(hydrophobicityColour);
994     colourMenu.add(helixColour);
995     colourMenu.add(strandColour);
996     colourMenu.add(turnColour);
997     colourMenu.add(buriedColour);
998     colourMenu.add(nucleotideMenuItem);
999     colourMenu.add(userDefinedColour);
1000     colourMenu.addSeparator();
1001     colourMenu.add(abovePIDColour);
1002     colourMenu.add(conservationMenuItem);
1003
1004     noColourmenuItem.setLabel(MessageManager.getString("label.none"));
1005     noColourmenuItem.addActionListener(this);
1006
1007     clustalColour.setLabel(MessageManager
1008             .getString("label.clustalx_colours"));
1009     clustalColour.addActionListener(this);
1010     zappoColour.setLabel(MessageManager.getString("label.zappo"));
1011     zappoColour.addActionListener(this);
1012     taylorColour.setLabel(MessageManager.getString("label.taylor"));
1013     taylorColour.addActionListener(this);
1014     hydrophobicityColour.setLabel(MessageManager
1015             .getString("label.hydrophobicity"));
1016     hydrophobicityColour.addActionListener(this);
1017     helixColour
1018             .setLabel(MessageManager.getString("label.helix_propensity"));
1019     helixColour.addActionListener(this);
1020     strandColour.setLabel(MessageManager
1021             .getString("label.strand_propensity"));
1022     strandColour.addActionListener(this);
1023     turnColour.setLabel(MessageManager.getString("label.turn_propensity"));
1024     turnColour.addActionListener(this);
1025     buriedColour.setLabel(MessageManager.getString("label.buried_index"));
1026     buriedColour.addActionListener(this);
1027     abovePIDColour.setLabel(MessageManager
1028             .getString("label.above_identity_percentage"));
1029
1030     userDefinedColour.setLabel(MessageManager
1031             .getString("action.user_defined"));
1032     userDefinedColour.addActionListener(this);
1033     PIDColour.setLabel(MessageManager
1034             .getString("label.percentage_identity"));
1035     PIDColour.addActionListener(this);
1036     BLOSUM62Colour.setLabel("BLOSUM62");
1037     BLOSUM62Colour.addActionListener(this);
1038     conservationMenuItem.setLabel(MessageManager
1039             .getString("label.conservation"));
1040
1041     editMenu.add(copy);
1042     copy.addActionListener(this);
1043     editMenu.add(cut);
1044     cut.addActionListener(this);
1045
1046     editMenu.add(editSequence);
1047     editSequence.addActionListener(this);
1048
1049     editMenu.add(toUpper);
1050     toUpper.addActionListener(this);
1051     editMenu.add(toLower);
1052     toLower.addActionListener(this);
1053     editMenu.add(toggleCase);
1054     seqMenu.add(seqShowAnnotationsMenu);
1055     seqMenu.add(seqHideAnnotationsMenu);
1056     seqMenu.add(seqAddReferenceAnnotations);
1057     seqMenu.add(sequenceName);
1058     seqMenu.add(makeReferenceSeq);
1059     // seqMenu.add(sequenceDetails);
1060
1061     if (!ap.av.applet.useXtrnalSviewer)
1062     {
1063       seqMenu.add(pdb);
1064     }
1065     seqMenu.add(repGroup);
1066     menu1.add(editGroupName);
1067     menu1.add(colourMenu);
1068     menu1.add(showBoxes);
1069     menu1.add(showText);
1070     menu1.add(showColourText);
1071     menu1.add(displayNonconserved);
1072     toggleCase.addActionListener(this);
1073     pdb.addActionListener(this);
1074     hideSeqs.addActionListener(this);
1075     repGroup.addActionListener(this);
1076     revealAll.addActionListener(this);
1077     revealSeq.addActionListener(this);
1078     makeReferenceSeq.addActionListener(this);
1079   }
1080
1081   void refresh()
1082   {
1083     ap.paintAlignment(true);
1084   }
1085
1086   protected void clustalColour_actionPerformed()
1087   {
1088     SequenceGroup sg = getGroup();
1089     sg.cs = new ClustalxColourScheme(sg, ap.av.getHiddenRepSequences());
1090     refresh();
1091   }
1092
1093   protected void zappoColour_actionPerformed()
1094   {
1095     getGroup().cs = new ZappoColourScheme();
1096     refresh();
1097   }
1098
1099   protected void taylorColour_actionPerformed()
1100   {
1101     getGroup().cs = new TaylorColourScheme();
1102     refresh();
1103   }
1104
1105   protected void hydrophobicityColour_actionPerformed()
1106   {
1107     getGroup().cs = new HydrophobicColourScheme();
1108     refresh();
1109   }
1110
1111   protected void helixColour_actionPerformed()
1112   {
1113     getGroup().cs = new HelixColourScheme();
1114     refresh();
1115   }
1116
1117   protected void strandColour_actionPerformed()
1118   {
1119     getGroup().cs = new StrandColourScheme();
1120     refresh();
1121   }
1122
1123   protected void turnColour_actionPerformed()
1124   {
1125     getGroup().cs = new TurnColourScheme();
1126     refresh();
1127   }
1128
1129   protected void buriedColour_actionPerformed()
1130   {
1131     getGroup().cs = new BuriedColourScheme();
1132     refresh();
1133   }
1134
1135   public void nucleotideMenuItem_actionPerformed()
1136   {
1137     getGroup().cs = new NucleotideColourScheme();
1138     refresh();
1139   }
1140
1141   protected void abovePIDColour_itemStateChanged()
1142   {
1143     SequenceGroup sg = getGroup();
1144     if (sg.cs == null)
1145     {
1146       return;
1147     }
1148
1149     if (abovePIDColour.getState())
1150     {
1151       sg.cs.setConsensus(AAFrequency.calculate(sg.getSequences(ap.av
1152               .getHiddenRepSequences()), 0, ap.av.getAlignment().getWidth()));
1153       int threshold = SliderPanel.setPIDSliderSource(ap, sg.cs, getGroup()
1154               .getName());
1155
1156       sg.cs.setThreshold(threshold, ap.av.isIgnoreGapsConsensus());
1157
1158       SliderPanel.showPIDSlider();
1159
1160     }
1161     else
1162     // remove PIDColouring
1163     {
1164       sg.cs.setThreshold(0, ap.av.isIgnoreGapsConsensus());
1165     }
1166
1167     refresh();
1168
1169   }
1170
1171   protected void userDefinedColour_actionPerformed()
1172   {
1173     new UserDefinedColours(ap, getGroup());
1174   }
1175
1176   protected void PIDColour_actionPerformed()
1177   {
1178     SequenceGroup sg = getGroup();
1179     sg.cs = new PIDColourScheme();
1180     sg.cs.setConsensus(AAFrequency.calculate(sg.getSequences(ap.av
1181             .getHiddenRepSequences()), 0, ap.av.getAlignment().getWidth()));
1182     refresh();
1183   }
1184
1185   protected void BLOSUM62Colour_actionPerformed()
1186   {
1187     SequenceGroup sg = getGroup();
1188
1189     sg.cs = new Blosum62ColourScheme();
1190
1191     sg.cs.setConsensus(AAFrequency.calculate(sg.getSequences(ap.av
1192             .getHiddenRepSequences()), 0, ap.av.getAlignment().getWidth()));
1193
1194     refresh();
1195   }
1196
1197   protected void noColourmenuItem_actionPerformed()
1198   {
1199     getGroup().cs = null;
1200     refresh();
1201   }
1202
1203   protected void conservationMenuItem_itemStateChanged()
1204   {
1205     SequenceGroup sg = getGroup();
1206     if (sg.cs == null)
1207     {
1208       return;
1209     }
1210
1211     if (conservationMenuItem.getState())
1212     {
1213
1214       sg.cs.setConservation(Conservation.calculateConservation("Group",
1215               ResidueProperties.propHash, 3, sg.getSequences(ap.av
1216                       .getHiddenRepSequences()), 0, ap.av.getAlignment()
1217                       .getWidth(), false, ap.av.getConsPercGaps(), false));
1218       SliderPanel.setConservationSlider(ap, sg.cs, sg.getName());
1219       SliderPanel.showConservationSlider();
1220     }
1221     else
1222     // remove ConservationColouring
1223     {
1224       sg.cs.setConservation(null);
1225     }
1226
1227     refresh();
1228   }
1229
1230   SequenceGroup getGroup()
1231   {
1232     SequenceGroup sg = ap.av.getSelectionGroup();
1233
1234     // this method won't add a new group if it already exists
1235     if (sg != null)
1236     {
1237       ap.av.getAlignment().addGroup(sg);
1238     }
1239
1240     return sg;
1241   }
1242
1243   void unGroupMenuItem_actionPerformed()
1244   {
1245     SequenceGroup sg = ap.av.getSelectionGroup();
1246     ap.av.getAlignment().deleteGroup(sg);
1247     ap.av.setSelectionGroup(null);
1248     ap.paintAlignment(true);
1249   }
1250
1251   void createGroupMenuItem_actionPerformed()
1252   {
1253     getGroup(); // implicitly create group
1254     refresh();
1255   }
1256
1257   public void showColourText_itemStateChanged()
1258   {
1259     getGroup().setColourText(showColourText.getState());
1260     refresh();
1261   }
1262
1263   public void showText_itemStateChanged()
1264   {
1265     getGroup().setDisplayText(showText.getState());
1266     refresh();
1267   }
1268
1269   public void makeReferenceSeq_actionPerformed()
1270   {
1271     if (!ap.av.getAlignment().hasSeqrep())
1272     {
1273       // initialise the display flags so the user sees something happen
1274       ap.av.setDisplayReferenceSeq(true);
1275       ap.av.setColourByReferenceSeq(true);
1276       ap.av.getAlignment().setSeqrep(seq);
1277     }
1278     else
1279     {
1280       if (ap.av.getAlignment().getSeqrep() == seq)
1281       {
1282         ap.av.getAlignment().setSeqrep(null);
1283       }
1284       else
1285       {
1286         ap.av.getAlignment().setSeqrep(seq);
1287       }
1288     }
1289     refresh();
1290   }
1291
1292   public void showNonconserved_itemStateChanged()
1293   {
1294     getGroup().setShowNonconserved(this.displayNonconserved.getState());
1295     refresh();
1296   }
1297
1298   public void showBoxes_itemStateChanged()
1299   {
1300     getGroup().setDisplayBoxes(showBoxes.getState());
1301     refresh();
1302   }
1303
1304   void hideSequences(boolean representGroup)
1305   {
1306     ap.av.hideSequences(seq, representGroup);
1307   }
1308
1309   /**
1310    * Add annotation types to 'Show annotations' and/or 'Hide annotations' menus.
1311    * "All" is added first, followed by a separator. Then add any annotation
1312    * types associated with the current selection. Separate menus are built for
1313    * the selected sequence group (if any), and the selected sequence.
1314    * <p>
1315    * Some annotation rows are always rendered together - these can be identified
1316    * by a common graphGroup property > -1. Only one of each group will be marked
1317    * as visible (to avoid duplication of the display). For such groups we add a
1318    * composite type name, e.g.
1319    * <p>
1320    * IUPredWS (Long), IUPredWS (Short)
1321    * 
1322    * @param seq
1323    */
1324   protected void buildAnnotationTypesMenus(Menu showMenu, Menu hideMenu,
1325           List<SequenceI> forSequences)
1326   {
1327     showMenu.removeAll();
1328     hideMenu.removeAll();
1329
1330     final List<String> all = Arrays.asList(new String[] { MessageManager
1331             .getString("label.all") });
1332     addAnnotationTypeToShowHide(showMenu, forSequences, "", all, true, true);
1333     addAnnotationTypeToShowHide(hideMenu, forSequences, "", all, true,
1334             false);
1335     showMenu.addSeparator();
1336     hideMenu.addSeparator();
1337
1338     final AlignmentAnnotation[] annotations = ap.getAlignment()
1339             .getAlignmentAnnotation();
1340
1341     /*
1342      * Find shown/hidden annotations types, distinguished by source (calcId),
1343      * and grouped by graphGroup. Using LinkedHashMap means we will retrieve in
1344      * the insertion order, which is the order of the annotations on the
1345      * alignment.
1346      */
1347     Map<String, List<List<String>>> shownTypes = new LinkedHashMap<String, List<List<String>>>();
1348     Map<String, List<List<String>>> hiddenTypes = new LinkedHashMap<String, List<List<String>>>();
1349     AlignmentAnnotationUtils.getShownHiddenTypes(shownTypes, hiddenTypes,
1350             AlignmentAnnotationUtils.asList(annotations), forSequences);
1351
1352     for (String calcId : hiddenTypes.keySet())
1353     {
1354       for (List<String> type : hiddenTypes.get(calcId))
1355       {
1356         addAnnotationTypeToShowHide(showMenu, forSequences, calcId, type,
1357                 false, true);
1358       }
1359     }
1360     // grey out 'show annotations' if none are hidden
1361     showMenu.setEnabled(!hiddenTypes.isEmpty());
1362
1363     for (String calcId : shownTypes.keySet())
1364     {
1365       for (List<String> type : shownTypes.get(calcId))
1366       {
1367         addAnnotationTypeToShowHide(hideMenu, forSequences, calcId, type,
1368                 false, false);
1369       }
1370     }
1371     // grey out 'hide annotations' if none are shown
1372     hideMenu.setEnabled(!shownTypes.isEmpty());
1373   }
1374
1375   /**
1376    * Add one annotation type to the 'Show Annotations' or 'Hide Annotations'
1377    * menus.
1378    * 
1379    * @param showOrHideMenu
1380    *          the menu to add to
1381    * @param forSequences
1382    *          the sequences whose annotations may be shown or hidden
1383    * @param calcId
1384    * @param types
1385    *          the label to add
1386    * @param allTypes
1387    *          if true this is a special label meaning 'All'
1388    * @param actionIsShow
1389    *          if true, the select menu item action is to show the annotation
1390    *          type, else hide
1391    */
1392   protected void addAnnotationTypeToShowHide(Menu showOrHideMenu,
1393           final List<SequenceI> forSequences, String calcId,
1394           final List<String> types, final boolean allTypes,
1395           final boolean actionIsShow)
1396   {
1397     String label = types.toString(); // [a, b, c]
1398     label = label.substring(1, label.length() - 1);
1399     final MenuItem item = new MenuItem(label);
1400     item.addActionListener(new java.awt.event.ActionListener()
1401     {
1402       @Override
1403       public void actionPerformed(ActionEvent e)
1404       {
1405         AlignmentUtils.showOrHideSequenceAnnotations(ap.getAlignment(),
1406                 types, forSequences, allTypes, actionIsShow);
1407         refresh();
1408       }
1409     });
1410     showOrHideMenu.add(item);
1411   }
1412
1413 }