JAL-1421 generic collections in MCView package (+unit tests)
[jalview.git] / src / MCview / PDBfile.java
index 6ca8711..28ece4c 100755 (executable)
  */
 package MCview;
 
+import java.awt.Color;
+import java.io.IOException;
+import java.lang.reflect.Constructor;
+import java.util.ArrayList;
+import java.util.Hashtable;
+import java.util.List;
+import java.util.Vector;
+
 import jalview.analysis.AlignSeq;
 import jalview.datamodel.Alignment;
 import jalview.datamodel.AlignmentAnnotation;
@@ -29,55 +37,58 @@ import jalview.datamodel.SequenceI;
 import jalview.io.FileParse;
 import jalview.util.MessageManager;
 
-import java.awt.Color;
-import java.io.IOException;
-import java.util.ArrayList;
-import java.util.Hashtable;
-import java.util.List;
-import java.util.Vector;
-
 public class PDBfile extends jalview.io.AlignFile
 {
+  private static String CALC_ID_PREFIX = "JalviewPDB";
+
   public Vector<PDBChain> chains;
 
   public String id;
 
   /**
-   * set to true to add chain alignment annotation as visible annotation.
+   * set to true to add derived sequence annotations (temp factor read from
+   * file, or computed secondary structure) to the alignment
    */
-  boolean VisibleChainAnnotation = false;
+  private boolean visibleChainAnnotation = false;
 
-  boolean processSecondaryStructure = true;
+  /*
+   * Set true to predict secondary structure (using JMol for protein, Annotate3D
+   * for RNA)
+   */
+  private boolean predictSecondaryStructure = true;
 
-  boolean externalSecondaryStructure = false;
+  /*
+   * Set true (with predictSecondaryStructure=true) to predict secondary
+   * structure using an external service (currently Annotate3D for RNA only)
+   */
+  private boolean externalSecondaryStructure = false;
 
-  public PDBfile(boolean visibleChainAnnotation,
-          boolean processSecondaryStructure, boolean externalSecStr)
+  public PDBfile(boolean addAlignmentAnnotations, boolean predictSecondaryStructure,
+          boolean externalSecStr)
   {
     super();
-    VisibleChainAnnotation = visibleChainAnnotation;
-    this.processSecondaryStructure = processSecondaryStructure;
+    this.visibleChainAnnotation = addAlignmentAnnotations;
+    this.predictSecondaryStructure = predictSecondaryStructure;
     this.externalSecondaryStructure = externalSecStr;
   }
 
-  public PDBfile(boolean visibleChainAnnotation,
-          boolean processSecondaryStructure, boolean externalSecStr,
-          String file, String protocol) throws IOException
+  public PDBfile(boolean addAlignmentAnnotations, boolean predictSecondaryStructure,
+          boolean externalSecStr, String file, String protocol)
+          throws IOException
   {
     super(false, file, protocol);
-    VisibleChainAnnotation = visibleChainAnnotation;
-    this.processSecondaryStructure = processSecondaryStructure;
+    this.visibleChainAnnotation = addAlignmentAnnotations;
+    this.predictSecondaryStructure = predictSecondaryStructure;
     this.externalSecondaryStructure = externalSecStr;
     doParse();
   }
 
-  public PDBfile(boolean visibleChainAnnotation,
-          boolean processSecondaryStructure, boolean externalSecStr,
-          FileParse source) throws IOException
+  public PDBfile(boolean addAlignmentAnnotations, boolean predictSecondaryStructure,
+          boolean externalSecStr, FileParse source) throws IOException
   {
     super(false, source);
-    VisibleChainAnnotation = visibleChainAnnotation;
-    this.processSecondaryStructure = processSecondaryStructure;
+    this.visibleChainAnnotation = addAlignmentAnnotations;
+    this.predictSecondaryStructure = predictSecondaryStructure;
     this.externalSecondaryStructure = externalSecStr;
     doParse();
   }
@@ -92,15 +103,16 @@ public class PDBfile extends jalview.io.AlignFile
     // TODO set the filename sensibly - try using data source name.
     id = safeName(getDataName());
 
-    chains = new Vector();
-    ArrayList<SequenceI> rna = new ArrayList<SequenceI>(), prot = new ArrayList<SequenceI>();
+    chains = new Vector<PDBChain>();
+    List<SequenceI> rna = new ArrayList<SequenceI>();
+    List<SequenceI> prot = new ArrayList<SequenceI>();
     PDBChain tmpchain;
     String line = null;
     boolean modelFlag = false;
     boolean terFlag = false;
     String lastID = "";
 
-    int index = 0;
+    int indexx = 0;
     String atomnam = null;
     try
     {
@@ -186,34 +198,10 @@ public class PDBfile extends jalview.io.AlignFile
       {
         id = inFile.getName();
       }
-      for (int i = 0; i < chains.size(); i++)
+      for (PDBChain chain : chains)
       {
-        SequenceI dataset = chains.elementAt(i).sequence;
-        dataset.setName(id + "|" + dataset.getName());
-        PDBEntry entry = new PDBEntry();
-        entry.setId(id);
-        entry.setType(PDBEntry.Type.PDB);
-        entry.setProperty(new Hashtable());
-        if (chains.elementAt(i).id != null)
-        {
-          // entry.getProperty().put("CHAIN", chains.elementAt(i).id);
-          entry.setChainCode(String.valueOf(chains.elementAt(i).id));
-        }
-        if (inFile != null)
-        {
-          entry.setFile(inFile.getAbsolutePath());
-        }
-        else
-        {
-          // TODO: decide if we should dump the datasource to disk
-          entry.setFile(getDataName());
-        }
-        dataset.addPDBId(entry);
-        SequenceI chainseq = dataset.deriveSequence(); // PDBChain objects
-        // maintain reference to
-        // dataset
-        seqs.addElement(chainseq);
-        if (isRNA(chainseq) == true)
+        SequenceI chainseq = postProcessChain(chain);
+        if (isRNA(chainseq))
         {
           rna.add(chainseq);
         }
@@ -221,47 +209,10 @@ public class PDBfile extends jalview.io.AlignFile
         {
           prot.add(chainseq);
         }
-
-        AlignmentAnnotation[] chainannot = chainseq.getAnnotation();
-
-        if (chainannot != null && VisibleChainAnnotation)
-        {
-          for (int ai = 0; ai < chainannot.length; ai++)
-          {
-            chainannot[ai].visible = VisibleChainAnnotation;
-            annotations.addElement(chainannot[ai]);
-          }
-        }
       }
-      if (processSecondaryStructure)
+      if (predictSecondaryStructure)
       {
-        if (externalSecondaryStructure && rna.size() > 0)
-        {
-          try
-          {
-            processPdbFileWithAnnotate3d(rna);
-          } catch (Exception x)
-          {
-            System.err
-                    .println("Exceptions when dealing with RNA in pdb file");
-            x.printStackTrace();
-
-          }
-        }
-        ;
-        if (prot.size() > 0)
-        {
-          try
-          {
-            processPdbFileWithJmol(prot);
-          } catch (Exception x)
-          {
-            System.err
-                    .println("Exceptions from Jmol when processing data in pdb file");
-            x.printStackTrace();
-
-          }
-        }
+        predictSecondaryStructure(rna, prot);
       }
     } catch (OutOfMemoryError er)
     {
@@ -280,27 +231,117 @@ public class PDBfile extends jalview.io.AlignFile
     markCalcIds();
   }
 
-  private static String calcIdPrefix = "JalviewPDB";
+  /**
+   * Predict secondary structure for RNA and/or protein sequences and add as
+   * annotations
+   * 
+   * @param rnaSequences
+   * @param proteinSequences
+   */
+  protected void predictSecondaryStructure(List<SequenceI> rnaSequences,
+          List<SequenceI> proteinSequences)
+  {
+    /*
+     * Currently using Annotate3D for RNA, but only if the 'use external
+     * prediction' flag is set
+     */
+    if (externalSecondaryStructure && rnaSequences.size() > 0)
+    {
+      try
+      {
+        processPdbFileWithAnnotate3d(rnaSequences);
+      } catch (Exception x)
+      {
+        System.err
+                .println("Exceptions when dealing with RNA in pdb file");
+        x.printStackTrace();
+
+      }
+    }
+
+    /*
+     * Currently using JMol PDB parser for peptide
+     */
+    if (proteinSequences.size() > 0)
+    {
+      try
+      {
+        processPdbFileWithJmol(proteinSequences);
+      } catch (Exception x)
+      {
+        System.err
+                .println("Exceptions from Jmol when processing data in pdb file");
+        x.printStackTrace();
+      }
+    }
+  }
+
+  /**
+   * Process a parsed chain to construct and return a Sequence, and add it to
+   * the list of sequences parsed.
+   * 
+   * @param chain
+   * @return
+   */
+  protected SequenceI postProcessChain(PDBChain chain)
+  {
+    SequenceI dataset = chain.sequence;
+    dataset.setName(id + "|" + dataset.getName());
+    PDBEntry entry = new PDBEntry();
+    entry.setId(id);
+    entry.setType(PDBEntry.Type.PDB);
+    entry.setProperty(new Hashtable());
+    if (chain.id != null)
+    {
+      // entry.getProperty().put("CHAIN", chains.elementAt(i).id);
+      entry.setChainCode(String.valueOf(chain.id));
+    }
+    if (inFile != null)
+    {
+      entry.setFile(inFile.getAbsolutePath());
+    }
+    else
+    {
+      // TODO: decide if we should dump the datasource to disk
+      entry.setFile(getDataName());
+    }
+    dataset.addPDBId(entry);
+    // PDBChain objects maintain reference to dataset
+    SequenceI chainseq = dataset.deriveSequence();
+    seqs.addElement(chainseq);
+
+    AlignmentAnnotation[] chainannot = chainseq.getAnnotation();
+
+    if (chainannot != null && visibleChainAnnotation)
+    {
+      for (int ai = 0; ai < chainannot.length; ai++)
+      {
+        chainannot[ai].visible = visibleChainAnnotation;
+        annotations.addElement(chainannot[ai]);
+      }
+    }
+    return chainseq;
+  }
 
   public static boolean isCalcIdHandled(String calcId)
   {
-    return calcId != null && (calcIdPrefix.equals(calcId));
+    return calcId != null && (CALC_ID_PREFIX.equals(calcId));
   }
 
   public static boolean isCalcIdForFile(AlignmentAnnotation alan,
           String pdbFile)
   {
     return alan.getCalcId() != null
-            && calcIdPrefix.equals(alan.getCalcId())
+            && CALC_ID_PREFIX.equals(alan.getCalcId())
             && pdbFile.equals(alan.getProperty("PDBID"));
   }
 
   public static String relocateCalcId(String calcId,
           Hashtable<String, String> alreadyLoadedPDB) throws Exception
   {
-    int s = calcIdPrefix.length(), end = calcId.indexOf(calcIdPrefix, s);
+    int s = CALC_ID_PREFIX.length(), end = calcId.indexOf(CALC_ID_PREFIX, s);
     String between = calcId.substring(s, end - 1);
-    return calcIdPrefix + alreadyLoadedPDB.get(between) + ":"
+    return CALC_ID_PREFIX + alreadyLoadedPDB.get(between) + ":"
             + calcId.substring(end);
   }
 
@@ -317,7 +358,7 @@ public class PDBfile extends jalview.io.AlignFile
           {
             oldId = "";
           }
-          aa.setCalcId(calcIdPrefix);
+          aa.setCalcId(CALC_ID_PREFIX);
           aa.setProperty("PDBID", id);
           aa.setProperty("oldCalcId", oldId);
         }
@@ -325,7 +366,7 @@ public class PDBfile extends jalview.io.AlignFile
     }
   }
 
-  private void processPdbFileWithJmol(ArrayList<SequenceI> prot)
+  private void processPdbFileWithJmol(List<SequenceI> prot)
           throws Exception
   {
     try
@@ -333,14 +374,16 @@ public class PDBfile extends jalview.io.AlignFile
       Class cl = Class.forName("jalview.ext.jmol.PDBFileWithJmol");
       if (cl != null)
       {
-        Object jmf = cl.getConstructor(new Class[]
-        { FileParse.class }).newInstance(new Object[]
-        { new FileParse(getDataName(), type) });
-        Alignment al = new Alignment((SequenceI[]) cl.getMethod(
+        final Constructor constructor = cl.getConstructor(new Class[]
+        { FileParse.class });
+        final Object[] args = new Object[]
+        { new FileParse(getDataName(), type) };
+        Object jmf = constructor.newInstance(args);
+        AlignmentI al = new Alignment((SequenceI[]) cl.getMethod(
                 "getSeqsAsArray", new Class[]
                 {}).invoke(jmf));
         cl.getMethod("addAnnotations", new Class[]
-        { Alignment.class }).invoke(jmf, al);
+        { AlignmentI.class }).invoke(jmf, al);
         for (SequenceI sq : al.getSequences())
         {
           if (sq.getDatasetSequence() != null)
@@ -359,7 +402,7 @@ public class PDBfile extends jalview.io.AlignFile
     }
   }
 
-  private void replaceAndUpdateChains(ArrayList<SequenceI> prot,
+  private void replaceAndUpdateChains(List<SequenceI> prot,
           AlignmentI al, String pep, boolean b)
   {
     List<List<? extends Object>> replaced = AlignSeq
@@ -388,7 +431,7 @@ public class PDBfile extends jalview.io.AlignFile
     }
   }
 
-  private void processPdbFileWithAnnotate3d(ArrayList<SequenceI> rna)
+  private void processPdbFileWithAnnotate3d(List<SequenceI> rna)
           throws Exception
   {
     // System.out.println("this is a PDB format and RNA sequence");
@@ -455,7 +498,7 @@ public class PDBfile extends jalview.io.AlignFile
   {
     for (int i = 0; i < chains.size(); i++)
     {
-      chains.elementAt(i).makeResidueList(VisibleChainAnnotation);
+      chains.elementAt(i).makeResidueList(visibleChainAnnotation);
     }
   }
 
@@ -500,17 +543,17 @@ public class PDBfile extends jalview.io.AlignFile
   {
     for (int i = 0; i < chains.size(); i++)
     {
+      // divide by zero --> infinity --> 255 ;-)
       chains.elementAt(i).setChainColours(
               Color.getHSBColor(1.0f / i, .4f, 1.0f));
     }
   }
 
-  public boolean isRNA(SequenceI seqs)
+  public static boolean isRNA(SequenceI seq)
   {
-    for (int i = 0; i < seqs.getLength(); i++)
+    for (char c : seq.getSequence())
     {
-      if ((seqs.getCharAt(i) != 'A') && (seqs.getCharAt(i) != 'C')
-              && (seqs.getCharAt(i) != 'G') && (seqs.getCharAt(i) != 'U'))
+      if ((c != 'A') && (c != 'C') && (c != 'G') && (c != 'U'))
       {
         return false;
       }