src/jalview/appletgui/PCAPanel.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.scoremodels.ScoreModels;
  24 import jalview.analysis.scoremodels.SimilarityParams;
  25 import jalview.api.analysis.ScoreModelI;
  26 import jalview.datamodel.Alignment;
  27 import jalview.datamodel.AlignmentView;
  28 import jalview.datamodel.ColumnSelection;
  29 import jalview.datamodel.SeqCigar;
  30 import jalview.datamodel.SequenceI;
  31 import jalview.util.MessageManager;
  32 import jalview.viewmodel.PCAModel;
  33
  34 import java.awt.BorderLayout;
  35 import java.awt.Button;
  36 import java.awt.CheckboxMenuItem;
  37 import java.awt.Choice;
  38 import java.awt.Color;
  39 import java.awt.FlowLayout;
  40 import java.awt.Frame;
  41 import java.awt.Label;
  42 import java.awt.Menu;
  43 import java.awt.MenuBar;
  44 import java.awt.MenuItem;
  45 import java.awt.Panel;
  46 import java.awt.event.ActionEvent;
  47 import java.awt.event.ActionListener;
  48 import java.awt.event.ItemEvent;
  49 import java.awt.event.ItemListener;
  50
  51 public class PCAPanel extends EmbmenuFrame implements Runnable,
  52         ActionListener, ItemListener
  53 {
  54   RotatableCanvas rc;
  55
  56   AlignViewport av;
  57
  58   PCAModel pcaModel;
  59
  60   int top = 0;
  61
  62   public PCAPanel(AlignViewport viewport)
  63   {
  64     try
  65     {
  66       jbInit();
  67     } catch (Exception e)
  68     {
  69       e.printStackTrace();
  70     }
  71
  72     for (int i = 1; i < 8; i++)
  73     {
  74       xCombobox.addItem("dim " + i);
  75       yCombobox.addItem("dim " + i);
  76       zCombobox.addItem("dim " + i);
  77     }
  78
  79     this.av = viewport;
  80     boolean selected = viewport.getSelectionGroup() != null
  81             && viewport.getSelectionGroup().getSize() > 0;
  82     AlignmentView seqstrings = viewport.getAlignmentView(selected);
  83     boolean nucleotide = viewport.getAlignment().isNucleotide();
  84     SequenceI[] seqs;
  85     if (!selected)
  86     {
  87       seqs = viewport.getAlignment().getSequencesArray();
  88     }
  89     else
  90     {
  91       seqs = viewport.getSelectionGroup().getSequencesInOrder(viewport.getAlignment());
  92     }
  93     SeqCigar sq[] = seqstrings.getSequences();
  94     int length = sq[0].getWidth();
  95
  96     for (int i = 0; i < seqs.length; i++)
  97     {
  98       if (sq[i].getWidth() != length)
  99       {
 100         System.out
 101                 .println("Sequences must be equal length for PCA analysis");
 102         return;
 103       }
 104     }
 105
 106     ScoreModelI scoreModel = ScoreModels.getInstance().getDefaultModel(
 107             !nucleotide);
 108     pcaModel = new PCAModel(seqstrings, seqs, nucleotide,
 109  scoreModel,
 110             SimilarityParams.SeqSpace);
 111
 112     rc = new RotatableCanvas(viewport);
 113     embedMenuIfNeeded(rc);
 114     add(rc, BorderLayout.CENTER);
 115
 116     jalview.bin.JalviewLite.addFrame(this,
 117             MessageManager.getString("label.principal_component_analysis"),
 118             475, 400);
 119
 120     Thread worker = new Thread(this);
 121     worker.start();
 122   }
 123
 124   /**
 125    * DOCUMENT ME!
 126    */
 127   @Override
 128   public void run()
 129   {
 130     // TODO progress indicator
 131     calcSettings.setEnabled(false);
 132     rc.setEnabled(false);
 133     try
 134     {
 135       nuclSetting.setState(pcaModel.isNucleotide());
 136       protSetting.setState(!pcaModel.isNucleotide());
 137       pcaModel.run();
 138       // ////////////////
 139       xCombobox.select(0);
 140       yCombobox.select(1);
 141       zCombobox.select(2);
 142
 143       pcaModel.updateRc(rc);
 144       // rc.invalidate();
 145       top = pcaModel.getTop();
 146     } catch (OutOfMemoryError x)
 147     {
 148       System.err.println("Out of memory when calculating PCA.");
 149       return;
 150     }
 151     calcSettings.setEnabled(true);
 152
 153     // TODO revert progress indicator
 154     rc.setEnabled(true);
 155     rc.repaint();
 156     this.repaint();
 157   }
 158
 159   void doDimensionChange()
 160   {
 161     if (top == 0)
 162     {
 163       return;
 164     }
 165
 166     int dim1 = top - xCombobox.getSelectedIndex();
 167     int dim2 = top - yCombobox.getSelectedIndex();
 168     int dim3 = top - zCombobox.getSelectedIndex();
 169     pcaModel.updateRcView(dim1, dim2, dim3);
 170     rc.img = null;
 171     rc.rotmat.setIdentity();
 172     rc.initAxes();
 173     rc.paint(rc.getGraphics());
 174   }
 175
 176   @Override
 177   public void actionPerformed(ActionEvent evt)
 178   {
 179     if (evt.getSource() == inputData)
 180     {
 181       showOriginalData();
 182     }
 183     if (evt.getSource() == resetButton)
 184     {
 185       xCombobox.select(0);
 186       yCombobox.select(1);
 187       zCombobox.select(2);
 188       doDimensionChange();
 189     }
 190     if (evt.getSource() == values)
 191     {
 192       values_actionPerformed();
 193     }
 194   }
 195
 196   @Override
 197   public void itemStateChanged(ItemEvent evt)
 198   {
 199     if (evt.getSource() == xCombobox)
 200     {
 201       xCombobox_actionPerformed();
 202     }
 203     else if (evt.getSource() == yCombobox)
 204     {
 205       yCombobox_actionPerformed();
 206     }
 207     else if (evt.getSource() == zCombobox)
 208     {
 209       zCombobox_actionPerformed();
 210     }
 211     else if (evt.getSource() == labels)
 212     {
 213       labels_itemStateChanged(evt);
 214     }
 215     else if (evt.getSource() == nuclSetting)
 216     {
 217       if (!pcaModel.isNucleotide())
 218       {
 219         pcaModel.setNucleotide(true);
 220         new Thread(this).start();
 221       }
 222     }
 223     else if (evt.getSource() == protSetting)
 224     {
 225       if (pcaModel.isNucleotide())
 226       {
 227         pcaModel.setNucleotide(false);
 228         new Thread(this).start();
 229       }
 230     }
 231   }
 232
 233   protected void xCombobox_actionPerformed()
 234   {
 235     doDimensionChange();
 236   }
 237
 238   protected void yCombobox_actionPerformed()
 239   {
 240     doDimensionChange();
 241   }
 242
 243   protected void zCombobox_actionPerformed()
 244   {
 245     doDimensionChange();
 246   }
 247
 248   public void values_actionPerformed()
 249   {
 250
 251     CutAndPasteTransfer cap = new CutAndPasteTransfer(false, null);
 252     Frame frame = new Frame();
 253     frame.add(cap);
 254     jalview.bin.JalviewLite.addFrame(frame,
 255             MessageManager.getString("label.pca_details"), 500, 500);
 256
 257     cap.setText(pcaModel.getDetails());
 258   }
 259
 260   void showOriginalData()
 261   {
 262     // decide if av alignment is sufficiently different to original data to
 263     // warrant a new window to be created
 264     // create new alignmnt window with hidden regions (unhiding hidden regions
 265     // yields unaligned seqs)
 266     // or create a selection box around columns in alignment view
 267     // test Alignment(SeqCigar[])
 268     char gc = '-';
 269     try
 270     {
 271       // we try to get the associated view's gap character
 272       // but this may fail if the view was closed...
 273       gc = av.getGapCharacter();
 274     } catch (Exception ex)
 275     {
 276     }
 277     ;
 278     Object[] alAndColsel = pcaModel.getSeqtrings()
 279             .getAlignmentAndColumnSelection(gc);
 280
 281     if (alAndColsel != null && alAndColsel[0] != null)
 282     {
 283       Alignment al = new Alignment((SequenceI[]) alAndColsel[0]);
 284       AlignFrame af = new AlignFrame(al, av.applet,
 285               "Original Data for PCA", false);
 286
 287       af.viewport.setHiddenColumns((ColumnSelection) alAndColsel[1]);
 288     }
 289   }
 290
 291   public void labels_itemStateChanged(ItemEvent itemEvent)
 292   {
 293     rc.showLabels(labels.getState());
 294   }
 295
 296   Panel jPanel2 = new Panel();
 297
 298   Label jLabel1 = new Label();
 299
 300   Label jLabel2 = new Label();
 301
 302   Label jLabel3 = new Label();
 303
 304   protected Choice xCombobox = new Choice();
 305
 306   protected Choice yCombobox = new Choice();
 307
 308   protected Choice zCombobox = new Choice();
 309
 310   protected Button resetButton = new Button();
 311
 312   FlowLayout flowLayout1 = new FlowLayout();
 313
 314   BorderLayout borderLayout1 = new BorderLayout();
 315
 316   MenuBar menuBar1 = new MenuBar();
 317
 318   Menu menu1 = new Menu();
 319
 320   Menu menu2 = new Menu();
 321
 322   Menu calcSettings = new Menu();
 323
 324   protected CheckboxMenuItem labels = new CheckboxMenuItem();
 325
 326   protected CheckboxMenuItem protSetting = new CheckboxMenuItem();
 327
 328   protected CheckboxMenuItem nuclSetting = new CheckboxMenuItem();
 329
 330   MenuItem values = new MenuItem();
 331
 332   MenuItem inputData = new MenuItem();
 333
 334   private void jbInit() throws Exception
 335   {
 336     this.setLayout(borderLayout1);
 337     jPanel2.setLayout(flowLayout1);
 338     jLabel1.setFont(new java.awt.Font("Verdana", 0, 12));
 339     jLabel1.setText("x=");
 340     jLabel2.setFont(new java.awt.Font("Verdana", 0, 12));
 341     jLabel2.setText("y=");
 342     jLabel3.setFont(new java.awt.Font("Verdana", 0, 12));
 343     jLabel3.setText("z=");
 344     jPanel2.setBackground(Color.white);
 345     zCombobox.setFont(new java.awt.Font("Verdana", 0, 12));
 346     zCombobox.addItemListener(this);
 347     yCombobox.setFont(new java.awt.Font("Verdana", 0, 12));
 348     yCombobox.addItemListener(this);
 349     xCombobox.setFont(new java.awt.Font("Verdana", 0, 12));
 350     xCombobox.addItemListener(this);
 351     resetButton.setFont(new java.awt.Font("Verdana", 0, 12));
 352     resetButton.setLabel(MessageManager.getString("action.reset"));
 353     resetButton.addActionListener(this);
 354     this.setMenuBar(menuBar1);
 355     menu1.setLabel(MessageManager.getString("action.file"));
 356     menu2.setLabel(MessageManager.getString("action.view"));
 357     calcSettings.setLabel(MessageManager.getString("action.change_params"));
 358     labels.setLabel(MessageManager.getString("label.labels"));
 359     labels.addItemListener(this);
 360     values.setLabel(MessageManager.getString("label.output_values"));
 361     values.addActionListener(this);
 362     inputData.setLabel(MessageManager.getString("label.input_data"));
 363     nuclSetting.setLabel(MessageManager
 364             .getString("label.nucleotide_matrix"));
 365     nuclSetting.addItemListener(this);
 366     protSetting.setLabel(MessageManager.getString("label.protein_matrix"));
 367     protSetting.addItemListener(this);
 368     this.add(jPanel2, BorderLayout.SOUTH);
 369     jPanel2.add(jLabel1, null);
 370     jPanel2.add(xCombobox, null);
 371     jPanel2.add(jLabel2, null);
 372     jPanel2.add(yCombobox, null);
 373     jPanel2.add(jLabel3, null);
 374     jPanel2.add(zCombobox, null);
 375     jPanel2.add(resetButton, null);
 376     menuBar1.add(menu1);
 377     menuBar1.add(menu2);
 378     menuBar1.add(calcSettings);
 379     menu2.add(labels);
 380     menu1.add(values);
 381     menu1.add(inputData);
 382     calcSettings.add(nuclSetting);
 383     calcSettings.add(protSetting);
 384     inputData.addActionListener(this);
 385   }
 386
 387 }