2 * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
3 * Copyright (C) $$Year-Rel$$ The Jalview Authors
5 * This file is part of Jalview.
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.
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.
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.
23 import jalview.analysis.AlignmentSorter;
24 import jalview.analysis.TreeModel;
25 import jalview.bin.Cache;
26 import jalview.commands.CommandI;
27 import jalview.commands.OrderCommand;
28 import jalview.datamodel.Alignment;
29 import jalview.datamodel.AlignmentI;
30 import jalview.datamodel.AlignmentView;
31 import jalview.datamodel.BinaryNode;
32 import jalview.datamodel.DBRefEntry;
33 import jalview.datamodel.HiddenColumns;
34 import jalview.datamodel.NodeTransformI;
35 import jalview.datamodel.SequenceFeature;
36 import jalview.datamodel.SequenceI;
37 import jalview.datamodel.SequenceNode;
38 import jalview.ext.archaeopteryx.ArchaeopteryxNewickInit;
39 import jalview.io.JalviewFileChooser;
40 import jalview.io.JalviewFileView;
41 import jalview.io.NewickFile;
42 import jalview.jbgui.GTreePanel;
43 import jalview.util.ImageMaker;
44 import jalview.util.MessageManager;
45 import jalview.viewmodel.AlignmentViewport;
48 import java.awt.Graphics;
49 import java.awt.event.ActionEvent;
50 import java.awt.event.ActionListener;
51 import java.awt.image.BufferedImage;
52 import java.beans.PropertyChangeEvent;
53 import java.io.FileOutputStream;
54 import java.util.ArrayList;
55 import java.util.List;
57 import javax.imageio.ImageIO;
58 import javax.swing.ButtonGroup;
59 import javax.swing.JMenuItem;
60 import javax.swing.JRadioButtonMenuItem;
62 import org.jibble.epsgraphics.EpsGraphics2D;
70 public class TreePanel extends GTreePanel
72 String substitutionMatrix;
76 String treeTitle; // if tree loaded
78 TreeCanvas treeCanvas;
85 * Creates a new TreePanel object.
90 public TreePanel(AlignmentPanel ap, TreeModel tree, String treeType,
91 String substitutionMatrix)
94 this.treeType = treeType;
95 this.substitutionMatrix = substitutionMatrix;
97 initNewTreePanel(ap, tree);
99 // We know this tree has distances. JBPNote TODO: prolly should add this as
100 // a userdefined default
101 // showDistances(true);
105 * Creates a new TreePanel object.
113 public TreePanel(AlignmentPanel alignPanel, NewickFile newtree,
114 String theTitle, AlignmentView inputData)
117 this.treeTitle = theTitle;
118 initLoadedTreePanel(alignPanel, newtree, inputData);
121 public AlignmentI getAlignment()
123 return treeCanvas.av.getAlignment();
126 public AlignmentViewport getViewPort()
128 return treeCanvas.av;
131 void initNewTreePanel(AlignmentPanel ap, TreeModel tree)
135 TreeLoader tl = new TreeLoader(null, null);
139 void initLoadedTreePanel(AlignmentPanel ap,
140 NewickFile newTree, AlignmentView inputData)
144 TreeLoader tl = new TreeLoader(newTree, inputData);
148 public void buildTreeCanvas(AlignmentPanel ap) {
151 treeCanvas = new TreeCanvas(this, ap, scrollPane);
152 scrollPane.setViewportView(treeCanvas);
155 PaintRefresher.Register(this, ap.av.getSequenceSetId());
157 buildAssociatedViewMenu();
159 av.addPropertyChangeListener(new java.beans.PropertyChangeListener()
162 public void propertyChange(PropertyChangeEvent evt)
164 if (evt.getPropertyName().equals("alignment"))
168 System.out.println("tree is null");
169 // TODO: deal with case when a change event is received whilst a
170 // tree is still being calculated - should save reference for
171 // processing message later.
174 if (evt.getNewValue() == null)
177 "new alignment sequences vector value is null");
180 tree.updatePlaceHolders((List<SequenceI>) evt.getNewValue());
181 treeCanvas.nameHash.clear(); // reset the mapping between canvas
182 // rectangles and leafnodes
194 public void viewMenu_menuSelected()
196 buildAssociatedViewMenu();
199 void buildAssociatedViewMenu()
201 AlignmentPanel[] aps = PaintRefresher
202 .getAssociatedPanels(av.getSequenceSetId());
203 if (aps.length == 1 && treeCanvas.ap == aps[0])
205 associateLeavesMenu.setVisible(false);
209 associateLeavesMenu.setVisible(true);
212 .getItem(viewMenu.getItemCount() - 2) instanceof JMenuItem))
214 viewMenu.insertSeparator(viewMenu.getItemCount() - 1);
217 associateLeavesMenu.removeAll();
219 JRadioButtonMenuItem item;
220 ButtonGroup buttonGroup = new ButtonGroup();
221 int i, iSize = aps.length;
222 final TreePanel thisTreePanel = this;
223 for (i = 0; i < iSize; i++)
225 final AlignmentPanel ap = aps[i];
226 item = new JRadioButtonMenuItem(ap.av.viewName, ap == treeCanvas.ap);
227 buttonGroup.add(item);
228 item.addActionListener(new ActionListener()
231 public void actionPerformed(ActionEvent evt)
233 treeCanvas.applyToAllViews = false;
235 treeCanvas.av = ap.av;
236 PaintRefresher.Register(thisTreePanel, ap.av.getSequenceSetId());
240 associateLeavesMenu.add(item);
243 final JRadioButtonMenuItem itemf = new JRadioButtonMenuItem(
244 MessageManager.getString("label.all_views"));
245 buttonGroup.add(itemf);
246 itemf.setSelected(treeCanvas.applyToAllViews);
247 itemf.addActionListener(new ActionListener()
250 public void actionPerformed(ActionEvent evt)
252 treeCanvas.applyToAllViews = itemf.isSelected();
255 associateLeavesMenu.add(itemf);
259 class TreeLoader extends Thread
261 private NewickFile newTree;
263 private AlignmentView odata = null;
265 public TreeLoader(NewickFile newickFile, AlignmentView inputData)
267 this.newTree = newickFile;
268 this.odata = inputData;
272 // Must be outside run(), as Jalview2XML tries to
273 // update distance/bootstrap visibility at the same time
274 showBootstrap(newTree.hasBootstrap());
275 showDistances(newTree.hasDistances());
287 tree = new TreeModel(av.getAlignment().getSequencesArray(), odata,
289 if (tree.getOriginalData() == null)
291 originalSeqData.setVisible(false);
301 public void showTree(TreeModel tree)
303 tree.reCount(tree.getTopNode());
304 tree.findHeight(tree.getTopNode());
305 treeCanvas.setTree(tree);
306 treeCanvas.repaint();
308 av.setCurrentTree(tree);
309 if (av.getSortByTree())
311 sortByTree_actionPerformed();
314 ArchaeopteryxNewickInit archae = new ArchaeopteryxNewickInit(tree);
315 archae.startArchaeopteryx();
319 public void showDistances(boolean b)
321 treeCanvas.setShowDistances(b);
322 distanceMenu.setSelected(b);
325 public void showBootstrap(boolean b)
327 treeCanvas.setShowBootstrap(b);
328 bootstrapMenu.setSelected(b);
331 public void showPlaceholders(boolean b)
333 placeholdersMenu.setState(b);
334 treeCanvas.setMarkPlaceholders(b);
340 * @return DOCUMENT ME!
342 public TreeModel getTree()
354 public void textbox_actionPerformed(ActionEvent e)
356 CutAndPasteTransfer cap = new CutAndPasteTransfer();
358 String newTitle = getPanelTitle();
360 NewickFile fout = new NewickFile(tree.getTopNode());
363 cap.setText(fout.print(tree.hasBootstrap(), tree.hasDistances(),
364 tree.hasRootDistance()));
365 Desktop.addInternalFrame(cap, newTitle, 500, 100);
366 } catch (OutOfMemoryError oom)
368 new OOMWarning("generating newick tree file", oom);
381 public void saveAsNewick_actionPerformed(ActionEvent e)
383 JalviewFileChooser chooser = new JalviewFileChooser(
384 jalview.bin.Cache.getProperty("LAST_DIRECTORY"));
385 chooser.setFileView(new JalviewFileView());
386 chooser.setDialogTitle(
387 MessageManager.getString("label.save_tree_as_newick"));
388 chooser.setToolTipText(MessageManager.getString("action.save"));
390 int value = chooser.showSaveDialog(null);
392 if (value == JalviewFileChooser.APPROVE_OPTION)
394 String choice = chooser.getSelectedFile().getPath();
395 jalview.bin.Cache.setProperty("LAST_DIRECTORY",
396 chooser.getSelectedFile().getParent());
400 jalview.io.NewickFile fout = new jalview.io.NewickFile(
402 String output = fout.print(tree.hasBootstrap(), tree.hasDistances(),
403 tree.hasRootDistance());
404 java.io.PrintWriter out = new java.io.PrintWriter(
405 new java.io.FileWriter(choice));
408 } catch (Exception ex)
410 ex.printStackTrace();
422 public void printMenu_actionPerformed(ActionEvent e)
424 // Putting in a thread avoids Swing painting problems
425 treeCanvas.startPrinting();
429 public void originalSeqData_actionPerformed(ActionEvent e)
431 AlignmentView originalData = tree.getOriginalData();
432 if (originalData == null)
434 jalview.bin.Cache.log.info(
435 "Unexpected call to originalSeqData_actionPerformed - should have hidden this menu action.");
438 // decide if av alignment is sufficiently different to original data to
439 // warrant a new window to be created
440 // create new alignmnt window with hidden regions (unhiding hidden regions
441 // yields unaligned seqs)
442 // or create a selection box around columns in alignment view
443 // test Alignment(SeqCigar[])
447 // we try to get the associated view's gap character
448 // but this may fail if the view was closed...
449 gc = av.getGapCharacter();
451 } catch (Exception ex)
455 Object[] alAndColsel = originalData.getAlignmentAndHiddenColumns(gc);
457 if (alAndColsel != null && alAndColsel[0] != null)
459 // AlignmentOrder origorder = new AlignmentOrder(alAndColsel[0]);
461 AlignmentI al = new Alignment((SequenceI[]) alAndColsel[0]);
462 AlignmentI dataset = (av != null && av.getAlignment() != null)
463 ? av.getAlignment().getDataset()
467 al.setDataset(dataset);
473 AlignFrame af = new AlignFrame(al, (HiddenColumns) alAndColsel[1],
474 AlignFrame.DEFAULT_WIDTH, AlignFrame.DEFAULT_HEIGHT);
476 // >>>This is a fix for the moment, until a better solution is
478 // af.getFeatureRenderer().transferSettings(alignFrame.getFeatureRenderer());
480 // af.addSortByOrderMenuItem(ServiceName + " Ordering",
483 Desktop.addInternalFrame(af, MessageManager.formatMessage(
484 "label.original_data_for_params", new Object[]
485 { this.title }), AlignFrame.DEFAULT_WIDTH,
486 AlignFrame.DEFAULT_HEIGHT);
498 public void fitToWindow_actionPerformed(ActionEvent e)
500 treeCanvas.fitToWindow = fitToWindow.isSelected();
505 * sort the associated alignment view by the current tree.
510 public void sortByTree_actionPerformed()
513 if (treeCanvas.applyToAllViews)
515 final ArrayList<CommandI> commands = new ArrayList<>();
516 for (AlignmentPanel ap : PaintRefresher
517 .getAssociatedPanels(av.getSequenceSetId()))
519 commands.add(sortAlignmentIn(ap.av.getAlignPanel()));
521 av.getAlignPanel().alignFrame.addHistoryItem(new CommandI()
525 public void undoCommand(AlignmentI[] views)
527 for (CommandI tsort : commands)
529 tsort.undoCommand(views);
536 return commands.size();
540 public String getDescription()
542 return "Tree Sort (many views)";
546 public void doCommand(AlignmentI[] views)
549 for (CommandI tsort : commands)
551 tsort.doCommand(views);
555 for (AlignmentPanel ap : PaintRefresher
556 .getAssociatedPanels(av.getSequenceSetId()))
558 // ensure all the alignFrames refresh their GI after adding an undo item
559 ap.alignFrame.updateEditMenuBar();
564 treeCanvas.ap.alignFrame
565 .addHistoryItem(sortAlignmentIn(treeCanvas.ap));
570 public CommandI sortAlignmentIn(AlignmentPanel ap)
572 AlignmentViewport viewport = ap.av;
573 SequenceI[] oldOrder = viewport.getAlignment().getSequencesArray();
574 AlignmentSorter.sortByTree(viewport.getAlignment(), tree);
576 undo = new OrderCommand("Tree Sort", oldOrder, viewport.getAlignment());
578 ap.paintAlignment(true);
589 public void font_actionPerformed(ActionEvent e)
591 if (treeCanvas == null)
596 new FontChooser(this);
599 public Font getTreeFont()
601 return treeCanvas.font;
604 public void setTreeFont(Font f)
606 if (treeCanvas != null)
608 treeCanvas.setFont(f);
619 public void distanceMenu_actionPerformed(ActionEvent e)
621 treeCanvas.setShowDistances(distanceMenu.isSelected());
631 public void bootstrapMenu_actionPerformed(ActionEvent e)
633 treeCanvas.setShowBootstrap(bootstrapMenu.isSelected());
643 public void placeholdersMenu_actionPerformed(ActionEvent e)
645 treeCanvas.setMarkPlaceholders(placeholdersMenu.isSelected());
655 public void epsTree_actionPerformed(ActionEvent e)
657 boolean accurateText = true;
659 String renderStyle = jalview.bin.Cache.getDefault("EPS_RENDERING",
662 // If we need to prompt, and if the GUI is visible then
663 // Prompt for EPS rendering style
664 if (renderStyle.equalsIgnoreCase("Prompt each time")
665 && !(System.getProperty("java.awt.headless") != null && System
666 .getProperty("java.awt.headless").equals("true")))
668 EPSOptions eps = new EPSOptions();
669 renderStyle = eps.getValue();
671 if (renderStyle == null || eps.cancelled)
678 if (renderStyle.equalsIgnoreCase("text"))
680 accurateText = false;
683 int width = treeCanvas.getWidth();
684 int height = treeCanvas.getHeight();
688 JalviewFileChooser chooser = new JalviewFileChooser(
689 ImageMaker.EPS_EXTENSION, ImageMaker.EPS_EXTENSION);
690 chooser.setFileView(new JalviewFileView());
691 chooser.setDialogTitle(
692 MessageManager.getString("label.create_eps_from_tree"));
693 chooser.setToolTipText(MessageManager.getString("action.save"));
695 int value = chooser.showSaveDialog(this);
697 if (value != JalviewFileChooser.APPROVE_OPTION)
702 Cache.setProperty("LAST_DIRECTORY",
703 chooser.getSelectedFile().getParent());
705 FileOutputStream out = new FileOutputStream(
706 chooser.getSelectedFile());
707 EpsGraphics2D pg = new EpsGraphics2D("Tree", out, 0, 0, width,
710 pg.setAccurateTextMode(accurateText);
712 treeCanvas.draw(pg, width, height);
716 } catch (Exception ex)
718 ex.printStackTrace();
729 public void pngTree_actionPerformed(ActionEvent e)
731 int width = treeCanvas.getWidth();
732 int height = treeCanvas.getHeight();
736 JalviewFileChooser chooser = new JalviewFileChooser(
737 ImageMaker.PNG_EXTENSION, ImageMaker.PNG_DESCRIPTION);
739 chooser.setFileView(new jalview.io.JalviewFileView());
740 chooser.setDialogTitle(
741 MessageManager.getString("label.create_png_from_tree"));
742 chooser.setToolTipText(MessageManager.getString("action.save"));
744 int value = chooser.showSaveDialog(this);
746 if (value != jalview.io.JalviewFileChooser.APPROVE_OPTION)
751 jalview.bin.Cache.setProperty("LAST_DIRECTORY",
752 chooser.getSelectedFile().getParent());
754 FileOutputStream out = new FileOutputStream(
755 chooser.getSelectedFile());
757 BufferedImage bi = new BufferedImage(width, height,
758 BufferedImage.TYPE_INT_RGB);
759 Graphics png = bi.getGraphics();
761 treeCanvas.draw(png, width, height);
763 ImageIO.write(bi, "png", out);
765 } catch (Exception ex)
767 ex.printStackTrace();
772 * change node labels to the annotation referred to by labelClass TODO:
773 * promote to a datamodel modification that can be undone TODO: make argument
774 * one case of a generic transformation function ie { undoStep = apply(Tree,
775 * TransformFunction)};
779 public void changeNames(final String labelClass)
781 tree.applyToNodes(new NodeTransformI()
785 public void transform(BinaryNode node)
787 if (node instanceof SequenceNode
788 && !((SequenceNode) node).isPlaceholder()
789 && !((SequenceNode) node).isDummy())
791 String newname = null;
792 SequenceI sq = (SequenceI) ((SequenceNode) node).element();
795 // search dbrefs, features and annotation
796 DBRefEntry[] refs = jalview.util.DBRefUtils
797 .selectRefs(sq.getDBRefs(), new String[]
798 { labelClass.toUpperCase() });
801 for (int i = 0; i < refs.length; i++)
805 newname = new String(refs[i].getAccessionId());
809 newname = newname + "; " + refs[i].getAccessionId();
815 List<SequenceFeature> features = sq.getFeatures()
816 .getPositionalFeatures(labelClass);
817 for (SequenceFeature feature : features)
821 newname = feature.getDescription();
825 newname = newname + "; " + feature.getDescription();
832 // String oldname = ((SequenceNode) node).getName();
833 // TODO : save oldname in the undo object for this modification.
834 ((SequenceNode) node).setName(newname);
842 * Formats a localised title for the tree panel, like
844 * Neighbour Joining Using BLOSUM62
846 * For a tree loaded from file, just uses the file name
850 public String getPanelTitle() // to be moved/fixed
852 if (treeTitle != null)
859 * i18n description of Neighbour Joining or Average Distance method
861 String treecalcnm = MessageManager
862 .getString("label.tree_calc_" + treeType.toLowerCase());
865 * short score model name (long description can be too long)
867 String smn = substitutionMatrix;
870 * put them together as <method> Using <model>
872 final String ttl = MessageManager
873 .formatMessage("label.treecalc_title", treecalcnm, smn);