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 java.awt.event.ActionEvent;
24 import java.awt.event.ActionListener;
25 import java.awt.event.ItemEvent;
26 import java.awt.event.ItemListener;
27 import java.io.BufferedReader;
29 import java.io.FileOutputStream;
30 import java.io.FileReader;
31 import java.io.IOException;
32 import java.io.PrintWriter;
33 import java.util.ArrayList;
34 import java.util.List;
35 import java.util.Vector;
37 import javax.swing.JCheckBoxMenuItem;
38 import javax.swing.JColorChooser;
39 import javax.swing.JInternalFrame;
40 import javax.swing.JMenu;
41 import javax.swing.JMenuItem;
42 import javax.swing.JOptionPane;
43 import javax.swing.event.InternalFrameAdapter;
44 import javax.swing.event.InternalFrameEvent;
45 import javax.swing.event.MenuEvent;
46 import javax.swing.event.MenuListener;
48 import jalview.bin.Cache;
49 import jalview.datamodel.Alignment;
50 import jalview.datamodel.AlignmentI;
51 import jalview.datamodel.ColumnSelection;
52 import jalview.datamodel.PDBEntry;
53 import jalview.datamodel.SequenceI;
54 import jalview.ext.rbvi.chimera.JalviewChimeraBinding;
55 import jalview.io.AppletFormatAdapter;
56 import jalview.io.JalviewFileChooser;
57 import jalview.io.JalviewFileView;
58 import jalview.schemes.BuriedColourScheme;
59 import jalview.schemes.ColourSchemeI;
60 import jalview.schemes.HelixColourScheme;
61 import jalview.schemes.HydrophobicColourScheme;
62 import jalview.schemes.PurinePyrimidineColourScheme;
63 import jalview.schemes.StrandColourScheme;
64 import jalview.schemes.TaylorColourScheme;
65 import jalview.schemes.TurnColourScheme;
66 import jalview.schemes.ZappoColourScheme;
67 import jalview.structures.models.AAStructureBindingModel;
68 import jalview.util.MessageManager;
69 import jalview.util.Platform;
70 import jalview.ws.dbsources.Pdb;
73 * GUI elements for handlnig an external chimera display
78 public class ChimeraViewFrame extends StructureViewerBase
80 private JalviewChimeraBinding jmb;
82 private boolean allChainsSelected = false;
84 private boolean alignAddedStructures = false;
87 * state flag for PDB retrieval thread
89 private boolean _started = false;
91 private boolean addingStructures = false;
93 private IProgressIndicator progressBar = null;
96 * pdb retrieval thread.
98 private Thread worker = null;
101 * Path to Chimera session file. This is set when an open Jalview/Chimera
102 * session is saved, or on restore from a Jalview project (if it holds the
103 * filename of any saved Chimera sessions).
105 private String chimeraSessionFile = null;
108 * Initialise menu options.
110 private void initMenus()
112 viewerActionMenu.setText(MessageManager.getString("label.chimera"));
113 viewerColour.setText(MessageManager
114 .getString("label.colour_with_chimera"));
115 viewerColour.setToolTipText(MessageManager
116 .getString("label.let_chimera_manage_structure_colours"));
117 helpItem.setText(MessageManager.getString("label.chimera_help"));
118 seqColour.setSelected(jmb.isColourBySequence());
119 viewerColour.setSelected(!jmb.isColourBySequence());
120 if (_colourwith == null)
122 _colourwith = new Vector<AlignmentPanel>();
124 if (_alignwith == null)
126 _alignwith = new Vector<AlignmentPanel>();
129 // save As not yet implemented
130 savemenu.setVisible(false);
132 ViewSelectionMenu seqColourBy = new ViewSelectionMenu(
133 MessageManager.getString("label.colour_by"), this, _colourwith,
137 public void itemStateChanged(ItemEvent e)
139 if (!seqColour.isSelected())
145 // update the Chimera display now.
146 seqColour_actionPerformed(null);
150 viewMenu.add(seqColourBy);
151 final ItemListener handler;
152 JMenu alpanels = new ViewSelectionMenu(
153 MessageManager.getString("label.superpose_with"), this,
154 _alignwith, handler = new ItemListener()
157 public void itemStateChanged(ItemEvent e)
159 alignStructs.setEnabled(_alignwith.size() > 0);
160 alignStructs.setToolTipText(MessageManager
162 "label.align_structures_using_linked_alignment_views",
164 { new Integer(_alignwith.size()).toString() }));
167 handler.itemStateChanged(null);
168 viewerActionMenu.add(alpanels);
169 viewerActionMenu.addMenuListener(new MenuListener()
173 public void menuSelected(MenuEvent e)
175 handler.itemStateChanged(null);
179 public void menuDeselected(MenuEvent e)
181 // TODO Auto-generated method stub
185 public void menuCanceled(MenuEvent e)
187 // TODO Auto-generated method stub
193 * add a single PDB structure to a new or existing Chimera view
200 public ChimeraViewFrame(PDBEntry pdbentry, SequenceI[] seq,
201 String[] chains, final AlignmentPanel ap)
204 progressBar = ap.alignFrame;
205 // ////////////////////////////////
206 // Is the pdb file already loaded?
207 String alreadyMapped = ap.getStructureSelectionManager()
208 .alreadyMappedToFile(pdbentry.getId());
210 if (alreadyMapped != null)
212 int option = JOptionPane.showInternalConfirmDialog(Desktop.desktop,
213 MessageManager.formatMessage(
214 "label.pdb_entry_is_already_displayed", new Object[]
215 { pdbentry.getId() }), MessageManager.formatMessage(
216 "label.map_sequences_to_visible_window", new Object[]
217 { pdbentry.getId() }),
218 JOptionPane.YES_NO_CANCEL_OPTION);
220 if (option == JOptionPane.CANCEL_OPTION)
224 if (option == JOptionPane.YES_OPTION)
226 // TODO : Fix multiple seq to one chain issue here.
227 ap.getStructureSelectionManager().setMapping(seq, chains,
228 alreadyMapped, AppletFormatAdapter.FILE);
229 if (ap.getSeqPanel().seqCanvas.fr != null)
231 ap.getSeqPanel().seqCanvas.fr.featuresAdded();
232 ap.paintAlignment(true);
235 // Now this ChimeraViewFrame is mapped to new sequences. We must add
236 // them to the existing array
237 JInternalFrame[] frames = Desktop.instance.getAllFrames();
239 for (JInternalFrame frame : frames)
241 if (frame instanceof ChimeraViewFrame)
243 final ChimeraViewFrame topView = ((ChimeraViewFrame) frame);
244 // JBPNOTE: this looks like a binding routine, rather than a gui
246 for (int pe = 0; pe < topView.jmb.getPdbCount(); pe++)
248 if (topView.jmb.getPdbEntry(pe).getFile()
252 topView.jmb.addSequence(pe, seq);
253 topView.addAlignmentPanel(ap);
254 // add it to the set used for colouring
255 topView.useAlignmentPanelForColourbyseq(ap);
256 topView.buildActionMenu();
257 ap.getStructureSelectionManager()
258 .sequenceColoursChanged(ap);
268 // /////////////////////////////////
269 // Check if there are other Chimera views involving this alignment
270 // and prompt user about adding this molecule to one of them
271 List<ChimeraViewFrame> existingViews = getChimeraWindowsFor(ap);
272 for (ChimeraViewFrame topView : existingViews)
274 // TODO: highlight topView in view somehow
275 int option = JOptionPane.showInternalConfirmDialog(Desktop.desktop,
276 MessageManager.formatMessage("label.add_pdbentry_to_view",
278 { pdbentry.getId(), topView.getTitle() }),
280 .getString("label.align_to_existing_structure_view"),
281 JOptionPane.YES_NO_CANCEL_OPTION);
282 if (option == JOptionPane.CANCEL_OPTION)
286 if (option == JOptionPane.YES_OPTION)
288 topView.useAlignmentPanelForSuperposition(ap);
289 topView.addStructure(pdbentry, seq, chains, true, ap.alignFrame);
293 // /////////////////////////////////
294 openNewChimera(ap, new PDBEntry[]
295 { pdbentry }, new SequenceI[][]
299 private void openNewChimera(AlignmentPanel ap, PDBEntry[] pdbentrys,
302 progressBar = ap.alignFrame;
303 jmb = new JalviewChimeraBindingModel(this,
304 ap.getStructureSelectionManager(), pdbentrys, seqs, null, null);
305 addAlignmentPanel(ap);
306 useAlignmentPanelForColourbyseq(ap);
307 if (pdbentrys.length > 1)
309 alignAddedStructures = true;
310 useAlignmentPanelForSuperposition(ap);
312 jmb.setColourBySequence(true);
313 setSize(400, 400); // probably should be a configurable/dynamic default here
316 addingStructures = false;
317 worker = new Thread(this);
320 this.addInternalFrameListener(new InternalFrameAdapter()
322 public void internalFrameClosing(InternalFrameEvent internalFrameEvent)
331 * create a new viewer containing several structures superimposed using the
338 public ChimeraViewFrame(AlignmentPanel ap, PDBEntry[] pe,
342 openNewChimera(ap, pe, seqs);
346 * Create a new viewer from saved session state data including Chimera session
349 * @param chimeraSession
354 * @param colourByChimera
355 * @param colourBySequence
357 public ChimeraViewFrame(String chimeraSession, AlignmentPanel alignPanel,
359 SequenceI[][] seqsArray, boolean colourByChimera,
360 boolean colourBySequence)
363 this.chimeraSessionFile = chimeraSession;
364 openNewChimera(alignPanel, pdbArray, seqsArray);
367 jmb.setColourBySequence(false);
368 seqColour.setSelected(false);
369 viewerColour.setSelected(true);
371 else if (colourBySequence)
373 jmb.setColourBySequence(true);
374 seqColour.setSelected(true);
375 viewerColour.setSelected(false);
380 * add a new structure (with associated sequences and chains) to this viewer,
381 * retrieving it if necessary first.
388 * if true, new structure(s) will be align using associated alignment
390 private void addStructure(final PDBEntry pdbentry, final SequenceI[] seq,
391 final String[] chains, final boolean b,
392 final IProgressIndicator alignFrame)
394 if (pdbentry.getFile() == null)
396 if (worker != null && worker.isAlive())
398 // a retrieval is in progress, wait around and add ourselves to the
400 new Thread(new Runnable()
404 while (worker != null && worker.isAlive() && _started)
408 Thread.sleep(100 + ((int) Math.random() * 100));
410 } catch (Exception e)
415 // and call ourselves again.
416 addStructure(pdbentry, seq, chains, b, alignFrame);
422 // otherwise, start adding the structure.
423 jmb.addSequenceAndChain(new PDBEntry[]
424 { pdbentry }, new SequenceI[][]
425 { seq }, new String[][]
427 addingStructures = true;
429 alignAddedStructures = b;
430 progressBar = alignFrame; // visual indication happens on caller frame.
431 (worker = new Thread(this)).start();
435 private List<ChimeraViewFrame> getChimeraWindowsFor(AlignmentPanel apanel)
437 List<ChimeraViewFrame> result = new ArrayList<ChimeraViewFrame>();
438 JInternalFrame[] frames = Desktop.instance.getAllFrames();
440 for (JInternalFrame frame : frames)
442 if (frame instanceof ChimeraViewFrame)
444 if (((StructureViewerBase) frame).isLinkedWith(apanel))
446 result.add((ChimeraViewFrame) frame);
454 * Launch Chimera. If we have a chimera session file name, send Chimera the
455 * command to open its saved session file.
459 jmb.setFinishedInit(false);
460 jalview.gui.Desktop.addInternalFrame(this, jmb.getViewerTitle("Chimera", true),
461 getBounds().width, getBounds().height);
464 * Pass an empty 'command' to launch Chimera
466 jmb.evalStateCommand("", false);
468 if (this.chimeraSessionFile != null)
470 boolean opened = jmb.openSession(chimeraSessionFile);
474 .println("An error occurred opening Chimera session file "
475 + chimeraSessionFile);
478 jmb.setFinishedInit(true);
480 jmb.startChimeraListener();
483 void setChainMenuItems(List<String> chainNames)
485 chainMenu.removeAll();
486 if (chainNames == null)
490 JMenuItem menuItem = new JMenuItem(
491 MessageManager.getString("label.all"));
492 menuItem.addActionListener(new ActionListener()
494 public void actionPerformed(ActionEvent evt)
496 allChainsSelected = true;
497 for (int i = 0; i < chainMenu.getItemCount(); i++)
499 if (chainMenu.getItem(i) instanceof JCheckBoxMenuItem)
501 ((JCheckBoxMenuItem) chainMenu.getItem(i)).setSelected(true);
505 allChainsSelected = false;
509 chainMenu.add(menuItem);
511 for (String chainName : chainNames)
513 menuItem = new JCheckBoxMenuItem(chainName, true);
514 menuItem.addItemListener(new ItemListener()
516 public void itemStateChanged(ItemEvent evt)
518 if (!allChainsSelected)
525 chainMenu.add(menuItem);
531 List<String> toshow = new ArrayList<String>();
532 for (int i = 0; i < chainMenu.getItemCount(); i++)
534 if (chainMenu.getItem(i) instanceof JCheckBoxMenuItem)
536 JCheckBoxMenuItem item = (JCheckBoxMenuItem) chainMenu.getItem(i);
537 if (item.isSelected())
539 toshow.add(item.getText());
543 jmb.centerViewer(toshow);
547 * Close down this instance of Jalview's Chimera viewer, giving the user the
548 * option to close the associated Chimera window (process). They may wish to
549 * keep it open until they have had an opportunity to save any work.
551 * @param closeChimera
552 * if true, close any linked Chimera process; if false, prompt first
554 public void closeViewer(boolean closeChimera)
556 if (jmb.isChimeraRunning())
560 String prompt = MessageManager.formatMessage(
561 "label.confirm_close_chimera", new Object[]
562 { jmb.getViewerTitle("Chimera", false) });
563 prompt = JvSwingUtils.wrapTooltip(true, prompt);
564 int confirm = JOptionPane.showConfirmDialog(this, prompt,
565 MessageManager.getString("label.close_viewer"),
566 JOptionPane.YES_NO_OPTION);
567 closeChimera = confirm == JOptionPane.YES_OPTION;
569 jmb.closeViewer(closeChimera);
571 setAlignmentPanel(null);
575 // TODO: check for memory leaks where instance isn't finalised because jmb
576 // holds a reference to the window
581 * Open any newly added PDB structures in Chimera, having first fetched data
582 * from PDB (if not already saved).
587 // todo - record which pdbids were successfully imported.
588 StringBuilder errormsgs = new StringBuilder(128);
589 StringBuilder files = new StringBuilder(128);
590 List<PDBEntry> filePDB = new ArrayList<PDBEntry>();
591 List<Integer> filePDBpos = new ArrayList<Integer>();
592 PDBEntry thePdbEntry = null;
595 String[] curfiles = jmb.getPdbFile(); // files currently in viewer
596 // TODO: replace with reference fetching/transfer code (validate PDBentry
598 for (int pi = 0; pi < jmb.getPdbCount(); pi++)
601 thePdbEntry = jmb.getPdbEntry(pi);
602 if (thePdbEntry.getFile() == null)
605 * Retrieve PDB data, save to file, attach to PDBEntry
607 file = fetchPdbFile(thePdbEntry);
610 errormsgs.append("'" + thePdbEntry.getId() + "' ");
616 * Got file already - ignore if already loaded in Chimera.
618 file = new File(thePdbEntry.getFile()).getAbsoluteFile()
620 if (curfiles != null && curfiles.length > 0)
622 addingStructures = true; // already files loaded.
623 for (int c = 0; c < curfiles.length; c++)
625 if (curfiles[c].equals(file))
635 filePDB.add(thePdbEntry);
636 filePDBpos.add(Integer.valueOf(pi));
637 files.append(" \"" + Platform.escapeString(file) + "\"");
640 } catch (OutOfMemoryError oomerror)
642 new OOMWarning("Retrieving PDB files: " + thePdbEntry.getId(),
644 } catch (Exception ex)
646 ex.printStackTrace();
647 errormsgs.append("When retrieving pdbfiles for '"
648 + thePdbEntry.getId() + "'");
650 if (errormsgs.length() > 0)
653 JOptionPane.showInternalMessageDialog(Desktop.desktop, MessageManager
654 .formatMessage("label.pdb_entries_couldnt_be_retrieved",
656 { errormsgs.toString() }), MessageManager
657 .getString("label.couldnt_load_file"),
658 JOptionPane.ERROR_MESSAGE);
661 if (files.length() > 0)
663 if (!addingStructures)
668 } catch (Exception ex)
670 Cache.log.error("Couldn't open Chimera viewer!", ex);
674 for (PDBEntry pe : filePDB)
677 if (pe.getFile() != null)
681 int pos = filePDBpos.get(num).intValue();
683 jmb.addSequence(pos, jmb.getSequence()[pos]);
684 File fl = new File(pe.getFile());
685 String protocol = AppletFormatAdapter.URL;
690 protocol = AppletFormatAdapter.FILE;
692 } catch (Throwable e)
695 // Explicitly map to the filename used by Chimera ;
696 // TODO: use pe.getId() instead of pe.getFile() ?
697 jmb.getSsm().setMapping(jmb.getSequence()[pos], null,
700 } catch (OutOfMemoryError oomerror)
703 "When trying to open and map structures from Chimera!",
705 } catch (Exception ex)
707 Cache.log.error("Couldn't open " + pe.getFile()
708 + " in Chimera viewer!", ex);
711 Cache.log.debug("File locations are " + files);
715 jmb.setFinishedInit(true);
716 jmb.setLoadingFromArchive(false);
718 // refresh the sequence colours for the new structure(s)
719 for (AlignmentPanel ap : _colourwith)
721 jmb.updateColours(ap);
723 // do superposition if asked to
724 if (alignAddedStructures)
726 new Thread(new Runnable()
730 alignStructs_withAllAlignPanels();
733 alignAddedStructures = false;
735 addingStructures = false;
742 * Fetch PDB data and save to a local file. Returns the full path to the file,
743 * or null if fetch fails.
745 * @param processingEntry
749 private String fetchPdbFile(PDBEntry processingEntry) throws Exception
751 String filePath = null;
752 Pdb pdbclient = new Pdb();
753 AlignmentI pdbseq = null;
754 String pdbid = processingEntry.getId();
755 long hdl = pdbid.hashCode() - System.currentTimeMillis();
756 if (progressBar != null)
758 progressBar.setProgressBar(MessageManager.formatMessage(
759 "status.fetching_pdb", new Object[]
764 pdbseq = pdbclient.getSequenceRecords(pdbid);
765 } catch (OutOfMemoryError oomerror)
767 new OOMWarning("Retrieving PDB id " + pdbid, oomerror);
770 if (progressBar != null)
777 .getString("label.state_completed"),
782 * If PDB data were saved and are not invalid (empty alignment), return the
785 if (pdbseq != null && pdbseq.getHeight() > 0)
787 // just use the file name from the first sequence's first PDBEntry
788 filePath = new File(pdbseq.getSequenceAt(0).getPDBId()
789 .elementAt(0).getFile()).getAbsolutePath();
790 processingEntry.setFile(filePath);
796 public void pdbFile_actionPerformed(ActionEvent actionEvent)
798 JalviewFileChooser chooser = new JalviewFileChooser(
799 jalview.bin.Cache.getProperty("LAST_DIRECTORY"));
801 chooser.setFileView(new JalviewFileView());
802 chooser.setDialogTitle(MessageManager.getString("label.save_pdb_file"));
803 chooser.setToolTipText(MessageManager.getString("action.save"));
805 int value = chooser.showSaveDialog(this);
807 if (value == JalviewFileChooser.APPROVE_OPTION)
809 BufferedReader in = null;
812 // TODO: cope with multiple PDB files in view
813 in = new BufferedReader(new FileReader(jmb.getPdbFile()[0]));
814 File outFile = chooser.getSelectedFile();
816 PrintWriter out = new PrintWriter(new FileOutputStream(outFile));
818 while ((data = in.readLine()) != null)
820 if (!(data.indexOf("<PRE>") > -1 || data.indexOf("</PRE>") > -1))
826 } catch (Exception ex)
828 ex.printStackTrace();
836 } catch (IOException e)
846 public void viewMapping_actionPerformed(ActionEvent actionEvent)
848 jalview.gui.CutAndPasteTransfer cap = new jalview.gui.CutAndPasteTransfer();
851 for (int pdbe = 0; pdbe < jmb.getPdbCount(); pdbe++)
853 cap.appendText(jmb.printMapping(jmb.getPdbEntry(pdbe).getFile()));
854 cap.appendText("\n");
856 } catch (OutOfMemoryError e)
859 "composing sequence-structure alignments for display in text box.",
864 jalview.gui.Desktop.addInternalFrame(cap,
865 MessageManager.getString("label.pdb_sequence_mapping"), 550,
870 public void eps_actionPerformed(ActionEvent e)
874 .getString("error.eps_generation_not_implemented"));
878 public void png_actionPerformed(ActionEvent e)
882 .getString("error.png_generation_not_implemented"));
886 public void viewerColour_actionPerformed(ActionEvent actionEvent)
888 if (viewerColour.isSelected())
890 // disable automatic sequence colouring.
891 jmb.setColourBySequence(false);
896 public void seqColour_actionPerformed(ActionEvent actionEvent)
898 jmb.setColourBySequence(seqColour.isSelected());
899 if (_colourwith == null)
901 _colourwith = new Vector<AlignmentPanel>();
903 if (jmb.isColourBySequence())
905 if (!jmb.isLoadingFromArchive())
907 if (_colourwith.size() == 0 && getAlignmentPanel() != null)
909 // Make the currently displayed alignment panel the associated view
910 _colourwith.add(getAlignmentPanel().alignFrame.alignPanel);
913 // Set the colour using the current view for the associated alignframe
914 for (AlignmentPanel ap : _colourwith)
916 jmb.colourBySequence(ap.av.isShowSequenceFeatures(), ap);
922 public void chainColour_actionPerformed(ActionEvent actionEvent)
924 chainColour.setSelected(true);
929 public void chargeColour_actionPerformed(ActionEvent actionEvent)
931 chargeColour.setSelected(true);
932 jmb.colourByCharge();
936 public void zappoColour_actionPerformed(ActionEvent actionEvent)
938 zappoColour.setSelected(true);
939 jmb.setJalviewColourScheme(new ZappoColourScheme());
943 public void taylorColour_actionPerformed(ActionEvent actionEvent)
945 taylorColour.setSelected(true);
946 jmb.setJalviewColourScheme(new TaylorColourScheme());
950 public void hydroColour_actionPerformed(ActionEvent actionEvent)
952 hydroColour.setSelected(true);
953 jmb.setJalviewColourScheme(new HydrophobicColourScheme());
957 public void helixColour_actionPerformed(ActionEvent actionEvent)
959 helixColour.setSelected(true);
960 jmb.setJalviewColourScheme(new HelixColourScheme());
964 public void strandColour_actionPerformed(ActionEvent actionEvent)
966 strandColour.setSelected(true);
967 jmb.setJalviewColourScheme(new StrandColourScheme());
971 public void turnColour_actionPerformed(ActionEvent actionEvent)
973 turnColour.setSelected(true);
974 jmb.setJalviewColourScheme(new TurnColourScheme());
978 public void buriedColour_actionPerformed(ActionEvent actionEvent)
980 buriedColour.setSelected(true);
981 jmb.setJalviewColourScheme(new BuriedColourScheme());
985 public void purinePyrimidineColour_actionPerformed(ActionEvent actionEvent)
987 setJalviewColourScheme(new PurinePyrimidineColourScheme());
991 public void userColour_actionPerformed(ActionEvent actionEvent)
993 userColour.setSelected(true);
994 new UserDefinedColours(this, null);
998 public void backGround_actionPerformed(ActionEvent actionEvent)
1000 java.awt.Color col = JColorChooser
1001 .showDialog(this, MessageManager
1002 .getString("label.select_backgroud_colour"), null);
1005 jmb.setBackgroundColour(col);
1010 public void showHelp_actionPerformed(ActionEvent actionEvent)
1014 jalview.util.BrowserLauncher
1015 .openURL("https://www.cgl.ucsf.edu/chimera/docs/UsersGuide");
1016 } catch (Exception ex)
1021 public void updateTitleAndMenus()
1023 if (jmb.fileLoadingError != null && jmb.fileLoadingError.length() > 0)
1028 setChainMenuItems(jmb.getChainNames());
1030 this.setTitle(jmb.getViewerTitle("Chimera", true));
1031 if (jmb.getPdbFile().length > 1 && jmb.getSequence().length > 1)
1033 viewerActionMenu.setVisible(true);
1035 if (!jmb.isLoadingFromArchive())
1037 seqColour_actionPerformed(null);
1045 * jalview.jbgui.GStructureViewer#alignStructs_actionPerformed(java.awt.event
1049 protected void alignStructs_actionPerformed(ActionEvent actionEvent)
1051 alignStructs_withAllAlignPanels();
1054 private void alignStructs_withAllAlignPanels()
1056 if (getAlignmentPanel() == null)
1061 if (_alignwith.size() == 0)
1063 _alignwith.add(getAlignmentPanel());
1068 AlignmentI[] als = new Alignment[_alignwith.size()];
1069 ColumnSelection[] alc = new ColumnSelection[_alignwith.size()];
1070 int[] alm = new int[_alignwith.size()];
1073 for (AlignmentPanel ap : _alignwith)
1075 als[a] = ap.av.getAlignment();
1077 alc[a++] = ap.av.getColumnSelection();
1079 jmb.superposeStructures(als, alm, alc);
1080 } catch (Exception e)
1082 StringBuffer sp = new StringBuffer();
1083 for (AlignmentPanel ap : _alignwith)
1085 sp.append("'" + ap.alignFrame.getTitle() + "' ");
1087 Cache.log.info("Couldn't align structures with the " + sp.toString()
1088 + "associated alignment panels.", e);
1094 public void setJalviewColourScheme(ColourSchemeI ucs)
1096 jmb.setJalviewColourScheme(ucs);
1103 * @return first alignment panel displaying given alignment, or the default
1106 public AlignmentPanel getAlignmentPanelFor(AlignmentI alignment)
1108 for (AlignmentPanel ap : getAllAlignmentPanels())
1110 if (ap.av.getAlignment() == alignment)
1115 return getAlignmentPanel();
1119 public AAStructureBindingModel getBinding()
1125 * Ask Chimera to save its session to the designated file path. Returns true
1126 * if successful, else false.
1131 public boolean saveSession(String filepath)
1133 boolean result = jmb.saveSession(filepath);
1136 this.chimeraSessionFile = filepath;
1142 * Returns the file path of the Chimera session file the last time it was
1143 * saved. If it was never saved, returns an empty string. There is no
1144 * guarantee that the Chimera session has not changed since it was saved.
1147 public String getStateInfo()
1149 return this.chimeraSessionFile;