JAL-1517 documentation for 2.8.2 release
[jalview.git] / help / html / whatsNew.html
index b81031d..a5d5d4a 100755 (executable)
 <html>
 <!--
- * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8.0b1)
+ * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8.2)
  * Copyright (C) 2014 The Jalview Authors
  * 
  * This file is part of Jalview.
  * 
  * Jalview is free software: you can redistribute it and/or
  * modify it under the terms of the GNU General Public License 
- * as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+ * as published by the Free Software Foundation, either version 3
+ * of the License, or (at your option) any later version.
  *  
  * Jalview is distributed in the hope that it will be useful, but 
  * WITHOUT ANY WARRANTY; without even the implied warranty 
  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
  * PURPOSE.  See the GNU General Public License for more details.
  * 
- * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
+ * You should have received a copy of the GNU General Public License
+ * along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
  * The Jalview Authors are detailed in the 'AUTHORS' file.
--->
+ -->
 <head>
 <title>What's new ?</title>
 </head>
 <body>
- <p>
-  <strong>What's new ?</strong><br/>
-  Jalview 2.8 includes a number of enhancements and new features that
-  have been in development since July 2010. It is also the first Jalview
-  release to incorporate RNA visualization features developed by Lauren
-  Lui and Jan Engelhart during their Google Summer of Code projects
-  (http://code.google.com/soc/). As usual you can find the highlights
-  below, but to see the comprehensive list take a look at the look at
-  the <a href="releases.html#Jalview2.8">Jalview 2.8 Release Notes</a>.
- </p>
- <strong>Highlights in Jalview Version 2.8</strong>
- <ul>
-  <li><strong>Improved <a href="webServices/JABAWS.html">JABAWS</a>
-    client and new JABAWS 2.0 Services
-  </strong>
-   <ul>
-    <li><a href="webServices/AACon.html">AACon alignment
-      conservation</a></li>
-    <li><a href="webServices/proteinDisorder.html">Protein
-      disorder</a> - DisEMBL, RONN, GlobPlot and IUPred</li>
-    <li>Clustal Omega for creating huge protein alignments</li>
-   </ul></li>
-  <li><strong><a href="na/index.html">RNA</a></strong>
-   <ul>
-    <li>Import sequence and alignment associated WUSS or VIENNA
-     dot-bracket notation from files and the <strong>RFAM</strong>
-     database
-    </li>
-    <li>Interactive editing of RNA secondary structure annotation</li>
-    <li>Colour scheme for purine/pyrimidine and to highlight RNA
-     helices</li>
-    <li>RNA canonical <a
-     href="calculations/structureconsensus.html">base pair consensus
-      score</a> and sequence logo
-    </li>
-    <li>Embedded <a href="features/varna.html">VARNA</a> RNA
-     secondary structure viewer in the Desktop
-    </li>
-   </ul></li>
-  <li>Parse and display <a href="io/tcoffeescores.html">T-COFFEE
-    alignment quality scores</a> (thanks to Paolo di Tomasso of the Notredame
-   Group)
-  </li>
-  <li><a href="colourSchemes/annotationColouring.html">Per
-    sequence alignment annotation shading</a></li>
-  <li>Enhanced <a href="calculations/pca.html">PCA viewer</a>: more
-   export options, and switch between different PCA modes and residue
-   score models
-  </li>
-  <li>New Jalview Desktop <a href="webServices/dbreffetcher.html">database
-    fetcher</a> GUI
-  </li>
-  <li>Support for DAS 1.6 and DAS 2.0 sources (thanks to the new
-   JDAS Distributed Annotation client library (see
-   http://code.google.com/p/jdas))</li>
-  <li>Export sequence database annotation as an <a
-   href="io/exportseqreport.html">HTML report</a></li>
-  <li>Normalised <a href="calculations/consensus.html">Sequence
-    Logo Display</a></li>
- </ul>
- <p>
-  <strong>Issues resolved in the Jalview Desktop</strong>
- </p>
- <ul>
-  <li>PDB, Unprot and EMBL (ENA) databases retrieved via wsdbfetch
-   REST service</li>
-  <li>Stop windows being moved outside desktop on OSX</li>
-  <li>Jnet job queues forever if a very short sequence is submitted
-   for prediction</li>
-  <li>Structure view highlighting doesn't work on windows 7</li>
-  <li>Jalview desktop fails to launch with exception when using
-   proxy</li>
-  <li>DAS Sequence retrieval with range qualification results in
-   sequence xref which includes range qualification</li>
-  <li>Cannot close news reader when JABAWS server warning dialog is
-   shown</li>
-  <li>Edited sequence not submitted to web service</li>
-  <li>Jalview 2.7 InstallAnywhere installer doesn't unpack and run
-   on OSX Mountain Lion
-   <ul>
-    <li>If you use webstart then you may need to go into the
-     Security panel (<em>a.k.a</em> the gatekeeper) in your System
-     Settings, and select the 'allow any code to run' option.
-    </li>
-   </ul>
-  </li>
- </ul>
- <p>
-  <strong>Issues specific to the JalviewLite Applet</strong>
- </p>
- <ul>
-  <li>Sequence features are momentarily displayed before they are
-   hidden using hidefeaturegroups applet parameter</li>
-  <li>loading features via javascript API automatically enables
-   feature display</li>
-  <li>scrollToColumnIn javascript API method doesn't work</li>
- </ul>
- <p>
-  <strong>Issues affecting both applet and application</strong>
- </p>
- <ul>
-  <li>Redundancy removal fails for rna alignment</li>
-  <li>PCA window shows grey box when first opened on OSX</li>
-  <li>Letters coloured pink in sequence logo when alignment
-   coloured with clustalx</li>
- </ul>
+       <p>
+               <strong>What's new ?</strong>
+       </p>
+       <p>
+               Jalview 2.8.2 is the first release produced by our new core
+               development team.<br /> It incorporates many minor improvements and
+               bug-fixes, and new features for working with 3D structure data,
+               shading alignments by secondary structure and generation of alignment
+               figures as Scalable Vector Graphics. <br />The majority of
+               improvements in this version of Jalview concern the desktop
+               application. As ever, the highlights are detailed below,
+               and the full list is given in the <a
+                       href="releases.html#Jalview.2.8.2">Jalview 2.8.2 Release Notes</a>.
+       </p>
+       <p>
+               <strong>Annotation visualisation</strong> <br /> The alignment window
+               includes a new <em>Annotations</em> menu which provides controls for
+               the layout and display of sequence, group and alignment associated
+               annotation rows. It also now includes the <em>Autocalculated
+                       Annotation</em> submenu (formerly located in the View menu), which
+               includes settings for the calculation and display of sequence
+               consensus, logos, and amino acid conservation for the alignment and
+               subgroups.
+       </p>
+       <p>
+               <strong>Sequence associated annotation</strong><br /> New controls
+               have also been added to the Sequence ID popup menu for the propagation
+               and display of sequence associated annotation such as secondary
+               structure assignments and disorder predictions. Annotation associated
+               with one or a group of sequence already shown on the alignment may be
+               shown or hidden, and any available annotation from 3D structure or
+               calculations performed in other Jalview windows can be copied to the
+               alignment
+               <em>via</em> the <strong>Add Reference Annotation</strong> option.<br />
+               The <strong>Colour by annotation</strong> function has also been
+               improved, allowing secondary structure annotation to be used to shade
+               sequences and alignment columns. Protein sequences can be coloured
+               according to the presence of a helix or sheet at each position, and
+               RNA sequences can be shaded according to each structure's stem/helix
+               pattern - which enables different RNA folding topologies to be quickly
+               identified.
+       </p>
+       <p>
+               <strong>3D Structural data analysis and display</strong><br />
+               Jalview now employs Jmol's PDB data API to retrieve secondary
+               structure assignments made by the DSSP algorithm. It can also employ
+               web services to obtain secondary structure assignments from RNA
+               structures. These assignments are shown as sequence associated
+               annotation for sequences which have cross-references to the PDB, or
+               have had PDB files associated with them via the <em>Structures</em>
+               submenu of the sequence ID popup menu. The extraction and display of
+               secondary structure and B-factor column annotation is controlled <em>via</em>
+               a new <strong>Structure</strong> tab in the Jalview Desktop's
+               Preferences dialog box.
+       </p>
+       <p>
+               <Strong>Interoperation with UCSF Chimera</Strong><br /> The desktop
+               application can now be configured to employ UCSF Chimera for the
+               display of 3D structure data. UCSF Chimera is a python-based
+               high-performance molecular graphics and animation system developed by
+               the Resource for Biocomputing, Visualisation, and Informatics at the
+               University of California.<br />Jalview employs the 'StructureViz'
+               communication mechanism developed for Cytoscape by Morris et al.
+               (http://www.ncbi.nlm.nih.gov/pubmed/17623706) in 2007. This mechanism
+               allows Jalview to send commands to Chimera, enabling structures to be
+               superimposed and shaded according to associated multiple aligmment
+               views. <br />Support for Chimera in Jalview 2.8.2 is experimental, and we
+               would appreciate feedback ! Please send your comments to
+               jalview-discuss@jalview.org, and keep up to date with this feature's
+               development via http://issues.jalview.org/browse/JAL-1333.
+       </p>
+       <p>
+               <strong>Export of alignment figures as Scalable Vector
+                       Graphics</strong> <br />Scalable Vector Graphics (SVG) files are now widely
+               supported by web browsers and graphics design programs, and allow
+               high-quality graphics for interactive exploration and publication.
+               Jalview now supports the generation of SVGs interactively (via the
+               Export) menu, and from the command line for server-side figure
+               generation.
+       </p>
+
 </body>
 </html>