JAL-2675 what’s new for 2.10.2b1
[jalview.git] / help / html / whatsNew.html
index a5d5d4a..297233d 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>Jalview 2.10.2b1 bugfix release</strong>
+  </p>
+  <p>
+    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>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><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>