JAL-2418 occupancy row in What’s New
[jalview.git] / help / html / whatsNew.html
index e6ab695..847b1fe 100755 (executable)
 <html>
 <!--
- * Jalview - A Sequence Alignment Editor and Viewer (Version 2.5)
- * Copyright (C) 2010 J Procter, AM Waterhouse, 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></p>
-<p>Jalview 2.5.1 is a bug fix release for the 2.5 version of
-Jalview. See the <a href="releases.html#Jalview2.5.1">release
-history</a> for the bugs that this release resolves.</p>
-<p><strong>Highlights in Jalview Version 2.5</strong></p>
-<ul>
-                       Linked viewing of nucleic acid sequences and structures<br/>
-                       Automatic Scrolling option in View menu to display the
-                       currently highlighted region of an alignment.<br/>
-                       Order an alignment by sequence length, or using the average score or total feature count for each sequence.<br/>
-                       Shading features by score or associated description<br/>
-                       Subdivide alignment and groups based on identity of selected subsequence (Make Groups from Selection).<br/>
-                       New hide/show options including Shift+Control+H to hide everything but the currently selected region.<br/>
-</ul>
-<em>Jalview Desktop:</em>
-<ul>
-       Fetch DB References capabilities and UI expanded to support
-       retrieval from DAS sequence sources<br/>
-       Enable or disable non-positional feature and database
-       references in sequence ID tooltip from View menu in application.<br/>
-       Group-associated consensus, sequence logos and conservation
-       plots<br/>
-       Symbol distributions for each column can be exported and
-       visualized as sequence logos<br/>
-       Jalview Java Console<br/>
-       New webservice for submitting sequences and IDs to <a
-               href="webServices/index.html#envision2">Envision2</a> Workflows<br/>
-       Improved VAMSAS synchronization and sharing of selections.<br/>
-</ul>
-<em>JalviewLite:</em>
-<ul>
-       Middle button resizes annotation row height<br/>
-       New Parameters  - including default tree display settings.<br/>
-       Non-positional features displayed in ID tooltip<br/>
-</ul>
-<p><strong>Issues Resolved (a select list)</strong></p>
-<ul>
-       <ul>
-               Source field in GFF files parsed as feature source rather
-               than description<br/>
-               Non-positional features are now included in sequence feature
-               and gff files (controlled via non-positional feature visibility in
-               tooltip).<br/>
-               URL links generated for all feature links (bugfix)<br/>
-               Codons containing ambiguous nucleotides translated as 'X' in
-               peptide product<br/>
-               Match case switch in find dialog box works for both sequence
-               ID and sequence string and query strings do not have to be in upper
-               case to match case-insensitively.<br/>
-               Jalview Annotation File generation/parsing consistent with
-               documentation (e.g. Stockholm annotation can be exported and
-               re-imported)<br/>
-               Find incrementally searches ID string matches as well as
-               subsequence matches, and correctly reports total number of both.<br/>
-       </ul>
-       <em>Desktop Issues</em>
-       <ul>
-                       Better handling of exceptions during sequence retrieval<br/>
-                       PDB files retrieved from URLs are cached properly<br/>
-                       Sequence description lines properly shared via VAMSAS<br/>
-                       Sequence fetcher fetches multiple records for all data
-                       sources<br/>
-                       Ensured that command line das feature retrieval completes
-                       before alignment figures are generated.<br/>
-                       Reduced time taken when opening file browser for first time.<br/>
-                       User defined group colours properly recovered from Jalview projects.<br/>
-               </ul>
-</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>
 
-<p>&nbsp;</p>
-<p>See the <a href="releases.html">Release History</a> page for
-details of all new features and resolved issues.</p>
 </body>
 </html>