X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=src%2Fjalview%2Fgui%2FPCAPanel.java;h=576f3b2954a7fc07a70832fcd6a2c612158309a9;hb=HEAD;hp=dbb014abe4a7740d7aa09023bb14ab78e20ad157;hpb=fab0afc9e1e7a5ca460f0cbd48545536f989a435;p=jalview.git diff --git a/src/jalview/gui/PCAPanel.java b/src/jalview/gui/PCAPanel.java index dbb014a..576f3b2 100644 --- a/src/jalview/gui/PCAPanel.java +++ b/src/jalview/gui/PCAPanel.java @@ -20,23 +20,6 @@ */ package jalview.gui; -import jalview.analysis.scoremodels.ScoreModels; -import jalview.analysis.scoremodels.SimilarityParams; -import jalview.api.analysis.ScoreModelI; -import jalview.api.analysis.SimilarityParamsI; -import jalview.datamodel.Alignment; -import jalview.datamodel.AlignmentI; -import jalview.datamodel.AlignmentView; -import jalview.datamodel.HiddenColumns; -import jalview.datamodel.SequenceI; -import jalview.gui.ImageExporter.ImageWriterI; -import jalview.gui.JalviewColourChooser.ColourChooserListener; -import jalview.jbgui.GPCAPanel; -import jalview.util.ImageMaker; -import jalview.util.MessageManager; -import jalview.viewmodel.AlignmentViewport; -import jalview.viewmodel.PCAModel; - import java.awt.BorderLayout; import java.awt.Color; import java.awt.Dimension; @@ -49,56 +32,56 @@ import java.awt.print.PrinterException; import java.awt.print.PrinterJob; import javax.swing.ButtonGroup; -import javax.swing.JCheckBoxMenuItem; import javax.swing.JMenuItem; import javax.swing.JRadioButtonMenuItem; import javax.swing.event.InternalFrameAdapter; import javax.swing.event.InternalFrameEvent; +import jalview.analysis.scoremodels.ScoreModels; +import jalview.api.AlignViewportI; +import jalview.api.analysis.ScoreModelI; +import jalview.api.analysis.SimilarityParamsI; +import jalview.bin.Console; +import jalview.datamodel.Alignment; +import jalview.datamodel.AlignmentI; +import jalview.datamodel.AlignmentView; +import jalview.datamodel.HiddenColumns; +import jalview.datamodel.SequenceI; +import jalview.gui.ImageExporter.ImageWriterI; +import jalview.gui.JalviewColourChooser.ColourChooserListener; +import jalview.io.exceptions.ImageOutputException; +import jalview.jbgui.GPCAPanel; +import jalview.math.RotatableMatrix.Axis; +import jalview.util.ImageMaker; +import jalview.util.MessageManager; +import jalview.viewmodel.AlignmentViewport; +import jalview.viewmodel.PCAModel; + /** - * DOCUMENT ME! - * - * @author $author$ - * @version $Revision$ + * The panel holding the Principal Component Analysis 3-D visualisation */ public class PCAPanel extends GPCAPanel implements Runnable, IProgressIndicator { + private static final int MIN_WIDTH = 470; - private IProgressIndicator progressBar; + private static final int MIN_HEIGHT = 250; - RotatableCanvas rc; + private RotatableCanvas rc; AlignmentPanel ap; AlignmentViewport av; - PCAModel pcaModel; - - private static final int MIN_WIDTH = 470; + private PCAModel pcaModel; - private static final int MIN_HEIGHT = 250; + private int top = 0; - int top = 0; + private IProgressIndicator progressBar; private boolean working; /** - * Creates a new PCAPanel object using default score model and parameters - * - * @param alignPanel - */ - public PCAPanel(AlignmentPanel alignPanel) - { - this(alignPanel, - ScoreModels.getInstance() - .getDefaultModel( - !alignPanel.av.getAlignment().isNucleotide()) - .getName(), - SimilarityParams.SeqSpace); - } - - /** * Constructor given sequence data, a similarity (or distance) score model * name, and score calculation parameters * @@ -110,6 +93,7 @@ public class PCAPanel extends GPCAPanel SimilarityParamsI params) { super(); + this.setFrameIcon(null); this.av = alignPanel.av; this.ap = alignPanel; boolean nucleotide = av.getAlignment().isNucleotide(); @@ -140,14 +124,15 @@ public class PCAPanel extends GPCAPanel ScoreModelI scoreModel = ScoreModels.getInstance() .getScoreModel(modelName, ap); - pcaModel = new PCAModel(seqstrings, seqs, nucleotide, scoreModel, - params); + setPcaModel( + new PCAModel(seqstrings, seqs, nucleotide, scoreModel, params)); PaintRefresher.Register(this, av.getSequenceSetId()); - rc = new RotatableCanvas(alignPanel); - this.getContentPane().add(rc, BorderLayout.CENTER); - Thread worker = new Thread(this); - worker.start(); + setRotatableCanvas(new RotatableCanvas(alignPanel)); + this.getContentPane().add(getRotatableCanvas(), BorderLayout.CENTER); + + addKeyListener(getRotatableCanvas()); + validate(); } /** @@ -156,61 +141,17 @@ public class PCAPanel extends GPCAPanel */ protected void close_actionPerformed() { - pcaModel = null; - } - - /** - * Repopulate the options and actions under the score model menu when it is - * selected. Options will depend on whether 'nucleotide' or 'peptide' - * modelling is selected (and also possibly on whether any additional score - * models have been added). - */ - @Override - protected void scoreModel_menuSelected() - { - scoreModelMenu.removeAll(); - for (final ScoreModelI sm : ScoreModels.getInstance().getModels()) + setPcaModel(null); + if (this.rc != null) { - final String name = sm.getName(); - JCheckBoxMenuItem jm = new JCheckBoxMenuItem(name); - - /* - * if the score model doesn't provide a description, try to look one - * up in the text bundle, falling back on its name - */ - String tooltip = sm.getDescription(); - if (tooltip == null) - { - tooltip = MessageManager.getStringOrReturn("label.score_model_", - name); - } - jm.setToolTipText(tooltip); - jm.setSelected(pcaModel.getScoreModelName().equals(name)); - if ((pcaModel.isNucleotide() && sm.isDNA()) - || (!pcaModel.isNucleotide() && sm.isProtein())) - { - jm.addActionListener(new ActionListener() - { - @Override - public void actionPerformed(ActionEvent e) - { - if (!pcaModel.getScoreModelName().equals(name)) - { - ScoreModelI sm2 = ScoreModels.getInstance() - .getScoreModel(name, ap); - pcaModel.setScoreModel(sm2); - Thread worker = new Thread(PCAPanel.this); - worker.start(); - } - } - }); - scoreModelMenu.add(jm); - } + this.rc.sequencePoints = null; + this.rc.setAxisEndPoints(null); + this.rc = null; } } @Override - public void bgcolour_actionPerformed(ActionEvent e) + protected void bgcolour_actionPerformed() { String ttl = MessageManager.getString("label.select_background_colour"); ColourChooserListener listener = new ColourChooserListener() @@ -218,20 +159,21 @@ public class PCAPanel extends GPCAPanel @Override public void colourSelected(Color c) { - rc.bgColour = c; + rc.setBgColour(c); rc.repaint(); } }; - JalviewColourChooser.showColourChooser(this, ttl, rc.bgColour, + JalviewColourChooser.showColourChooser(this, ttl, rc.getBgColour(), listener); } /** - * DOCUMENT ME! + * Calculates the PCA and displays the results */ @Override public void run() { + working = true; long progId = System.currentTimeMillis(); IProgressIndicator progress = this; String message = MessageManager.getString("label.pca_recalculating"); @@ -241,21 +183,17 @@ public class PCAPanel extends GPCAPanel message = MessageManager.getString("label.pca_calculating"); } progress.setProgressBar(message, progId); - working = true; try { - calcSettings.setEnabled(false); - pcaModel.run(); - // //////////////// + getPcaModel().calculate(); + xCombobox.setSelectedIndex(0); yCombobox.setSelectedIndex(1); zCombobox.setSelectedIndex(2); - pcaModel.updateRc(rc); + getPcaModel().updateRc(getRotatableCanvas()); // rc.invalidate(); - nuclSetting.setSelected(pcaModel.isNucleotide()); - protSetting.setSelected(!pcaModel.isNucleotide()); - top = pcaModel.getTop(); + setTop(getPcaModel().getTop()); } catch (OutOfMemoryError er) { @@ -266,109 +204,69 @@ public class PCAPanel extends GPCAPanel { progress.setProgressBar("", progId); } - calcSettings.setEnabled(true); + repaint(); if (getParent() == null) { - addKeyListener(rc); - Desktop.addInternalFrame(this, MessageManager - .getString("label.principal_component_analysis"), 475, 450); + Desktop.addInternalFrame(this, + MessageManager.formatMessage("label.calc_title", "PCA", + getPcaModel().getScoreModelName()), + 475, 450); this.setMinimumSize(new Dimension(MIN_WIDTH, MIN_HEIGHT)); } working = false; } - @Override - protected void nuclSetting_actionPerfomed(ActionEvent arg0) - { - if (!pcaModel.isNucleotide()) - { - pcaModel.setNucleotide(true); - pcaModel.setScoreModel( - ScoreModels.getInstance().getDefaultModel(false)); - Thread worker = new Thread(this); - worker.start(); - } - - } - - @Override - protected void protSetting_actionPerfomed(ActionEvent arg0) - { - - if (pcaModel.isNucleotide()) - { - pcaModel.setNucleotide(false); - pcaModel.setScoreModel( - ScoreModels.getInstance().getDefaultModel(true)); - Thread worker = new Thread(this); - worker.start(); - } - } - /** - * DOCUMENT ME! + * Updates the PCA display after a change of component to use for x, y or z + * axis */ - void doDimensionChange() + @Override + protected void doDimensionChange() { - if (top == 0) + if (getTop() == 0) { return; } - int dim1 = top - xCombobox.getSelectedIndex(); - int dim2 = top - yCombobox.getSelectedIndex(); - int dim3 = top - zCombobox.getSelectedIndex(); - pcaModel.updateRcView(dim1, dim2, dim3); - rc.img = null; - rc.rotmat.setIdentity(); - rc.initAxes(); - rc.paint(rc.getGraphics()); - } - - /** - * DOCUMENT ME! - * - * @param e - * DOCUMENT ME! - */ - @Override - protected void xCombobox_actionPerformed(ActionEvent e) - { - doDimensionChange(); + int dim1 = getTop() - xCombobox.getSelectedIndex(); + int dim2 = getTop() - yCombobox.getSelectedIndex(); + int dim3 = getTop() - zCombobox.getSelectedIndex(); + getPcaModel().updateRcView(dim1, dim2, dim3); + getRotatableCanvas().resetView(); } /** - * DOCUMENT ME! + * Sets the selected checkbox item index for PCA dimension (1, 2, 3...) for + * the given axis (X/Y/Z) * - * @param e - * DOCUMENT ME! + * @param index + * @param axis */ - @Override - protected void yCombobox_actionPerformed(ActionEvent e) + public void setSelectedDimensionIndex(int index, Axis axis) { - doDimensionChange(); - } - - /** - * DOCUMENT ME! - * - * @param e - * DOCUMENT ME! - */ - @Override - protected void zCombobox_actionPerformed(ActionEvent e) - { - doDimensionChange(); + switch (axis) + { + case X: + xCombobox.setSelectedIndex(index); + break; + case Y: + yCombobox.setSelectedIndex(index); + break; + case Z: + zCombobox.setSelectedIndex(index); + break; + default: + } } @Override - public void outputValues_actionPerformed(ActionEvent e) + protected void outputValues_actionPerformed() { CutAndPasteTransfer cap = new CutAndPasteTransfer(); try { - cap.setText(pcaModel.getDetails()); + cap.setText(getPcaModel().getDetails()); Desktop.addInternalFrame(cap, MessageManager.getString("label.pca_details"), 500, 500); } catch (OutOfMemoryError oom) @@ -379,32 +277,35 @@ public class PCAPanel extends GPCAPanel } @Override - public void showLabels_actionPerformed(ActionEvent e) + protected void showLabels_actionPerformed() { - rc.showLabels(showLabels.getState()); + getRotatableCanvas().showLabels(showLabels.getState()); } @Override - public void print_actionPerformed(ActionEvent e) + protected void print_actionPerformed() { PCAPrinter printer = new PCAPrinter(); printer.start(); } + /** + * If available, shows the data which formed the inputs for the PCA as a new + * alignment + */ @Override - public void originalSeqData_actionPerformed(ActionEvent e) + public void originalSeqData_actionPerformed() { - // this was cut'n'pasted from the equivalent TreePanel method - we should - // make this an abstract function of all jalview analysis windows - if (pcaModel.getSeqtrings() == null) + // JAL-2647 disabled after load from project (until save to project done) + if (getPcaModel().getInputData() == null) { - jalview.bin.Cache.log.info( + Console.info( "Unexpected call to originalSeqData_actionPerformed - should have hidden this menu action."); return; } // decide if av alignment is sufficiently different to original data to // warrant a new window to be created - // create new alignmnt window with hidden regions (unhiding hidden regions + // create new alignment window with hidden regions (unhiding hidden regions // yields unaligned seqs) // or create a selection box around columns in alignment view // test Alignment(SeqCigar[]) @@ -417,8 +318,8 @@ public class PCAPanel extends GPCAPanel } catch (Exception ex) { } - ; - Object[] alAndColsel = pcaModel.getSeqtrings() + + Object[] alAndColsel = getPcaModel().getInputData() .getAlignmentAndHiddenColumns(gc); if (alAndColsel != null && alAndColsel[0] != null) @@ -500,11 +401,11 @@ public class PCAPanel extends GPCAPanel { pg.translate((int) pf.getImageableX(), (int) pf.getImageableY()); - rc.drawBackground(pg, rc.bgColour); - rc.drawScene(pg); - if (rc.drawAxes == true) + getRotatableCanvas().drawBackground(pg); + getRotatableCanvas().drawScene(pg); + if (getRotatableCanvas().drawAxes) { - rc.drawAxes(pg); + getRotatableCanvas().drawAxes(pg); } if (pi == 0) @@ -520,37 +421,49 @@ public class PCAPanel extends GPCAPanel public void makePCAImage(ImageMaker.TYPE type) { - int width = rc.getWidth(); - int height = rc.getHeight(); + int width = getRotatableCanvas().getWidth(); + int height = getRotatableCanvas().getHeight(); ImageWriterI writer = new ImageWriterI() { @Override public void exportImage(Graphics g) throws Exception { - rc.drawBackground(g, Color.black); - rc.drawScene(g); - if (rc.drawAxes) + RotatableCanvas canvas = getRotatableCanvas(); + canvas.drawBackground(g); + canvas.drawScene(g); + if (canvas.drawAxes) { - rc.drawAxes(g); + canvas.drawAxes(g); } } }; String pca = MessageManager.getString("label.pca"); ImageExporter exporter = new ImageExporter(writer, null, type, pca); - exporter.doExport(null, this, width, height, pca); + try + { + exporter.doExport(null, this, width, height, pca); + } catch (ImageOutputException ioex) + { + Console.error("Unexpected error whilst writing " + type.toString(), + ioex); + } } @Override - public void viewMenu_menuSelected() + protected void viewMenu_menuSelected() { buildAssociatedViewMenu(); } + /** + * Builds the menu showing the choice of possible views (for the associated + * sequence data) to which the PCA may be linked + */ void buildAssociatedViewMenu() { AlignmentPanel[] aps = PaintRefresher .getAssociatedPanels(av.getSequenceSetId()); - if (aps.length == 1 && rc.av == aps[0].av) + if (aps.length == 1 && getRotatableCanvas().av == aps[0].av) { associateViewsMenu.setVisible(false); return; @@ -568,22 +481,20 @@ public class PCAPanel extends GPCAPanel JRadioButtonMenuItem item; ButtonGroup buttonGroup = new ButtonGroup(); - int i, iSize = aps.length; - final PCAPanel thisPCAPanel = this; - for (i = 0; i < iSize; i++) + int iSize = aps.length; + + for (int i = 0; i < iSize; i++) { - final AlignmentPanel ap = aps[i]; - item = new JRadioButtonMenuItem(ap.av.getViewName(), ap.av == rc.av); + final AlignmentPanel panel = aps[i]; + item = new JRadioButtonMenuItem(panel.av.getViewName(), + panel.av == getRotatableCanvas().av); buttonGroup.add(item); item.addActionListener(new ActionListener() { @Override public void actionPerformed(ActionEvent evt) { - rc.applyToAllViews = false; - rc.av = ap.av; - rc.ap = ap; - PaintRefresher.Register(thisPCAPanel, ap.av.getSequenceSetId()); + selectAssociatedView(panel); } }); @@ -595,13 +506,13 @@ public class PCAPanel extends GPCAPanel buttonGroup.add(itemf); - itemf.setSelected(rc.applyToAllViews); + itemf.setSelected(getRotatableCanvas().isApplyToAllViews()); itemf.addActionListener(new ActionListener() { @Override public void actionPerformed(ActionEvent evt) { - rc.applyToAllViews = itemf.isSelected(); + getRotatableCanvas().setApplyToAllViews(itemf.isSelected()); } }); associateViewsMenu.add(itemf); @@ -616,12 +527,12 @@ public class PCAPanel extends GPCAPanel * ) */ @Override - protected void outputPoints_actionPerformed(ActionEvent e) + protected void outputPoints_actionPerformed() { CutAndPasteTransfer cap = new CutAndPasteTransfer(); try { - cap.setText(pcaModel.getPointsasCsv(false, + cap.setText(getPcaModel().getPointsasCsv(false, xCombobox.getSelectedIndex(), yCombobox.getSelectedIndex(), zCombobox.getSelectedIndex())); Desktop.addInternalFrame(cap, MessageManager @@ -642,12 +553,12 @@ public class PCAPanel extends GPCAPanel * .ActionEvent) */ @Override - protected void outputProjPoints_actionPerformed(ActionEvent e) + protected void outputProjPoints_actionPerformed() { CutAndPasteTransfer cap = new CutAndPasteTransfer(); try { - cap.setText(pcaModel.getPointsasCsv(true, + cap.setText(getPcaModel().getPointsasCsv(true, xCombobox.getSelectedIndex(), yCombobox.getSelectedIndex(), zCombobox.getSelectedIndex())); Desktop.addInternalFrame(cap, MessageManager.formatMessage( @@ -676,11 +587,11 @@ public class PCAPanel extends GPCAPanel // } // // JPanel progressPanel; - // Long lId = new Long(id); + // Long lId = Long.valueOf(id); // GridLayout layout = (GridLayout) statusPanel.getLayout(); // if (progressBars.get(lId) != null) // { - // progressPanel = (JPanel) progressBars.get(new Long(id)); + // progressPanel = (JPanel) progressBars.get(Long.valueOf(id)); // statusPanel.remove(progressPanel); // progressBars.remove(lId); // progressPanel = null; @@ -719,13 +630,14 @@ public class PCAPanel extends GPCAPanel final IProgressIndicatorHandler handler) { progressBar.registerHandler(id, handler); - // if (progressBarHandlers == null || !progressBars.contains(new Long(id))) + // if (progressBarHandlers == null || + // !progressBars.contains(Long.valueOf(id))) // { // throw new // Error(MessageManager.getString("error.call_setprogressbar_before_registering_handler")); // } - // progressBarHandlers.put(new Long(id), handler); - // final JPanel progressPanel = (JPanel) progressBars.get(new Long(id)); + // progressBarHandlers.put(Long.valueOf(id), handler); + // final JPanel progressPanel = (JPanel) progressBars.get(Long.valueOf(id)); // if (handler.canCancel()) // { // JButton cancel = new JButton( @@ -757,13 +669,13 @@ public class PCAPanel extends GPCAPanel } @Override - protected void resetButton_actionPerformed(ActionEvent e) + protected void resetButton_actionPerformed() { - int t = top; - top = 0; // ugly - prevents dimensionChanged events from being processed + int t = getTop(); + setTop(0); // ugly - prevents dimensionChanged events from being processed xCombobox.setSelectedIndex(0); yCombobox.setSelectedIndex(1); - top = t; + setTop(t); zCombobox.setSelectedIndex(2); } @@ -776,4 +688,94 @@ public class PCAPanel extends GPCAPanel { return working; } + + /** + * Answers the selected checkbox item index for PCA dimension for the X, Y or + * Z axis of the display + * + * @param axis + * @return + */ + public int getSelectedDimensionIndex(Axis axis) + { + switch (axis) + { + case X: + return xCombobox.getSelectedIndex(); + case Y: + return yCombobox.getSelectedIndex(); + default: + return zCombobox.getSelectedIndex(); + } + } + + public void setShowLabels(boolean show) + { + showLabels.setSelected(show); + } + + /** + * Sets the input data used to calculate the PCA. This is provided for + * 'restore from project', which does not currently support this (AL-2647), so + * sets the value to null, and hides the menu option for "Input Data...". J + * + * @param data + */ + public void setInputData(AlignmentView data) + { + getPcaModel().setInputData(data); + originalSeqData.setVisible(data != null); + } + + public AlignViewportI getAlignViewport() + { + return av; + } + + public PCAModel getPcaModel() + { + return pcaModel; + } + + public void setPcaModel(PCAModel pcaModel) + { + this.pcaModel = pcaModel; + } + + public RotatableCanvas getRotatableCanvas() + { + return rc; + } + + public void setRotatableCanvas(RotatableCanvas rc) + { + this.rc = rc; + } + + public int getTop() + { + return top; + } + + public void setTop(int top) + { + this.top = top; + } + + /** + * set the associated view for this PCA. + * + * @param panel + */ + public void selectAssociatedView(AlignmentPanel panel) + { + getRotatableCanvas().setApplyToAllViews(false); + + ap = panel; + av = panel.av; + + getRotatableCanvas().av = panel.av; + getRotatableCanvas().ap = panel; + PaintRefresher.Register(PCAPanel.this, panel.av.getSequenceSetId()); + } }