JAL-2675 what’s new for 2.10.2b1
[jalview.git] / help / html / whatsNew.html
index 35af554..297233d 100755 (executable)
@@ -1,7 +1,7 @@
 <html>
 <!--
- * Jalview - A Sequence Alignment Editor and Viewer (Version 2.9)
- * Copyright (C) 2015 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.
  * 
 </head>
 <body>
   <p>
-    <strong>What's new ?</strong>
+    <strong>Jalview 2.10.2b1 bugfix release</strong>
   </p>
   <p>
-    Jalview 2.9.0b1 is a bug fix release for Jalview 2.9, which has been in development since December 2014. In addition
-    to a multitude of bug fixes and minor improvements (both small, and
-    rather big!), it also brings major new capabilities for codon-level
-    analysis of protein alignments and the retrieval and manipulation of
-    structural data.</p><p>For the patches since version 2.9 was release, see the
-    <a href="releases.html#Jalview.2.9.0b1">Jalview 2.9.0b1 Release Notes</a>.
+    This is patch release for 2.10.2. See the <a
+      href="releases.html#Jalview.2.10.2b1">release notes</a> for full
+    details bugs addressed in this version, which also introduces
+    additional improvements to the overview panel, and patches for
+    several minor issues including the ability to correctly recover
+    cross-references for Uniprot protein sequences from Ensembl.
   </p>
   <p>
-    <strong>Highlights in Jalview 2.9</strong>
+    <strong>What's new in Jalview 2.10.2 ?</strong>
+  </p>
+  <p>
+    Version 2.10.2 was released in August 2017, and introduced 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><strong>Visualisation, editing and analysis of
-        cDNA and Protein alignments</strong><br />A new <a
-      href="features/splitView.html">Split View</a> window allows linked
-      protein and nucleotide sequence alignments to be viewed, edited,
-      and analysed as one. <br />cDNA alignments can also be
-      reconstructed from protein alignments calculated by Jalview's web
-      services, and update in response to edits in the amino acid view.<br />To
-      start experimenting with cDNA/Protein analysis, jut drop a file
-      containing cDNA sequences which code for proteins in an existing
-      alignment, and Jalview will do the rest.</li>
-    <li><strong>Enhanced Integration of UCSF Chimera</strong> <br>Jalview
-      2.9 provides full support for the use of Chimera to view 3D
-      structures linked to alignment views in the Jalview Desktop. We've
-      also included support for saving Chimera sessions in Jalview
-      project files.<br />Jalview and Chimera communicate using local
-      web server connections, which may cause firewall alerts on some
-      systems, but has the advantage of allowing bidirectional
-      communication. Communication between Jalview and Chimera is now
-      much more responsive, and selected regions in Chimera are now
-      shown as highlighted regions in the Jalview desktop.</li>
-    <li><strong>Interactive querying of the PDBe</strong><br />Jalview
-      users can now <a href="features/pdbsequencefetcher.html">browse</a> and <a href="features/viewingpdbs.html">retrieve 3D structure</a> data from the PDB
-      via the <a href="http://www.ebi.ac.uk/pdbe/api/doc/search.html">PDBe
-        Search API</a> (<a href="http://dx.doi.org/10.1093%2Fnar%2Fgkt1180">Gutmanas
-        et al 2014</a>). Developed in collaboration with the PDBe group at
-      EMBL-EBI, the interface allows both structured and free-text
-      queries to be performed, and allows automatic selection of the
-      most relevant structures for an alignment acording to a variety of
-      criteria.</li>
-    <li><strong>Improved support for RNA visualisation</strong><br />Jalview
-      2.9 integrates the latest version of the <a
-      href="features/varna.html">VARNA RNA Viewer</a>, and VARNA views
-      can also now be stored in Jalview projects. We've also dealt with
-      a number of lingering bugs in the VARNA/Jalview interface,
-      including the loss of pseudoknots when RNA secondary structure is
-      shown VARNA.</li>
-    <li><strong>Protein Secondary Structure predictions
-        with JPred4</strong><br />Jalview includes a number of new features for
-      working with secondary structure predictions from the JPred4
-      server. These include new <a href="menus/popupMenu.html#hideinserts">popup menu actions</a> to automatically hide insertions and highlight
-      mutations in an alignment with respect to a <a href="calculations/referenceseq.html">Reference
-        Sequence</a>. Jalview 2.9's new <a href="io/export.html#htmlexport">scrollable
-        SVG HTML export</a> was also developed specifically for the JPred4
-      server.</li>
+    <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>