ensure current dataset reference is passed to the crossReference search method
[jalview.git] / src / jalview / gui / AlignFrame.java
index 1eb72e9..6302efb 100755 (executable)
@@ -1,6 +1,6 @@
 /*
  * Jalview - A Sequence Alignment Editor and Viewer
- * Copyright (C) 2006 AM Waterhouse, J Procter, G Barton, M Clamp, S Searle
+ * Copyright (C) 2007 AM Waterhouse, J Procter, G Barton, M Clamp, S Searle
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU General Public License
@@ -24,18 +24,19 @@ import java.util.*;
 
 import java.awt.*;
 import java.awt.datatransfer.*;
+import java.awt.dnd.*;
 import java.awt.event.*;
 import java.awt.print.*;
 import javax.swing.*;
+import javax.swing.event.MenuEvent;
 
 import jalview.analysis.*;
+import jalview.commands.*;
 import jalview.datamodel.*;
 import jalview.io.*;
 import jalview.jbgui.*;
 import jalview.schemes.*;
-import jalview.commands.*;
 import jalview.ws.*;
-import java.awt.dnd.*;
 
 /**
  * DOCUMENT ME!
@@ -43,7 +44,8 @@ import java.awt.dnd.*;
  * @author $author$
  * @version $Revision$
  */
-public class AlignFrame extends GAlignFrame implements DropTargetListener
+public class AlignFrame
+    extends GAlignFrame implements DropTargetListener
 {
   /** DOCUMENT ME!! */
   public static final int DEFAULT_WIDTH = 700;
@@ -111,8 +113,6 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
 
   void init()
   {
-    this.setDropTarget(new java.awt.dnd.DropTarget(this, this));
-
     if (viewport.conservation == null)
     {
       BLOSUM62Colour.setEnabled(false);
@@ -126,23 +126,33 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     String sortby = jalview.bin.Cache.getDefault("SORT_ALIGNMENT", "No sort");
 
     if (sortby.equals("Id"))
+    {
       sortIDMenuItem_actionPerformed(null);
+    }
     else if (sortby.equals("Pairwise Identity"))
+    {
       sortPairwiseMenuItem_actionPerformed(null);
+    }
 
     if (Desktop.desktop != null)
    {
+     this.setDropTarget(new java.awt.dnd.DropTarget(this, this));
      addServiceListeners();
      setGUINucleotide(viewport.alignment.isNucleotide());
    }
 
    setMenusFromViewport(viewport);
-
+   buildSortByAnnotationScoresMenu();
    if (viewport.wrapAlignment)
    {
      wrapMenuItem_actionPerformed(null);
    }
 
+    if (jalview.bin.Cache.getDefault("SHOW_OVERVIEW",false))
+    {
+      this.overviewMenuItem_actionPerformed(null);
+    }
+
    addKeyListener();
 
   }
@@ -160,12 +170,15 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
       {
         public void keyPressed(KeyEvent evt)
         {
-          if (viewport.cursorMode
-              && evt.getKeyCode() >= KeyEvent.VK_0
-              && evt.getKeyCode() <= KeyEvent.VK_9)
-          {
+          if (viewport.cursorMode &&
+              ( (evt.getKeyCode() >= KeyEvent.VK_0 &&
+                 evt.getKeyCode() <= KeyEvent.VK_9)
+               ||
+               (evt.getKeyCode() >= KeyEvent.VK_NUMPAD0 &&
+                evt.getKeyCode() <= KeyEvent.VK_NUMPAD9)
+              )
+              && Character.isDigit(evt.getKeyChar()))
             alignPanel.seqPanel.numberPressed(evt.getKeyChar());
-          }
 
           switch (evt.getKeyCode())
           {
@@ -176,35 +189,36 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
               break;
 
             case KeyEvent.VK_DOWN:
+             if (evt.isAltDown() || !viewport.cursorMode)
+              moveSelectedSequences(false);
               if (viewport.cursorMode)
-              {
                 alignPanel.seqPanel.moveCursor(0, 1);
-              }
-              else
-                moveSelectedSequences(false);
               break;
 
             case KeyEvent.VK_UP:
+            if (evt.isAltDown() || !viewport.cursorMode)
+              moveSelectedSequences(true);
               if (viewport.cursorMode)
-              {
                 alignPanel.seqPanel.moveCursor(0, -1);
-              }
-              else
-                moveSelectedSequences(true);
+
               break;
 
             case KeyEvent.VK_LEFT:
-              if (viewport.cursorMode)
-              {
+            if (evt.isAltDown() || !viewport.cursorMode)
+              slideSequences(false,
+                             alignPanel.seqPanel.getKeyboardNo1());
+            else
                 alignPanel.seqPanel.moveCursor( -1, 0);
-              }
+
+
               break;
 
             case KeyEvent.VK_RIGHT:
-              if (viewport.cursorMode)
-              {
+            if (evt.isAltDown() || !viewport.cursorMode)
+              slideSequences(true,
+                             alignPanel.seqPanel.getKeyboardNo1());
+            else
                 alignPanel.seqPanel.moveCursor(1, 0);
-              }
               break;
 
             case KeyEvent.VK_SPACE:
@@ -223,9 +237,11 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
                 cut_actionPerformed(null);
               }
               else
+            {
                 alignPanel.seqPanel.deleteGapAtCursor(evt.isControlDown()
                                            || evt.isShiftDown()
                                            || evt.isAltDown());
+            }
 
               break;
 
@@ -313,9 +329,12 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
                   hideSelSequences_actionPerformed(null);
                   hide = true;
                 }
-                else if (! (toggleCols && viewport.colSel.getSelected().size() > 0))
+              else if (! (toggleCols &&
+                          viewport.colSel.getSelected().size() > 0))
+              {
                   showAllSeqs_actionPerformed(null);
               }
+            }
 
               if (toggleCols)
               {
@@ -323,31 +342,61 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
                 {
                   hideSelColumns_actionPerformed(null);
                   if (!toggleSeqs)
+                {
                     viewport.selectionGroup = sg;
                 }
+              }
                 else if (!hide)
+              {
                   showAllColumns_actionPerformed(null);
               }
+            }
               break;
             }
             case KeyEvent.VK_PAGE_UP:
               if (viewport.wrapAlignment)
+            {
                 alignPanel.scrollUp(true);
+            }
               else
+            {
                 alignPanel.setScrollValues(viewport.startRes,
                                            viewport.startSeq
                                            - viewport.endSeq + viewport.startSeq);
+            }
               break;
             case KeyEvent.VK_PAGE_DOWN:
               if (viewport.wrapAlignment)
+            {
                 alignPanel.scrollUp(false);
+            }
               else
+            {
                 alignPanel.setScrollValues(viewport.startRes,
                                            viewport.startSeq
                                            + viewport.endSeq - viewport.startSeq);
+            }
               break;
           }
         }
+
+      public void keyReleased(KeyEvent evt)
+      {
+        switch(evt.getKeyCode())
+        {
+          case KeyEvent.VK_LEFT:
+            if (evt.isAltDown() || !viewport.cursorMode)
+              viewport.firePropertyChange("alignment", null,
+                                          viewport.getAlignment().getSequences());
+            break;
+
+          case KeyEvent.VK_RIGHT:
+            if (evt.isAltDown() || !viewport.cursorMode)
+              viewport.firePropertyChange("alignment", null,
+                                          viewport.getAlignment().getSequences());
+            break;
+        }
+      }
       });
   }
 
@@ -386,7 +435,9 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     if(newPanel)
     {
       if (ap.av.padGaps)
+      {
         ap.av.alignment.padGaps();
+      }
       ap.av.updateConservation(ap);
       ap.av.updateConsensus(ap);
     }
@@ -447,14 +498,17 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     showTranslation.setVisible( nucleotide );
     conservationMenuItem.setEnabled( !nucleotide );
     modifyConservation.setEnabled(   !nucleotide );
-
+    
     //Remember AlignFrame always starts as protein
     if(!nucleotide)
     {
       calculateMenu.remove(calculateMenu.getItemCount()-2);
     }
+    setShowProductsEnabled();
   }
 
+
+
   /**
    * Need to call this method when tabs are selected for multiple views,
    * or when loading from Jalview2XML.java
@@ -492,7 +546,9 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   public void setProgressBar(String message, long id)
   {
     if(progressBars == null)
+    {
       progressBars = new Hashtable();
+    }
 
     JPanel progressPanel;
     GridLayout layout = (GridLayout) statusPanel.getLayout();
@@ -503,7 +559,9 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
        progressBars.remove( progressPanel );
        progressPanel = null;
        if(message!=null)
+      {
          statusBar.setText(message);
+      }
 
        layout.setRows(layout.getRows() - 1);
      }
@@ -566,42 +624,35 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
               && frames[i] != this
               && ( (AlignFrame) frames[i]).fileName.equals(fileName))
           {
-            try{
+            try
+            {
               frames[i].setSelected(true);
               Desktop.instance.closeAssociatedWindows();
-            }catch(java.beans.PropertyVetoException ex){}
+          }
+            catch (java.beans.PropertyVetoException ex)
+            {}
           }
 
         }
         Desktop.instance.closeAssociatedWindows();
 
+        FileLoader loader = new FileLoader();
+        String protocol = fileName.startsWith("http:")? "URL":"File";
+        loader.LoadFile(viewport, fileName, protocol, currentFileFormat);
       }
       else
       {
-        viewport.alignment.deleteAllGroups();
-        viewport.sequenceColours=null;
-        while (viewport.alignment.getHeight() > 0)
-        {
-          viewport.alignment.deleteSequence(0);
-        }
+        Rectangle bounds = this.getBounds();
 
-        viewport.historyList.clear();
-        viewport.redoList.clear();
-        Alignment dset = viewport.alignment.getDataset();
-        while (dset.getHeight() > 0)
-        {
-          dset.deleteSequence(0);
-        }
+        FileLoader loader = new FileLoader();
+        String protocol = fileName.startsWith("http:") ? "URL" : "File";
+        AlignFrame newframe =
+            loader.LoadFileWaitTillLoaded(fileName, protocol, currentFileFormat);
 
-        firePropertyChange("Alignment", null, viewport.alignment.getSequences());
+        newframe.setBounds(bounds);
 
-        updateEditMenuBar();
+        this.closeMenuItem_actionPerformed(true);
       }
-
-      FileLoader loader = new FileLoader();
-      String protocol = fileName.startsWith("http:")? "URL":"File";
-      loader.LoadFile(viewport, fileName, protocol, currentFileFormat);
-
     }
   }
 
@@ -623,10 +674,14 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
        || currentFileFormat==null
        || fileName.startsWith("http")
         )
+    {
       saveAs_actionPerformed(null);
+    }
     else
+    {
       saveAlignment(fileName, currentFileFormat);
   }
+  }
 
   /**
    * DOCUMENT ME!
@@ -638,9 +693,9 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     JalviewFileChooser chooser = new JalviewFileChooser(jalview.bin.Cache.
         getProperty( "LAST_DIRECTORY"),
         new String[]
-        { "fa, fasta, fastq", "aln", "pfam", "msf", "pir", "blc","jar" },
+        { "fa, fasta, fastq", "aln", "pfam", "msf", "pir", "blc","amsa","jar" },
         new String[]
-        { "Fasta", "Clustal", "PFAM", "MSF", "PIR", "BLC", "Jalview" },
+        { "Fasta", "Clustal", "PFAM", "MSF", "PIR", "BLC", "AMSA", "Jalview" },
         currentFileFormat,
         false);
 
@@ -671,7 +726,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
 
       jalview.bin.Cache.setProperty("LAST_DIRECTORY", fileName);
 
-      saveAlignment(fileName, currentFileFormat);
+      saveAlignment(fileName, currentFileFormat.substring(0,currentFileFormat.indexOf(" ")));
     }
   }
 
@@ -710,13 +765,16 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
             JOptionPane.YES_NO_OPTION, JOptionPane.QUESTION_MESSAGE);
 
         if (reply == JOptionPane.YES_OPTION)
+        {
           omitHidden = viewport.getViewAsString(false);
       }
+      }
+      FormatAdapter f = new FormatAdapter();
 
-      String output = new FormatAdapter().formatSequences(
+      String output = f.formatSequences(
           format,
-          viewport.alignment.getSequencesArray(),
-          omitHidden);
+          (Alignment) viewport.alignment, // class cast exceptions will occur in the distant future
+          omitHidden, f.getCacheSuffixDefault(format));
 
       if (output == null)
       {
@@ -745,10 +803,12 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     }
 
     if (!success)
+    {
       JOptionPane.showInternalMessageDialog(
           this, "Couldn't save file: " + fileName,
           "Error Saving File",
           JOptionPane.WARNING_MESSAGE);
+    }
 
     return success;
   }
@@ -785,7 +845,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
 
     cap.setText(new FormatAdapter().formatSequences(
         e.getActionCommand(),
-        viewport.alignment.getSequencesArray(),
+        viewport.alignment,
         omitHidden));
   }
 
@@ -796,7 +856,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
    */
   protected void htmlMenuItem_actionPerformed(ActionEvent e)
   {
-    new HTMLOutput(viewport,
+    new HTMLOutput(alignPanel,
                    alignPanel.seqPanel.seqCanvas.getSequenceRenderer(),
         alignPanel.seqPanel.seqCanvas.getFeatureRenderer());
   }
@@ -854,9 +914,10 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   public void exportAnnotations_actionPerformed(ActionEvent e)
   {
     new AnnotationExporter().exportAnnotations(
-        alignPanel,
+      alignPanel,
         viewport.showAnnotation ? viewport.alignment.getAlignmentAnnotation() : null,
-        viewport.alignment.getGroups()
+      viewport.alignment.getGroups(),
+      ((Alignment)viewport.alignment).alignmentProperties
         );
   }
 
@@ -891,20 +952,27 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   public void closeMenuItem_actionPerformed(boolean closeAllTabs)
   {
     if(alignPanels!=null && alignPanels.size()<2)
+    {
       closeAllTabs = true;
+    }
 
     try
     {
       if(alignPanels!=null)
       {
         if (closeAllTabs)
+        {
           for (int i = 0; i < alignPanels.size(); i++)
           {
             AlignmentPanel ap = (AlignmentPanel) alignPanels.elementAt(i);
+            jalview.structure.StructureSelectionManager.getStructureSelectionManager()
+                .removeStructureViewerListener(ap.seqPanel, null);
             PaintRefresher.RemoveComponent(ap.seqPanel.seqCanvas);
             PaintRefresher.RemoveComponent(ap.idPanel.idCanvas);
             PaintRefresher.RemoveComponent(ap);
+            ap.av.alignment = null;
           }
+        }
         else
         {
           int index = tabbedPane.getSelectedIndex();
@@ -913,6 +981,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
           PaintRefresher.RemoveComponent(alignPanel.seqPanel.seqCanvas);
           PaintRefresher.RemoveComponent(alignPanel.idPanel.idCanvas);
           PaintRefresher.RemoveComponent(alignPanel);
+          viewport.alignment = null;
           alignPanel = null;
           viewport = null;
 
@@ -920,15 +989,19 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
           tabbedPane.validate();
 
           if(index==tabbedPane.getTabCount())
+          {
             index --;
+          }
 
           this.tabSelectionChanged(index);
         }
       }
 
       if (closeAllTabs)
+      {
         this.setClosed(true);
     }
+    }
     catch (Exception ex)
     {
       ex.printStackTrace();
@@ -980,8 +1053,28 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     }
   }
 
-
-
+  /**
+   *
+   * @return alignment objects for all views
+   */
+  AlignmentI[] getViewAlignments()
+  {
+    if (alignPanels!=null)
+    {
+      Enumeration e = alignPanels.elements();
+      AlignmentI[] als = new AlignmentI[alignPanels.size()];
+      for (int i=0; e.hasMoreElements(); i++)
+      {
+        als[i] = ((AlignmentPanel) e.nextElement()).av.getAlignment();
+      }
+      return als;
+    }
+    if (viewport!=null)
+    {
+      return new AlignmentI[] { viewport.alignment };
+    }
+    return null;
+  }
   /**
    * DOCUMENT ME!
    *
@@ -989,9 +1082,11 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
    */
   protected void undoMenuItem_actionPerformed(ActionEvent e)
   {
+    if (viewport.historyList.empty())
+      return;
     CommandI command = (CommandI)viewport.historyList.pop();
     viewport.redoList.push(command);
-    command.undoCommand();
+    command.undoCommand(getViewAlignments());
 
     AlignViewport originalSource = getOriginatingSource(command);
     updateEditMenuBar();
@@ -1013,11 +1108,13 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   protected void redoMenuItem_actionPerformed(ActionEvent e)
   {
     if(viewport.redoList.size()<1)
+    {
       return;
+    }
 
     CommandI command = (CommandI) viewport.redoList.pop();
     viewport.historyList.push(command);
-    command.doCommand();
+    command.doCommand(getViewAlignments());
 
     AlignViewport originalSource = getOriginatingSource(command);
     updateEditMenuBar();
@@ -1063,7 +1160,9 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
       //The original view is closed, we must validate
       //the current view against the closed view first
       if (al != null)
+      {
         PaintRefresher.validateSequences(al, viewport.alignment);
+      }
 
       originalSource = viewport;
     }
@@ -1130,11 +1229,102 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
       }
     }
 
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
 
 
+
+  synchronized void slideSequences(boolean right, int size)
+  {
+    Vector sg = new Vector();
+    if(viewport.cursorMode)
+    {
+      sg.addElement(viewport.alignment.getSequenceAt(
+          alignPanel.seqPanel.seqCanvas.cursorY));
+    }
+    else if(viewport.getSelectionGroup()!=null
+        && viewport.getSelectionGroup().getSize()!=viewport.alignment.getHeight())
+   {
+     sg = viewport.getSelectionGroup().getSequences(
+         viewport.hiddenRepSequences);
+   }
+
+    if(sg.size()<1)
+    {
+      return;
+    }
+
+    Vector invertGroup = new Vector();
+
+    for (int i = 0; i < viewport.alignment.getHeight(); i++)
+    {
+      if(!sg.contains(viewport.alignment.getSequenceAt(i)))
+         invertGroup.add(viewport.alignment.getSequenceAt(i));
+    }
+
+    SequenceI[] seqs1 = new SequenceI[sg.size()];
+    for (int i = 0; i < sg.size(); i++)
+      seqs1[i] = (SequenceI) sg.elementAt(i);
+
+    SequenceI[] seqs2 = new SequenceI[invertGroup.size()];
+    for (int i = 0; i < invertGroup.size(); i++)
+      seqs2[i] = (SequenceI) invertGroup.elementAt(i);
+
+    SlideSequencesCommand ssc;
+    if (right)
+      ssc = new SlideSequencesCommand("Slide Sequences",
+                                      seqs2, seqs1, size,
+                                      viewport.getGapCharacter()
+          );
+    else
+      ssc = new SlideSequencesCommand("Slide Sequences",
+                                      seqs1, seqs2, size,
+                                      viewport.getGapCharacter()
+          );
+
+    int groupAdjustment = 0;
+    if (ssc.getGapsInsertedBegin() && right)
+    {
+      if (viewport.cursorMode)
+        alignPanel.seqPanel.moveCursor(size, 0);
+      else
+        groupAdjustment = size;
+    }
+    else if (!ssc.getGapsInsertedBegin() && !right)
+    {
+      if (viewport.cursorMode)
+        alignPanel.seqPanel.moveCursor( -size, 0);
+      else
+        groupAdjustment = -size;
+    }
+
+    if (groupAdjustment != 0)
+    {
+      viewport.getSelectionGroup().setStartRes(
+          viewport.getSelectionGroup().getStartRes() + groupAdjustment);
+      viewport.getSelectionGroup().setEndRes(
+          viewport.getSelectionGroup().getEndRes() + groupAdjustment);
+    }
+
+
+    boolean appendHistoryItem = false;
+    if(viewport.historyList!=null
+       && viewport.historyList.size()>0
+      && viewport.historyList.peek() instanceof SlideSequencesCommand)
+    {
+      appendHistoryItem = ssc.appendSlideCommand(
+          (SlideSequencesCommand)viewport.historyList.peek())
+          ;
+    }
+
+    if(!appendHistoryItem)
+      addHistoryItem(ssc);
+
+    repaint();
+  }
+
+
   /**
    * DOCUMENT ME!
    *
@@ -1147,7 +1337,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     {
       return;
     }
-
+    //  TODO: preserve the ordering of displayed alignment annotation in any internal paste (particularly sequence associated annotation)
     SequenceI [] seqs = viewport.getSelectionAsNewSequence();
     String[] omitHidden = null;
 
@@ -1198,19 +1388,21 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     {
       hiddenColumns =new Vector();
       int hiddenOffset = viewport.getSelectionGroup().getStartRes();
-      for(int i=0; i<viewport.getColumnSelection().getHiddenColumns().size(); i++)
+      for (int i = 0; i < viewport.getColumnSelection().getHiddenColumns().size();
+           i++)
       {
         int[] region = (int[])
             viewport.getColumnSelection().getHiddenColumns().elementAt(i);
 
-        hiddenColumns.addElement(new int[]{region[0]-hiddenOffset,
+        hiddenColumns.addElement(new int[]
+                                 {region[0] - hiddenOffset,
                           region[1]-hiddenOffset});
       }
     }
 
-
-
-    Desktop.jalviewClipboard = new Object[]{ seqs,
+    Desktop.jalviewClipboard = new Object[]
+        {
+        seqs,
         viewport.alignment.getDataset(),
         hiddenColumns};
     statusBar.setText("Copied "+seqs.length+" sequences to clipboard.");
@@ -1243,6 +1435,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
    */
   void paste(boolean newAlignment)
   {
+    boolean externalPaste=true;
     try
     {
       Clipboard c = Toolkit.getDefaultToolkit().getSystemClipboard();
@@ -1258,7 +1451,9 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
       {
         str = (String) contents.getTransferData(DataFlavor.stringFlavor);
         if (str.length() < 1)
+        {
           return;
+        }
 
         format = new IdentifyFile().Identify(str, "Paste");
 
@@ -1283,96 +1478,175 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
       }
 
       SequenceI[] sequences;
-
+      boolean annotationAdded = false;
+      AlignmentI alignment = null;
 
      if(Desktop.jalviewClipboard!=null)
      {
        // The clipboard was filled from within Jalview, we must use the sequences
        // And dataset from the copied alignment
-       sequences = (SequenceI[])Desktop.jalviewClipboard[0];
+       SequenceI[] newseq = (SequenceI[])Desktop.jalviewClipboard[0];
+       // be doubly sure that we create *new* sequence objects.
+       sequences = new SequenceI[newseq.length];
+       for (int i=0;i<newseq.length;i++) {
+         sequences[i] = new Sequence(newseq[i]);
+       }
+       alignment = new Alignment(sequences);
+       externalPaste = false;
      }
      else
      {
-       sequences = new FormatAdapter().readFile(str, "Paste", format).getSequencesArray();
+       // parse the clipboard as an alignment.
+       alignment = new FormatAdapter().readFile(str, "Paste", format);
+       sequences = alignment.getSequencesArray();
      }
 
-     AlignmentI alignment = null;
+     int alwidth=0;
 
-      if (newAlignment)
-      {
-          alignment = new Alignment(sequences);
+     if (newAlignment)
+     {
 
-          if (Desktop.jalviewClipboard != null)
-            alignment.setDataset( (Alignment) Desktop.jalviewClipboard[1]);
-          else
-            alignment.setDataset(null);
-      }
-      else
-      {
-        alignment = viewport.getAlignment();
+       if (Desktop.jalviewClipboard != null)
+       {
+         // dataset is inherited
+         alignment.setDataset( (Alignment) Desktop.jalviewClipboard[1]);
+       }
+       else
+       {
+         // new dataset is constructed
+         alignment.setDataset(null);
+       }
+       alwidth = alignment.getWidth()+1;
+     }
+     else
+     {
+       AlignmentI pastedal = alignment; // preserve pasted alignment object
+       // Add pasted sequences and dataset into existing alignment.
+       alignment = viewport.getAlignment();
+       alwidth = alignment.getWidth()+1;
+        // decide if we need to import sequences from an existing dataset
+        boolean importDs = Desktop.jalviewClipboard != null
+                && Desktop.jalviewClipboard[1] != alignment.getDataset();
+        // importDs==true instructs us to copy over new dataset sequences from
+        // an existing alignment
+        Vector newDs = (importDs) ? new Vector() : null; // used to create
+                                                          // minimum dataset set
 
-        //!newAlignment
-        SequenceI [] newseqs = new SequenceI[sequences.length];
         for (int i = 0; i < sequences.length; i++)
         {
-          newseqs[i] = new Sequence(sequences[i].getName(),
-              sequences[i].getSequence(), sequences[i].getStart(),
-              sequences[i].getEnd());
-
-          alignment.addSequence(newseqs[i]);
+          if (importDs)
+          {
+            newDs.addElement(null);
+          }
+          SequenceI ds = sequences[i].getDatasetSequence(); // null for a simple
+                                                            // paste
+          if (importDs && ds != null)
+          {
+            if (!newDs.contains(ds))
+            {
+              newDs.setElementAt(ds, i);
+              ds = new Sequence(ds);
+              // update with new dataset sequence
+              sequences[i].setDatasetSequence(ds);
+            }
+            else
+            {
+              ds = sequences[newDs.indexOf(ds)].getDatasetSequence();
+            }
+          }
+          else
+          {
+            // copy and derive new dataset sequence
+            sequences[i] = sequences[i].deriveSequence();
+            alignment.getDataset().addSequence(sequences[i].getDatasetSequence());
+            // TODO: avoid creation of duplicate dataset sequences with a
+            // 'contains' method using SequenceI.equals()/SequenceI.contains()
+          }
+          alignment.addSequence(sequences[i]); // merges dataset
         }
-
-        /*
-         //ADD HISTORY ITEM
-         */
-        addHistoryItem(new EditCommand(
-            "Add sequences",
-            EditCommand.PASTE,
-            newseqs,
-            0,
-            alignment.getWidth(),
-            alignment)
-            );
-
-
-        viewport.setEndSeq(alignment.getHeight());
-        alignment.getWidth();
-        viewport.firePropertyChange("alignment", null, alignment.getSequences());
-      }
-
-
-
-      // Add any annotations attached to sequences
-      for (int i = 0; i < sequences.length; i++)
+        if (newDs != null)
+        {
+          newDs.clear(); // tidy up
+        }
+        if (pastedal.getAlignmentAnnotation()!=null) {
+          // Add any annotation attached to alignment.
+          AlignmentAnnotation[] alann = pastedal.getAlignmentAnnotation();
+          for (int i=0; i<alann.length; i++)
+          {
+            annotationAdded=true;
+            if (alann[i].sequenceRef==null && !alann[i].autoCalculated) {
+              AlignmentAnnotation newann = new AlignmentAnnotation(alann[i]);
+              newann.padAnnotation(alwidth);
+              alignment.addAnnotation(newann);
+            }
+          }
+        }
+     }
+     if (!newAlignment) {
+       ///////
+       // ADD HISTORY ITEM
+       //
+       addHistoryItem(new EditCommand(
+               "Add sequences",
+               EditCommand.PASTE,
+               sequences,
+               0,
+               alignment.getWidth(),
+               alignment)
+              );
+     }
+     // Add any annotations attached to sequences
+     for (int i = 0; i < sequences.length; i++)
      {
        if (sequences[i].getAnnotation() != null)
        {
          for (int a = 0; a < sequences[i].getAnnotation().length; a++)
          {
-           AlignmentAnnotation newAnnot =
-               new AlignmentAnnotation(
-                   sequences[i].getAnnotation()[a].label,
-                   sequences[i].getAnnotation()[a].description,
-                   sequences[i].getAnnotation()[a].annotations,
-                   sequences[i].getAnnotation()[a].graphMin,
-                   sequences[i].getAnnotation()[a].graphMax,
-                   sequences[i].getAnnotation()[a].graph);
-
-           sequences[i].getAnnotation()[a] = newAnnot;
-           newAnnot.sequenceMapping = sequences[i].getAnnotation()[a].
-               sequenceMapping;
-           newAnnot.sequenceRef = sequences[i];
-           newAnnot.adjustForAlignment();
-           alignment.addAnnotation(newAnnot);
-           alignment.setAnnotationIndex(newAnnot, a);
+           annotationAdded=true;
+           sequences[i].getAnnotation()[a].adjustForAlignment();
+           sequences[i].getAnnotation()[a].padAnnotation(alwidth);
+           alignment.addAnnotation(sequences[i].getAnnotation()[a]); // annotation was duplicated earlier
+           alignment.setAnnotationIndex(sequences[i].getAnnotation()[a], a);
          }
-
-         alignPanel.annotationPanel.adjustPanelHeight();
        }
      }
+     if (!newAlignment) {
 
-     if(newAlignment)
-     {
+       // propagate alignment changed.
+       viewport.setEndSeq(alignment.getHeight());
+       if (annotationAdded)
+       {
+         // Duplicate sequence annotation in all views.
+         AlignmentI[] alview = this.getViewAlignments();
+         for (int i = 0; i < sequences.length; i++)
+         {
+           AlignmentAnnotation sann[] = sequences[i].getAnnotation();
+           if (sann == null)
+             continue;
+           for (int avnum=0;avnum<alview.length; avnum++)
+           {
+             if (alview[avnum]!=alignment)
+             {
+               // duplicate in a view other than the one with input focus
+               int avwidth = alview[avnum].getWidth()+1;
+               // this relies on sann being preserved after we 
+               // modify the sequence's annotation array for each duplication
+               for (int a=0; a<sann.length; a++)
+               {
+                 AlignmentAnnotation newann = new AlignmentAnnotation(sann[a]);
+                 sequences[i].addAlignmentAnnotation(newann);
+                 newann.padAnnotation(avwidth);
+                 alview[avnum].addAnnotation(newann); // annotation was duplicated earlier
+                 alview[avnum].setAnnotationIndex(newann, a);
+               }
+             }
+           }
+         }
+         buildSortByAnnotationScoresMenu();
+       }
+       viewport.firePropertyChange("alignment", null, alignment.getSequences());
+
+     } else {
        AlignFrame af = new AlignFrame(alignment, DEFAULT_WIDTH, DEFAULT_HEIGHT);
        String newtitle = new String("Copied sequences");
 
@@ -1391,14 +1665,18 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
        af.alignPanel.seqPanel.seqCanvas.getFeatureRenderer().transferSettings(
            alignPanel.seqPanel.seqCanvas.getFeatureRenderer());
 
-
-       if (title.startsWith("Copied sequences"))
-       {
-         newtitle = title;
-       }
-       else
-       {
-         newtitle = newtitle.concat("- from " + title);
+       // TODO: maintain provenance of an alignment, rather than just make the title a concatenation of operations.
+       if (!externalPaste) {
+         if (title.startsWith("Copied sequences"))
+         {
+           newtitle = title;
+         }
+         else
+         {
+           newtitle = newtitle.concat("- from " + title);
+         }
+       } else {
+         newtitle = new String("Pasted sequences");
        }
 
        Desktop.addInternalFrame(af, newtitle, DEFAULT_WIDTH,
@@ -1462,7 +1740,9 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
 
     SequenceI [] cut = new SequenceI[seqs.size()];
     for(int i=0; i<seqs.size(); i++)
+    {
       cut[i] = (SequenceI)seqs.elementAt(i);
+    }
 
 
     /*
@@ -1505,7 +1785,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     viewport.sequenceColours = null;
     viewport.setSelectionGroup(null);
     PaintRefresher.Refresh(this, viewport.getSequenceSetId());
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
   /**
@@ -1525,7 +1805,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
 
     sg.setEndRes(viewport.alignment.getWidth() - 1);
     viewport.setSelectionGroup(sg);
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
     PaintRefresher.Refresh(alignPanel, viewport.getSequenceSetId());
   }
 
@@ -1546,7 +1826,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     viewport.setSelectionGroup(null);
     alignPanel.seqPanel.seqCanvas.highlightSearchResults(null);
     alignPanel.idPanel.idCanvas.searchResults = null;
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
     PaintRefresher.Refresh(alignPanel, viewport.getSequenceSetId());
   }
 
@@ -1572,7 +1852,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
       sg.addOrRemove(viewport.getAlignment().getSequenceAt(i), false);
     }
 
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
 
     PaintRefresher.Refresh(alignPanel, viewport.getSequenceSetId());
   }
@@ -1580,7 +1860,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   public void invertColSel_actionPerformed(ActionEvent e)
   {
     viewport.invertColumnSelection();
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
 
@@ -1612,15 +1892,24 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     if (colSel.size() > 0)
     {
       if(trimLeft)
+      {
         column = colSel.getMin();
+      }
       else
+      {
         column = colSel.getMax();
+      }
 
       SequenceI [] seqs;
       if(viewport.getSelectionGroup()!=null)
-        seqs = viewport.getSelectionGroup().getSequencesAsArray(viewport.hiddenRepSequences);
+      {
+        seqs = viewport.getSelectionGroup().getSequencesAsArray(viewport.
+            hiddenRepSequences);
+      }
       else
+      {
         seqs = viewport.alignment.getSequencesArray();
+      }
 
 
       TrimRegionCommand trimRegion;
@@ -1681,12 +1970,15 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     SequenceI[] seqs;
     if (viewport.getSelectionGroup() != null)
     {
-      seqs = viewport.getSelectionGroup().getSequencesAsArray(viewport.hiddenRepSequences);
+      seqs = viewport.getSelectionGroup().getSequencesAsArray(viewport.
+          hiddenRepSequences);
       start = viewport.getSelectionGroup().getStartRes();
       end = viewport.getSelectionGroup().getEndRes();
     }
     else
+    {
       seqs = viewport.alignment.getSequencesArray();
+    }
 
 
     RemoveGapColCommand removeGapCols =
@@ -1709,7 +2001,8 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
    // if (viewport.hasHiddenColumns)
    //   viewport.getColumnSelection().compensateForEdits(shifts);
    viewport.setStartRes(seq.findIndex(startRes)-1);
-   viewport.firePropertyChange("alignment", null, viewport.getAlignment().getSequences());
+    viewport.firePropertyChange("alignment", null,
+                                viewport.getAlignment().getSequences());
 
   }
 
@@ -1725,12 +2018,15 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     SequenceI[] seqs;
     if (viewport.getSelectionGroup() != null)
     {
-      seqs = viewport.getSelectionGroup().getSequencesAsArray(viewport.hiddenRepSequences);
+      seqs = viewport.getSelectionGroup().getSequencesAsArray(viewport.
+          hiddenRepSequences);
       start = viewport.getSelectionGroup().getStartRes();
       end = viewport.getSelectionGroup().getEndRes();
     }
     else
+    {
       seqs = viewport.alignment.getSequencesArray();
+    }
 
     //This is to maintain viewport position on first residue
     //of first sequence
@@ -1744,7 +2040,8 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
 
     viewport.setStartRes(seq.findIndex(startRes)-1);
 
-    viewport.firePropertyChange("alignment", null, viewport.getAlignment().getSequences());
+    viewport.firePropertyChange("alignment", null,
+                                viewport.getAlignment().getSequences());
 
   }
 
@@ -1777,8 +2074,12 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     AlignmentPanel newap =
         new Jalview2XML().copyAlignPanel(alignPanel, true);
 
+    newap.av.gatherViewsHere = false;
+
     if (viewport.viewName == null)
+    {
       viewport.viewName = "Original";
+    }
 
     newap.av.historyList = viewport.historyList;
     newap.av.redoList = viewport.redoList;
@@ -1786,7 +2087,8 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     int index = Desktop.getViewCount(viewport.getSequenceSetId());
     String newViewName = "View " +index;
 
-    Vector comps = (Vector)PaintRefresher.components.get(viewport.getSequenceSetId());
+    Vector comps = (Vector) PaintRefresher.components.get(viewport.
+        getSequenceSetId());
     Vector existingNames = new Vector();
     for(int i=0; i<comps.size(); i++)
     {
@@ -1794,9 +2096,11 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
       {
         AlignmentPanel ap = (AlignmentPanel)comps.elementAt(i);
         if(!existingNames.contains(ap.av.viewName))
+        {
           existingNames.addElement(ap.av.viewName);
       }
     }
+    }
 
     while(existingNames.contains(newViewName))
     {
@@ -1847,13 +2151,13 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     viewport.setShowJVSuffix(seqLimits.isSelected());
 
     alignPanel.idPanel.idCanvas.setPreferredSize(alignPanel.calculateIdWidth());
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
   public void idRightAlign_actionPerformed(ActionEvent e)
   {
     viewport.rightAlignIds = idRightAlign.isSelected();
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
 
@@ -1866,7 +2170,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   protected void colourTextMenuItem_actionPerformed(ActionEvent e)
   {
     viewport.setColourText(colourTextMenuItem.isSelected());
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
   /**
@@ -1897,13 +2201,13 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   public void hideSelSequences_actionPerformed(ActionEvent e)
   {
     viewport.hideAllSelectedSeqs();
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
   public void hideSelColumns_actionPerformed(ActionEvent e)
   {
     viewport.hideSelectedColumns();
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
   public void hiddenMarkers_actionPerformed(ActionEvent e)
@@ -1920,7 +2224,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   protected void scaleAbove_actionPerformed(ActionEvent e)
   {
     viewport.setScaleAboveWrapped(scaleAbove.isSelected());
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
   /**
@@ -1931,7 +2235,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   protected void scaleLeft_actionPerformed(ActionEvent e)
   {
     viewport.setScaleLeftWrapped(scaleLeft.isSelected());
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
   /**
@@ -1942,7 +2246,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   protected void scaleRight_actionPerformed(ActionEvent e)
   {
     viewport.setScaleRightWrapped(scaleRight.isSelected());
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
   /**
@@ -1953,7 +2257,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   public void viewBoxesMenuItem_actionPerformed(ActionEvent e)
   {
     viewport.setShowBoxes(viewBoxesMenuItem.isSelected());
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
   /**
@@ -1964,7 +2268,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   public void viewTextMenuItem_actionPerformed(ActionEvent e)
   {
     viewport.setShowText(viewTextMenuItem.isSelected());
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
   /**
@@ -1975,7 +2279,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   protected void renderGapsMenuItem_actionPerformed(ActionEvent e)
   {
     viewport.setRenderGaps(renderGapsMenuItem.isSelected());
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
 
@@ -1998,7 +2302,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   public void showSeqFeatures_actionPerformed(ActionEvent evt)
   {
     viewport.setShowSequenceFeatures(showSeqFeatures.isSelected());
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
     if (alignPanel.getOverviewPanel() != null)
     {
       alignPanel.getOverviewPanel().updateOverviewImage();
@@ -2016,6 +2320,65 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     alignPanel.setAnnotationVisible(annotationPanelMenuItem.isSelected());
   }
 
+  public void alignmentProperties()
+  {
+    JEditorPane editPane = new JEditorPane("text/html","");
+    editPane.setEditable(false);
+    StringBuffer contents = new StringBuffer("<html>");
+
+    float avg  = 0;
+    int min=Integer.MAX_VALUE, max=0;
+    for(int i=0; i<viewport.alignment.getHeight(); i++)
+    {
+      int size = viewport.alignment.getSequenceAt(i).getEnd()
+          -viewport.alignment.getSequenceAt(i).getStart();
+      avg += size;
+      if(size>max)
+        max = size;
+      if(size<min)
+        min = size;
+    }
+    avg = avg/(float)viewport.alignment.getHeight();
+
+    contents.append("<br>Sequences: "+ viewport.alignment.getHeight());
+    contents.append("<br>Minimum Sequence Length: "+min);
+    contents.append("<br>Maximum Sequence Length: "+max);
+    contents.append("<br>Average Length: "+(int)avg);
+
+    if (((Alignment)viewport.alignment).getProperties() != null)
+    {
+      Hashtable props = ((Alignment)viewport.alignment).getProperties();
+      Enumeration en = props.keys();
+      contents.append("<br><br><table border=\"1\">");
+      while(en.hasMoreElements())
+      {
+        String key = en.nextElement().toString();
+        StringBuffer val = new StringBuffer();
+        String vals = props.get(key).toString();
+        int pos=0, npos;
+        do {
+          npos = vals.indexOf("\n",pos);
+          if (npos==-1)
+          {
+            val.append(vals.substring(pos));
+          } else {
+            val.append(vals.substring(pos, npos));
+            val.append("<br>");
+          }
+          pos = npos+1;
+        } while (npos!=-1);
+        contents.append("<tr><td>"+key+"</td><td>"+val+"</td></tr>");
+      }
+      contents.append("</table>");
+    }
+    editPane.setText(contents.toString()+"</html>");
+    JInternalFrame frame = new JInternalFrame();
+    frame.getContentPane().add(new JScrollPane(editPane));
+
+    Desktop.instance.addInternalFrame(frame,"Alignment Properties: "+getTitle(),500,400);
+  }
+
+
   /**
    * DOCUMENT ME!
    *
@@ -2269,14 +2632,17 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
              sg.getEndRes()+1));
        }
         else
+        {
           sg.cs.setThreshold(0, viewport.getIgnoreGapsConsensus());
+        }
 
 
         if (viewport.getConservationSelected())
         {
           Conservation c = new Conservation("Group",
                                             ResidueProperties.propHash, 3,
-                                            sg.getSequences(viewport.hiddenRepSequences),
+                                            sg.getSequences(viewport.
+              hiddenRepSequences),
                                             sg.getStartRes(),
                                             sg.getEndRes()+1);
           c.calculate();
@@ -2284,16 +2650,21 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
           sg.cs.setConservation(c);
         }
         else
+        {
           sg.cs.setConservation(null);
       }
     }
+    }
 
     if (alignPanel.getOverviewPanel() != null)
     {
       alignPanel.getOverviewPanel().updateOverviewImage();
     }
 
-    alignPanel.repaint();
+
+
+
+    alignPanel.paintAlignment(true);
   }
 
   /**
@@ -2403,7 +2774,8 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
 
       while (userColours.hasMoreElements())
       {
-        final JRadioButtonMenuItem radioItem = new JRadioButtonMenuItem(userColours.
+        final JRadioButtonMenuItem radioItem = new JRadioButtonMenuItem(
+            userColours.
             nextElement().toString());
         radioItem.setName("USER_DEFINED");
         radioItem.addMouseListener(new MouseAdapter()
@@ -2414,16 +2786,19 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
                 {
                   radioItem.removeActionListener(radioItem.getActionListeners()[0]);
 
-                  int option = JOptionPane.showInternalConfirmDialog(jalview.gui.Desktop.desktop,
+              int option = JOptionPane.showInternalConfirmDialog(jalview.gui.
+                  Desktop.desktop,
                       "Remove from default list?",
                       "Remove user defined colour",
                       JOptionPane.YES_NO_OPTION);
                   if(option == JOptionPane.YES_OPTION)
                   {
-                    jalview.gui.UserDefinedColours.removeColourFromDefaults(radioItem.getText());
+                jalview.gui.UserDefinedColours.removeColourFromDefaults(
+                    radioItem.getText());
                     colourMenu.remove(radioItem);
                   }
                   else
+              {
                     radioItem.addActionListener(new ActionListener()
                     {
                       public void actionPerformed(ActionEvent evt)
@@ -2433,6 +2808,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
                     });
                 }
               }
+          }
             });
         radioItem.addActionListener(new ActionListener()
         {
@@ -2478,8 +2854,9 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     SequenceI [] oldOrder = viewport.getAlignment().getSequencesArray();
     AlignmentSorter.sortByPID(viewport.getAlignment(),
                               viewport.getAlignment().getSequenceAt(0));
-    addHistoryItem(new OrderCommand("Pairwise Sort", oldOrder, viewport.alignment));
-    alignPanel.repaint();
+    addHistoryItem(new OrderCommand("Pairwise Sort", oldOrder,
+                                    viewport.alignment));
+    alignPanel.paintAlignment(true);
   }
 
   /**
@@ -2492,7 +2869,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     SequenceI [] oldOrder = viewport.getAlignment().getSequencesArray();
     AlignmentSorter.sortByID(viewport.getAlignment());
     addHistoryItem(new OrderCommand("ID Sort", oldOrder, viewport.alignment));
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
 
   /**
@@ -2506,9 +2883,8 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     AlignmentSorter.sortByGroup(viewport.getAlignment());
     addHistoryItem(new OrderCommand("Group Sort", oldOrder, viewport.alignment));
 
-    alignPanel.repaint();
+    alignPanel.paintAlignment(true);
   }
-
   /**
    * DOCUMENT ME!
    *
@@ -2631,8 +3007,10 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   {
     TreePanel tp;
 
-    if (viewport.getSelectionGroup() != null) {
-      if (viewport.getSelectionGroup().getSize() < 3) {
+    if (viewport.getSelectionGroup() != null)
+    {
+      if (viewport.getSelectionGroup().getSize() < 3)
+      {
         JOptionPane.showMessageDialog(Desktop.desktop,
                                       "You need to have more than two sequences selected to build a tree!",
                                       "Not enough sequences",
@@ -2679,7 +3057,9 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
       }
 
       if(viewport.alignment.getHeight()<2)
+      {
         return;
+      }
 
       tp = new TreePanel(alignPanel, type, pwType);
     }
@@ -2687,7 +3067,9 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     title += " from ";
 
     if(viewport.viewName!=null)
+    {
       title+= viewport.viewName+" of ";
+    }
 
     title += this.title;
 
@@ -2713,12 +3095,80 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
         // TODO: JBPNote - have to map order entries to curent SequenceI pointers
         AlignmentSorter.sortBy(viewport.getAlignment(), order);
 
-        addHistoryItem(new OrderCommand(order.getName(), oldOrder, viewport.alignment));
+        addHistoryItem(new OrderCommand(order.getName(), oldOrder,
+                                        viewport.alignment));
 
-        alignPanel.repaint();
+        alignPanel.paintAlignment(true);
       }
     });
   }
+  /**
+   * Add a new sort by annotation score menu item
+   * @param sort the menu to add the option to
+   * @param scoreLabel the label used to retrieve scores for each sequence on the alignment
+   */
+  public void addSortByAnnotScoreMenuItem(JMenu sort, final String scoreLabel)
+  {
+    final JMenuItem item = new JMenuItem(scoreLabel);
+    sort.add(item);
+    item.addActionListener(new java.awt.event.ActionListener()
+    {
+      public void actionPerformed(ActionEvent e)
+      {
+        SequenceI [] oldOrder = viewport.getAlignment().getSequencesArray();
+        AlignmentSorter.sortByAnnotationScore(scoreLabel, viewport.getAlignment());
+        addHistoryItem(new OrderCommand("Sort by "+scoreLabel, oldOrder, viewport.alignment));
+        alignPanel.paintAlignment(true);
+      }
+    });
+  }
+  /**
+   * last hash for alignment's annotation array - used to minimise cost of rebuild.
+   */
+  protected int _annotationScoreVectorHash;
+  /**
+   * search the alignment and rebuild the sort by annotation score submenu
+   * the last alignment annotation vector hash is stored to minimize
+   * cost of rebuilding in subsequence calls.
+   *
+   */
+  public void buildSortByAnnotationScoresMenu()
+  {
+    if(viewport.alignment.getAlignmentAnnotation()==null)
+    {
+      return;
+    }
+
+    if (viewport.alignment.getAlignmentAnnotation().hashCode()!=_annotationScoreVectorHash)
+    {
+      sortByAnnotScore.removeAll();
+      // almost certainly a quicker way to do this - but we keep it simple
+      Hashtable scoreSorts=new Hashtable();
+      AlignmentAnnotation aann[];
+      Enumeration sq = viewport.alignment.getSequences().elements();
+      while (sq.hasMoreElements())
+      {
+        aann = ((SequenceI) sq.nextElement()).getAnnotation();
+        for (int i=0;aann!=null && i<aann.length; i++)
+        {
+          if (aann[i].hasScore() && aann[i].sequenceRef!=null)
+          {
+            scoreSorts.put(aann[i].label, aann[i].label);
+          }
+        }
+      }
+      Enumeration labels = scoreSorts.keys();
+      while (labels.hasMoreElements())
+      {
+        addSortByAnnotScoreMenuItem(sortByAnnotScore, (String) labels.nextElement());
+      }
+      sortByAnnotScore.setVisible(scoreSorts.size()>0);
+      scoreSorts.clear();
+
+      _annotationScoreVectorHash =
+          viewport.alignment.getAlignmentAnnotation().hashCode();
+    }
+  }
 
   /**
    * Maintain the Order by->Displayed Tree menu.
@@ -2733,7 +3183,8 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   {
     sortByTreeMenu.removeAll();
 
-    Vector comps = (Vector)PaintRefresher.components.get(viewport.getSequenceSetId());
+    Vector comps = (Vector) PaintRefresher.components.get(viewport.
+        getSequenceSetId());
     Vector treePanels = new Vector();
     int i, iSize = comps.size();
     for(i=0; i<iSize; i++)
@@ -2770,7 +3221,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
                                           oldOrder,
                                           viewport.alignment));
 
-          alignPanel.repaint();
+          alignPanel.paintAlignment(true);
         }
       });
 
@@ -2843,7 +3294,8 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     // TODO: viewport.alignment.isAligned is a global state - the local selection may well be aligned - we preserve 2.0.8 behaviour for moment.
     if (!viewport.alignment.isAligned())
     {
-      seqs.setSequences(new SeqCigar[] { seqs.getSequences()[0] } );
+      seqs.setSequences(new SeqCigar[]
+                        {seqs.getSequences()[0]});
     }
     return seqs;
   }
@@ -2891,11 +3343,16 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
   {
     return ShowNewickTree(nf,title,600,500,4,5);
   }
-  public TreePanel ShowNewickTree(NewickFile nf, String title, AlignmentView input)
+
+  public TreePanel ShowNewickTree(NewickFile nf, String title,
+                                  AlignmentView input)
   {
     return ShowNewickTree(nf,title, input, 600,500,4,5);
   }
-  public TreePanel ShowNewickTree(NewickFile nf, String title, int w,int h,int x, int y) {
+
+  public TreePanel ShowNewickTree(NewickFile nf, String title, int w, int h,
+                                  int x, int y)
+  {
     return ShowNewickTree(nf, title, null, w, h, x, y);
   }
   /**
@@ -2910,7 +3367,10 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
    * @param y position
    * @return TreePanel handle
    */
-  public TreePanel ShowNewickTree(NewickFile nf, String title, AlignmentView input, int w,int h,int x, int y) {
+  public TreePanel ShowNewickTree(NewickFile nf, String title,
+                                  AlignmentView input, int w, int h, int x,
+                                  int y)
+  {
     TreePanel tp = null;
 
     try
@@ -2927,7 +3387,9 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
         tp.setSize(w,h);
 
         if(x>0 && y>0)
+        {
           tp.setLocation(x,y);
+        }
 
 
         Desktop.addInternalFrame(tp, title, w, h);
@@ -2970,7 +3432,9 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
             {
               AlignmentView msa = gatherSequencesForAlignment();
               new jalview.ws.MsaWSClient(sh, title, msa,
-                  false, true, viewport.getAlignment().getDataset(), af);
+                                         false, true,
+                                         viewport.getAlignment().getDataset(),
+                                         af);
 
             }
 
@@ -2987,7 +3451,9 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
               {
                 AlignmentView msa = gatherSequencesForAlignment();
                 new jalview.ws.MsaWSClient(sh, title, msa,
-                    true, true, viewport.getAlignment().getDataset(), af);
+                                           true, true,
+                                           viewport.getAlignment().getDataset(),
+                                           af);
 
               }
 
@@ -3032,7 +3498,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
         }
         wsmenu.add(secstrmenu);
       }
-      this.webService.removeAll();
+      resetWebServiceMenu();
       for (int i = 0, j = wsmenu.size(); i < j; i++)
       {
         webService.add( (JMenu) wsmenu.get(i));
@@ -3040,7 +3506,7 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     }
     else
     {
-      this.webService.removeAll();
+      resetWebServiceMenu();
       this.webService.add(this.webServiceNoServices);
     }
     // TODO: add in rediscovery function
@@ -3048,6 +3514,31 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
     // TODO: group services by location as well as function.
   }
 
+
+  /**
+   * empty the web service menu and add any ad-hoc functions
+   * not dynamically discovered.
+   *
+   */
+  private void resetWebServiceMenu()
+  {
+    webService.removeAll();
+    // Temporary hack - DBRef Fetcher always top level ws entry.
+    JMenuItem rfetch = new JMenuItem("Fetch DB References");
+    rfetch.setToolTipText("Retrieve and parse uniprot records for the alignment or the currently selected sequences");
+    webService.add(rfetch);
+    rfetch.addActionListener(new ActionListener() {
+
+      public void actionPerformed(ActionEvent e)
+      {
+        new jalview.ws.DBRefFetcher(
+                alignPanel.av.getSequenceSelection(),
+                alignPanel.alignFrame).fetchDBRefs(false);
+      }
+
+    });
+  }
+
  /* public void vamsasStore_actionPerformed(ActionEvent e)
   {
     JalviewFileChooser chooser = new JalviewFileChooser(jalview.bin.Cache.
@@ -3066,98 +3557,164 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener
       vs.storeJalview( chooser.getSelectedFile().getAbsolutePath(), this);
     }
   }*/
-
-
-
-
-public void showTranslation_actionPerformed(ActionEvent e)
-{
-  SequenceI [] selection = viewport.getSelectionAsNewSequence();
-  String [] seqstring = viewport.getViewAsString(true);
-
-  int s, sSize = selection.length;
-  SequenceI [] newSeq = new SequenceI[sSize];
-
-  int res, resSize;
-  StringBuffer protein;
-  String seq;
-  for(s=0; s<sSize; s++)
+  /**
+   * prototype of an automatically enabled/disabled analysis function
+   *
+   */
+  protected void setShowProductsEnabled()
   {
-    protein = new StringBuffer();
-    seq = AlignSeq.extractGaps("-. ", seqstring[s]);
-    resSize = seq.length();
-    resSize -= resSize%3;
-
-    for(res = 0; res < resSize; res+=3)
+    SequenceI [] selection = viewport.getSequenceSelection();
+    if (canShowProducts(selection, viewport.getSelectionGroup()!=null, viewport.getAlignment().getDataset()))
     {
-      String codon = seq.substring(res, res+3);
-      codon = codon.replace('U', 'T');
-      String aa = ResidueProperties.codonTranslate(codon);
-      if(aa==null)
-        protein.append(viewport.getGapCharacter());
-      else if(aa.equals("STOP"))
-        protein.append("X");
-      else
-        protein.append( aa );
+      showProducts.setEnabled(true);
+      
+    } else {
+      showProducts.setEnabled(false);
     }
-    newSeq[s] = new Sequence(selection[s].getName(),
-                             protein.toString());
   }
-
-
-  AlignmentI al = new Alignment(newSeq);
-  al.setDataset(null);
-
-
-  ////////////////////////////////
-  // Copy annotations across
-  jalview.datamodel.AlignmentAnnotation[] annotations
-      = viewport.alignment.getAlignmentAnnotation();
-  int a, aSize;
-  if(annotations!=null)
+  /**
+   * search selection for sequence xRef products and build the
+   * show products menu.
+   * @param selection
+   * @param dataset
+   * @return true if showProducts menu should be enabled.
+   */
+  public boolean canShowProducts(SequenceI[] selection, boolean isRegionSelection, Alignment dataset)
   {
-    for (int i = 0; i < annotations.length; i++)
-    {
-      if (annotations[i].label.equals("Quality") ||
-          annotations[i].label.equals("Conservation") ||
-          annotations[i].label.equals("Consensus"))
+    boolean showp=false;
+    try {
+      showProducts.removeAll();
+      final boolean dna = viewport.getAlignment().isNucleotide();
+      final Alignment ds = dataset;
+      String[] ptypes = CrossRef.findSequenceXrefTypes(dna, selection, dataset);
+      //Object[] prods = CrossRef.buildXProductsList(viewport.getAlignment().isNucleotide(), selection, dataset, true);
+      final SequenceI[] sel = selection;
+      for (int t=0; ptypes!=null && t<ptypes.length; t++)
       {
-        continue;
+        showp=true;
+        final boolean isRegSel = isRegionSelection;
+        final AlignFrame af = this;
+        final String source = ptypes[t];
+        JMenuItem xtype = new JMenuItem(ptypes[t]);
+        xtype.addActionListener(new ActionListener() {
+
+          public void actionPerformed(ActionEvent e)
+          {
+            af.showProductsFor(sel, ds, isRegSel, dna, source);
+          }
+          
+        });
+        showProducts.add(xtype);
       }
+      showProducts.setVisible(showp);
+      showProducts.setEnabled(showp);
+    } catch (Exception e)
+    {
+      jalview.bin.Cache.log.warn("canTranslate threw an exception - please report to help@jalview.org",e);
+     return false;
+    }
+    return showp;
+  }
+protected void showProductsFor(SequenceI[] sel, Alignment ds, boolean isRegSel, boolean dna, String source)
+  {
+  ds = this.getViewport().alignment.getDataset(); // update our local dataset reference
+  Alignment prods = CrossRef.findXrefSequences(sel, dna, source, ds);
+  if (prods!=null)
+  {
+    SequenceI[] sprods = new SequenceI[prods.getHeight()];
+    for (int s=0; s<sprods.length;s++)
+    {
+      sprods[s] = (prods.getSequenceAt(s)).deriveSequence();
+      if (ds.getSequences()==null || !ds.getSequences().contains(sprods[s].getDatasetSequence()))
+        ds.addSequence(sprods[s].getDatasetSequence());
+    }
+    Alignment al = new Alignment(sprods);
+    AlignedCodonFrame[] cf = prods.getCodonFrames();
+    for (int s=0; cf!=null && s<cf.length; s++)
+    {
+      al.addCodonFrame(cf[s]);
+      cf[s] = null;
+    }
+    al.setDataset(ds);
+    AlignFrame naf = new AlignFrame(al, DEFAULT_WIDTH, DEFAULT_HEIGHT);
+    String newtitle =""+((dna) ? "Proteins " : "Nucleotides ") + " for "+((isRegSel) ? "selected region of " : "")
+            + getTitle();
+    Desktop.addInternalFrame(naf, newtitle, DEFAULT_WIDTH,
+            DEFAULT_HEIGHT);
+  } else {
+    System.err.println("No Sequences generated for xRef type "+source);
+  }
+  }
 
-      aSize = viewport.alignment.getWidth() / 3;
-      jalview.datamodel.Annotation[] anots =
-          new jalview.datamodel.Annotation[aSize];
-
-      for (a = 0; a < viewport.alignment.getWidth(); a++)
-      {
-        if (annotations[i].annotations[a] == null
-            || annotations[i].annotations[a] == null)
-          continue;
 
-        anots[a / 3] = new Annotation(
-            annotations[i].annotations[a].displayCharacter,
-            annotations[i].annotations[a].description,
-            annotations[i].annotations[a].secondaryStructure,
-            annotations[i].annotations[a].value,
-            annotations[i].annotations[a].colour);
-      }
+public boolean canShowTranslationProducts(SequenceI[] selection, AlignmentI alignment)
+{
+  // old way
+  try {
+      return (jalview.analysis.Dna.canTranslate(selection, viewport.getViewAsVisibleContigs(true)));
+  } catch (Exception e)
+  {
+    jalview.bin.Cache.log.warn("canTranslate threw an exception - please report to help@jalview.org",e);
+   return false;
+  }
+}
 
-      jalview.datamodel.AlignmentAnnotation aa
-          = new jalview.datamodel.AlignmentAnnotation(annotations[i].label,
-          annotations[i].description, anots);
-      al.addAnnotation(aa);
+public void showProducts_actionPerformed(ActionEvent e)
+{
+  ///////////////////////////////
+  // Collect Data to be translated/transferred
+  
+  SequenceI [] selection = viewport.getSequenceSelection();
+  AlignmentI al  = null;
+  try {
+      al = jalview.analysis.Dna.CdnaTranslate(selection, viewport.getViewAsVisibleContigs(true),
+          viewport.getGapCharacter(), viewport.getAlignment().getDataset());
+    } catch (Exception ex) {
+      al = null;
+      jalview.bin.Cache.log.debug("Exception during translation.",ex);
+    }
+    if (al==null)
+    {
+      JOptionPane.showMessageDialog(Desktop.desktop,
+          "Please select at least three bases in at least one sequence in order to perform a cDNA translation.",
+          "Translation Failed",
+          JOptionPane.WARNING_MESSAGE);
+    } else {
+      AlignFrame af = new AlignFrame(al, DEFAULT_WIDTH, DEFAULT_HEIGHT);
+      Desktop.addInternalFrame(af, "Translation of "+this.getTitle(),
+                               DEFAULT_WIDTH,
+                               DEFAULT_HEIGHT);
     }
   }
 
+public void showTranslation_actionPerformed(ActionEvent e)
+{
+  ///////////////////////////////
+  // Collect Data to be translated/transferred
+
+  SequenceI [] selection = viewport.getSequenceSelection();
+  String [] seqstring = viewport.getViewAsString(true);
+  AlignmentI al  = null;
+  try {
+    al = jalview.analysis.Dna.CdnaTranslate(selection, seqstring, viewport.getViewAsVisibleContigs(true),
+        viewport.getGapCharacter(), viewport.alignment.getAlignmentAnnotation(),
+        viewport.alignment.getWidth(), viewport.getAlignment().getDataset());
+  } catch (Exception ex) {
+    al = null;
+    jalview.bin.Cache.log.debug("Exception during translation.",ex);
+  }
+  if (al==null)
+  {
+    JOptionPane.showMessageDialog(Desktop.desktop,
+        "Please select at least three bases in at least one sequence in order to perform a cDNA translation.",
+        "Translation Failed",
+        JOptionPane.WARNING_MESSAGE);
+  } else {
     AlignFrame af = new AlignFrame(al, DEFAULT_WIDTH, DEFAULT_HEIGHT);
     Desktop.addInternalFrame(af, "Translation of "+this.getTitle(),
                              DEFAULT_WIDTH,
                              DEFAULT_HEIGHT);
-
-
-
-
+  }
 }
 
 /**
@@ -3168,8 +3725,10 @@ public void showTranslation_actionPerformed(ActionEvent e)
 public boolean parseFeaturesFile(String file, String type)
 {
     boolean featuresFile = false;
-    try{
-      featuresFile = new FeaturesFile(file, type).parse(viewport.alignment.getDataset(),
+    try
+    {
+      featuresFile = new FeaturesFile(file,
+          type).parse(viewport.alignment.getDataset(),
                                          alignPanel.seqPanel.seqCanvas.
                                          getFeatureRenderer().featureColours,
                                          false);
@@ -3183,7 +3742,7 @@ public boolean parseFeaturesFile(String file, String type)
     {
       viewport.showSequenceFeatures = true;
       showSeqFeatures.setSelected(true);
-      alignPanel.repaint();
+      alignPanel.paintAlignment(true);
     }
 
     return featuresFile;
@@ -3208,12 +3767,14 @@ public void drop(DropTargetDropEvent evt)
 
     try
     {
-      DataFlavor uriListFlavor = new DataFlavor("text/uri-list;class=java.lang.String");
+      DataFlavor uriListFlavor = new DataFlavor(
+          "text/uri-list;class=java.lang.String");
       if (t.isDataFlavorSupported(DataFlavor.javaFileListFlavor))
       {
         //Works on Windows and MacOSX
         evt.acceptDrop(DnDConstants.ACTION_COPY_OR_MOVE);
-        files = (java.util.List) t.getTransferData(DataFlavor.javaFileListFlavor);
+        files = (java.util.List) t.getTransferData(DataFlavor.
+            javaFileListFlavor);
       }
       else if (t.isDataFlavorSupported(uriListFlavor))
       {
@@ -3266,7 +3827,8 @@ public void drop(DropTargetDropEvent evt)
   // AlignFrame
    public void loadJalviewDataFile(String file)
   {
-    try{
+    try
+    {
       String protocol = "File";
 
       if (file.indexOf("http:") > -1 || file.indexOf("file:") > -1)
@@ -3292,19 +3854,23 @@ public void drop(DropTargetDropEvent evt)
                 viewport.getAlignment(),
                 0, false);
             alignPanel.adjustAnnotationHeight();
-            alignPanel.repaint();
+            alignPanel.paintAlignment(true);
           }
           else
+          {
             new FileLoader().LoadFile(viewport, file, protocol, format);
         }
       }
+      }
       else
       {
         // (isAnnotation)
         alignPanel.adjustAnnotationHeight();
+        buildSortByAnnotationScoresMenu();
       }
 
-    }catch(Exception ex)
+    }
+    catch (Exception ex)
     {
       ex.printStackTrace();
     }
@@ -3342,9 +3908,23 @@ public void drop(DropTargetDropEvent evt)
   {
     return viewport;
   }
+
+
+  /**
+   * Open the dialog for regex description parsing.
+   */
+  protected void extractScores_actionPerformed(ActionEvent e)
+  {
+    ParseProperties pp = new jalview.analysis.ParseProperties(viewport.alignment);
+    if (pp.getScoresFromDescription("col", "score column ", "\\W+([-+]?\\d*\\.?\\d*e?-?\\d*)\\W+([-+]?\\d*\\.?\\d*e?-?\\d*)")>0)
+    {
+      buildSortByAnnotationScoresMenu();
+    }
+  }
 }
 
-class PrintThread extends Thread
+class PrintThread
+    extends Thread
 {
   AlignmentPanel ap;
   public PrintThread(AlignmentPanel ap)
@@ -3357,9 +3937,13 @@ class PrintThread extends Thread
     PrinterJob printJob = PrinterJob.getPrinterJob();
 
     if (pf != null)
+    {
       printJob.setPrintable(ap, pf);
+    }
     else
+    {
       printJob.setPrintable(ap);
+    }
 
     if (printJob.printDialog())
     {