JAL-2418 occupancy row in What’s New
[jalview.git] / help / html / whatsNew.html
index a5d5d4a..847b1fe 100755 (executable)
@@ -1,7 +1,7 @@
 <html>
 <!--
- * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8.2)
- * Copyright (C) 2014 The Jalview Authors
+ * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
+ * Copyright (C) $$Year-Rel$$ The Jalview Authors
  * 
  * This file is part of Jalview.
  * 
 <title>What's new ?</title>
 </head>
 <body>
-       <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>
+  <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>