JAL-2418 occupancy row in What’s New
[jalview.git] / help / html / whatsNew.html
index 5d00e19..847b1fe 100755 (executable)
 <html>
 <!--
- * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8)
- * Copyright (C) 2012 J Procter, AM Waterhouse, LM Lui, J Engelhardt, G Barton, M Clamp, S Searle
+ * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
+ * Copyright (C) $$Year-Rel$$ 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 some 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 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 in Jalview 2.10.2 ?</strong>
+  </p>
+  <p>This August 2018 release of Jalview introduces new user interface features, improved and more extensible tree and PCA analysis, more robust 3D structure viewing with UCSF Chimera and an updated service client for JABAWS. The full list of bug fixes and new features can be found in the <a
+      href="releases.html#Jalview.2.10.2"> 2.10.2 Release Notes</a>, but the
+    highlights are below.
+  </p>
+  <ul>
+    <li><strong>New dialog and faster and more
+        configurable Tree and PCA calculations</strong><br> Menu entries for
+      calculating PCA and different types of tree have been replaced by
+      a single <a href="calculations/calculations.html"><em>Calculations</em>
+        dialog box</a>. The underlying implementation for the PCA and tree
+      calculations have been made faster and more memory efficient.</li>
+    <li><strong>Extensible score models</strong><br />A new
+      framework has also been created for the score models used to
+      calculate distances between sequences and shade alignments. This
+      framework allows import of substitution matrices in NCBI and
+      AAIndex format.<br />
+    <strong>PCA Bug Fixes</strong>. Jalview's implementation of PCA
+      differed in its treatment of gaps and non-standard residues. The
+      BLOSUM62 matrix also included a typo that affected results. See the
+      <a href="releases.html#2102scoremodelbugs">2.10.2 release note
+        about score model bugs</a> for details and how to reinstate legacy
+      behaviour.</li>
+    <li><strong>Update to JABAWS 2.2</strong><br />Jalview's
+      alignment, protein conservation analysis, and protein disorder and
+      RNA secondary structure prediction services are now provided by <a
+      href="http://www.compbio.dundee.ac.uk/jabaws">JABAWS 2.2</a>.
+      Several of the programs provided as JABAWS 2.2 services have been
+      updated, so their options and parameters have changed.</li>
+    <li><strong>URL linkouts to other bioinformatics
+        databases</strong><br />New preferences for <a
+      href="webServices/urllinks.html">opening web pages for
+        database cross-references</a> via the UK Elixir's EMBL-EBI's MIRIAM
+      database and identifiers.org services.</li>
+    <li><strong>Showing and hiding regions</strong> <br /> <a
+      href="menus/popupMenu.html#hideinserts">Hide insertions</a> in the
+      PopUp menu has changed its behaviour. Prior to 2.10.2, columns
+      were only shown or hidden according to gaps in the sequence under
+      the popup menu. Now, only columns that are gapped in all selected
+      sequences as well as the sequence under the popup menu are hidden,
+      and column visibility outside the selected region is left as is.
+      This makes it easy to filter insertions from the alignment view
+      (just select the region containing insertions to remove) without
+      affecting the rest of the hidden columns.</li>
+    <li><strong>Gap count - a.k.a. the Occupancy
+        Annotation Row</strong><br /> Another way to filter columns according to
+      the presence of gaps is to enable the <strong>Occupancy
+        Annotation</strong> row via Jalview's Preferences. This annotation row
+      shows a histogram of the number of aligned residues at each
+      column. The <a href="features/columnFilterByAnnotation.html">Select
+        By Annotation</a> dialog now also includes a percentage threshold
+      mode, to make it easy to filter alignments to show only those
+      columns with a particular fraction of aligned sequences.</li>
+    <li><strong>Recent search history for Find, PDBe and
+        Uniprot</strong><br />Easily repeat a previous search for <a
+      href="features/search.html#queryhistory">Find</a> and the free
+      text search system (for querying Uniprot and the PDBe).</li>
+    <li><strong>Improved Overview Window</strong><br />The <a
+      href="features/overview.html">alignment overview</a> is now easier
+      to use when working with alignments of more than 5000 rows and
+      columns, and features a new pop-up menu that allows hidden regions
+      to be excluded from the overview. It also works with CDS/Protein
+      alignments and MSA views in wrapped mode.</li>
+    <li><strong>3D Structure</strong><br />Jalview's communication
+      with UCSF Chimera has been made more robust, particularly when
+      working with many structures and long sequences. Regions in
+      structures that correspond to hidden regions in an alignment view
+      are now left un-coloured, making it easier to highlight specific
+      features in 3D. See below for <a href="#experimental">experimental
+        features for exchanging annotation between Chimera and Jalview.</a></li>
+  </ul>
+  <p>
+    <strong>Scripting</strong><br />New <a
+      href="http://www.jalview.org/examples/groovy">groovy examples</a>
+    demonstrate Jalview 2.10.2 APIs for creation of data-driven
+    colourschemes, and custom alignment file handlers. The <a
+      href="groovy/featuresCounter.html">FeatureAnnotationWorker</a>
+    introduced in Jalview 2.10 has also been refactored to allow
+    efficient counting across multiple feature types. Please be aware
+    that feature counter scripts created for earlier versions will not
+    execute in Jalview 2.10.2.
+  </p>
+  <p>
+    <strong><a name="experimental">Experimental Features</a></strong>
+  </p>
+  <p>
+    This release of Jalview introduces an <em>Experimental Features</em>
+    option in the Jalview Desktop's <em>Tools</em> menu that allows you
+    to try out features that are still in development. To access the
+    experimental features below - first enable the <strong>Tools&#8594;Enable
+      Experimental Features</strong> option, and then restart Jalview.
+  </p>
+  <ul>
+    <li><em>Annotation transfer between Chimera and Jalview</em><br />Two
+      <a href="features/chimera.html#experimental">new entries in
+        the Chimera viewer's Chimera menu</a> allow positional annotation to
+      be exchanged between Chimera and Jalview.</li>
+  </ul>
+
 </body>
 </html>