Merge branch 'features/typed_annotations_calcId' into Release_2_8_2_Branch
[jalview.git] / src / jalview / ext / jmol / PDBFileWithJmol.java
1 /*
2  * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8.2)
3  * Copyright (C) 2014 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.ext.jmol;
22
23 import jalview.datamodel.AlignmentAnnotation;
24 import jalview.datamodel.Annotation;
25 import jalview.datamodel.PDBEntry;
26 import jalview.datamodel.Sequence;
27 import jalview.datamodel.SequenceI;
28 import jalview.io.AlignFile;
29 import jalview.io.FileParse;
30 import jalview.schemes.ResidueProperties;
31 import jalview.util.MessageManager;
32
33 import java.io.IOException;
34 import java.util.Hashtable;
35 import java.util.Map;
36
37 import org.jmol.api.JmolStatusListener;
38 import org.jmol.api.JmolViewer;
39 import org.jmol.constant.EnumCallback;
40 import org.jmol.modelset.Group;
41 import org.jmol.modelset.Model;
42 import org.jmol.modelset.ModelSet;
43 import org.jmol.modelset.Polymer;
44 import org.jmol.modelsetbio.BioPolymer;
45 import org.jmol.viewer.Viewer;
46 import org.openscience.jmol.app.JmolApp;
47
48 /**
49  * Import and process PDB files with Jmol
50  * 
51  * @author jprocter
52  * 
53  */
54 public class PDBFileWithJmol extends AlignFile implements
55         JmolStatusListener
56 {
57
58   JmolApp jmolApp = null;
59
60   Viewer viewer = null;
61
62   public PDBFileWithJmol(String inFile, String type) throws IOException
63   {
64     super(inFile, type);
65   }
66
67   public PDBFileWithJmol(FileParse fp) throws IOException
68   {
69     super(fp);
70   }
71
72   public PDBFileWithJmol()
73   {
74     // TODO Auto-generated constructor stub
75   }
76
77   /**
78    * create a headless jmol instance for dataprocessing
79    * 
80    * @return
81    */
82   private Viewer getJmolData()
83   {
84     if (viewer == null)
85     { // note that -o -n -x are all implied
86       jmolApp = new JmolApp();
87       jmolApp.isDataOnly = true;
88       jmolApp.haveConsole = false;
89       jmolApp.haveDisplay = false;
90       jmolApp.exitUponCompletion = true;
91       try
92       {
93         viewer = (Viewer) JmolViewer.allocateViewer(null, null, null, null,
94                 null, jmolApp.commandOptions, this);
95         viewer.setScreenDimension(jmolApp.startupWidth,
96                 jmolApp.startupHeight);
97         jmolApp.startViewer(viewer, null);
98       } catch (ClassCastException x)
99       {
100         throw new Error(MessageManager.formatMessage("error.jmol_version_not_compatible_with_jalview_version", new String[]{JmolViewer.getJmolVersion()}),
101                 x);
102       }
103     }
104     return viewer;
105   }
106
107   private void waitForScript(Viewer jmd)
108   {
109     while (jmd.isScriptExecuting())
110     {
111       try
112       {
113         Thread.sleep(50);
114
115       } catch (InterruptedException x)
116       {
117       }
118     }
119   }
120
121   /*
122    * (non-Javadoc)
123    * 
124    * @see jalview.io.AlignFile#parse()
125    */
126   @Override
127   public void parse() throws IOException
128   {
129     Viewer jmd = getJmolData();
130     jmd.openReader(getDataName(), getDataName(), getReader());
131     waitForScript(jmd);
132     if (jmd.getModelCount() > 0)
133     {
134       ModelSet ms = jmd.getModelSet();
135       String structs = ms.calculateStructures(null, true, false, true);
136       // System.out.println("Structs\n"+structs);
137       for (Model model : ms.getModels())
138       {
139         for (int _bp = 0, _bpc = model.getBioPolymerCount(); _bp < _bpc; _bp++)
140         {
141           Polymer bp = model.getBioPolymer(_bp);
142           if (bp instanceof BioPolymer)
143           {
144             BioPolymer biopoly = (BioPolymer) bp;
145             char _lastChainId = 0;
146             int[] groups = biopoly.getLeadAtomIndices();
147             Group[] bpgrp = biopoly.getGroups();
148             char seq[] = new char[groups.length], secstr[] = new char[groups.length], secstrcode[] = new char[groups.length];
149             int groupc = 0, len = 0, firstrnum = 1, lastrnum = 0;
150             do
151             {
152               if (groupc >= groups.length
153                       || ms.atoms[groups[groupc]].getChainID() != _lastChainId)
154               {
155                 if (len > 0)
156                 {
157                   boolean isNa = (biopoly.isDna() || biopoly.isRna());
158                   // normalise sequence from Jmol to jalview 
159                   int[] cinds = isNa ? ResidueProperties.nucleotideIndex : ResidueProperties.aaIndex;
160                   int nonGap = isNa ? ResidueProperties.maxNucleotideIndex
161                           : ResidueProperties.maxProteinIndex;
162                   char ngc = 'X';
163                   char newseq[] = new char[len];
164                   Annotation asecstr[] = new Annotation[len+firstrnum-1];
165                   for (int p = 0; p < len; p++)
166                   {
167                     newseq[p] = cinds[seq[p]] == nonGap ? ngc : seq[p];
168                     if (secstr[p] >= 'A' && secstr[p] <= 'z')
169                     {
170                       asecstr[p] = new Annotation("" + secstr[p], null,
171                               secstrcode[p], Float.NaN);
172                     }
173                   }
174                   SequenceI sq = new Sequence("" + getDataName() + "|"
175                           + model.getModelTitle() + "|" + _lastChainId,
176                           newseq, firstrnum, lastrnum);
177                   PDBEntry pdbe = new PDBEntry();
178                   pdbe.setFile(getDataName());
179                   pdbe.setId(getDataName());
180                   sq.addPDBId(pdbe);
181                   pdbe.setProperty(new Hashtable());
182                   pdbe.getProperty().put("CHAIN", "" + _lastChainId);
183                   // JAL-1533
184                   // Need to put the number of models for this polymer somewhere for Chimera/others to grab
185                   //                  pdbe.getProperty().put("PDBMODELS", biopoly.)
186                   seqs.add(sq);
187                   if (!isNa)
188                   {
189                     AlignmentAnnotation ann = new AlignmentAnnotation(
190                             "Secondary Structure",
191                             "Secondary Structure from PDB File", asecstr);
192                     ann.belowAlignment=true;
193                     ann.visible=true;
194                     ann.autoCalculated=false;
195                     ann.setCalcId(getClass().getName());
196                     sq.addAlignmentAnnotation(ann);
197                     ann.adjustForAlignment();
198                     ann.validateRangeAndDisplay();
199                     annotations.add(ann);
200                   }
201                 }
202                 len = 0;
203                 firstrnum = 1;
204                 lastrnum = 0;
205               }
206               if (groupc < groups.length)
207               {
208                 if (len == 0)
209                 {
210                   firstrnum = bpgrp[groupc].getResno();
211                   _lastChainId = bpgrp[groupc].getChainID();
212                 }
213                 else
214                 {
215                   lastrnum = bpgrp[groupc].getResno();
216                 }
217                 seq[len] = bpgrp[groupc].getGroup1();
218                 switch (bpgrp[groupc].getProteinStructureSubType())
219                 {
220                 case HELIX_310:
221                   if (secstr[len] == 0)
222                   {
223                     secstr[len] = '3';
224                   }
225                 case HELIX_ALPHA:
226                   if (secstr[len] == 0)
227                   {
228                     secstr[len] = 'H';
229                   }
230                 case HELIX_PI:
231                   if (secstr[len] == 0)
232                   {
233                     secstr[len] = 'P';
234                   }
235                 case HELIX:
236                   if (secstr[len] == 0)
237                   {
238                     secstr[len] = 'H';
239                   }
240                   secstrcode[len] = 'H';
241                   break;
242                 case SHEET:
243                   secstr[len] = 'E';
244                   secstrcode[len] = 'E';
245                   break;
246                 default:
247                   secstr[len] = 0;
248                   secstrcode[len] = 0;
249                 }
250                 len++;
251               }
252             } while (groupc++ < groups.length);
253
254           }
255         }
256       }
257
258       /*
259        * lastScriptTermination = -9465; String dsspOut =
260        * jmd.evalString("calculate STRUCTURE"); if (dsspOut.equals("pending")) {
261        * while (lastScriptTermination == -9465) { try { Thread.sleep(50); }
262        * catch (Exception x) { } ; } } System.out.println(lastConsoleEcho);
263        */
264     }
265   }
266
267   /*
268    * (non-Javadoc)
269    * 
270    * @see jalview.io.AlignFile#print()
271    */
272   @Override
273   public String print()
274   {
275     // TODO Auto-generated method stub
276     return null;
277   }
278
279   @Override
280   public void setCallbackFunction(String callbackType,
281           String callbackFunction)
282   {
283     // TODO Auto-generated method stub
284
285   }
286
287   /*
288    * @Override public void notifyCallback(EnumCallback type, Object[] data) {
289    * try { switch (type) { case ERROR: case SCRIPT:
290    * notifyScriptTermination((String) data[2], ((Integer) data[3]).intValue());
291    * break; case MESSAGE: sendConsoleMessage((data == null) ? ((String) null) :
292    * (String) data[1]); break; case LOADSTRUCT: notifyFileLoaded((String)
293    * data[1], (String) data[2], (String) data[3], (String) data[4], ((Integer)
294    * data[5]).intValue());
295    * 
296    * break; default: // System.err.println("Unhandled callback " + type + " " //
297    * + data[1].toString()); break; } } catch (Exception e) {
298    * System.err.println("Squashed Jmol callback handler error:");
299    * e.printStackTrace(); } }
300    */
301   public void notifyCallback(EnumCallback type, Object[] data)
302   {
303     String strInfo = (data == null || data[1] == null ? null : data[1]
304             .toString());
305     switch (type)
306     {
307     case ECHO:
308       sendConsoleEcho(strInfo);
309       break;
310     case SCRIPT:
311       notifyScriptTermination((String) data[2],
312               ((Integer) data[3]).intValue());
313       break;
314     case MEASURE:
315       String mystatus = (String) data[3];
316       if (mystatus.indexOf("Picked") >= 0
317               || mystatus.indexOf("Sequence") >= 0)
318       {
319         // Picking mode
320         sendConsoleMessage(strInfo);
321       }
322       else if (mystatus.indexOf("Completed") >= 0)
323       {
324         sendConsoleEcho(strInfo.substring(strInfo.lastIndexOf(",") + 2,
325                 strInfo.length() - 1));
326       }
327       break;
328     case MESSAGE:
329       sendConsoleMessage(data == null ? null : strInfo);
330       break;
331     case PICK:
332       sendConsoleMessage(strInfo);
333       break;
334     default:
335       break;
336     }
337   }
338
339   private void notifyFileLoaded(String string, String string2,
340           String string3, String string4, int intValue)
341   {
342     // TODO Auto-generated method stub
343
344   }
345
346   String lastConsoleEcho = "";
347
348   private void sendConsoleEcho(String string)
349   {
350     lastConsoleEcho += string;
351     lastConsoleEcho += "\n";
352   }
353
354   String lastConsoleMessage = "";
355
356   private void sendConsoleMessage(String string)
357   {
358     lastConsoleMessage += string;
359     lastConsoleMessage += "\n";
360   }
361
362   int lastScriptTermination = -1;
363
364   String lastScriptMessage = "";
365
366   private void notifyScriptTermination(String string, int intValue)
367   {
368     lastScriptMessage += string;
369     lastScriptMessage += "\n";
370     lastScriptTermination = intValue;
371   }
372
373   @Override
374   public boolean notifyEnabled(EnumCallback callbackPick)
375   {
376     switch (callbackPick)
377     {
378     case MESSAGE:
379     case SCRIPT:
380     case ECHO:
381     case LOADSTRUCT:
382     case ERROR:
383       return true;
384     case MEASURE:
385     case PICK:
386     case HOVER:
387     case RESIZE:
388     case SYNC:
389     case CLICK:
390     case ANIMFRAME:
391     case MINIMIZATION:
392     }
393     return false;
394   }
395
396   @Override
397   public String eval(String strEval)
398   {
399     // TODO Auto-generated method stub
400     return null;
401   }
402
403   @Override
404   public float[][] functionXY(String functionName, int x, int y)
405   {
406     // TODO Auto-generated method stub
407     return null;
408   }
409
410   @Override
411   public float[][][] functionXYZ(String functionName, int nx, int ny, int nz)
412   {
413     // TODO Auto-generated method stub
414     return null;
415   }
416
417   @Override
418   public String createImage(String fileName, String type,
419           Object text_or_bytes, int quality)
420   {
421     // TODO Auto-generated method stub
422     return null;
423   }
424
425   @Override
426   public Map<String, Object> getRegistryInfo()
427   {
428     // TODO Auto-generated method stub
429     return null;
430   }
431
432   @Override
433   public void showUrl(String url)
434   {
435     // TODO Auto-generated method stub
436
437   }
438
439   @Override
440   public void resizeInnerPanel(String data)
441   {
442     // TODO Auto-generated method stub
443
444   }
445
446 }