JAL-2675 what’s new for 2.10.2b1
[jalview.git] / help / html / whatsNew.html
index d66c14c..297233d 100755 (executable)
-<html>\r
-<head><title>What's new ?</title></head>\r
-<body>\r
-<p><strong>What's new ?</strong> </p>\r
-<p>If you are reading this then you will already have seen some of the recent changes\r
-  made to Jalview.<br>\r
-  Jalview takes advantage of some of the more recent user interface developments\r
-  in the Java programming language. For instance Jalview is now a multi windowed\r
-  application, this keeps all your Jalview windows neatly together in one main\r
-  application window. </p>\r
-<p>If you were familiar with the original Jalview, here is a list of important\r
-  features you should know about the current development:</p>\r
-<ul>\r
-  <li>Editing sequences is no longer the default when mouse clicking the alignment.\r
-    Instead, mouse clicking on the alignment creates a &quot;selection region&quot;\r
-    which may be full sequences or groups of residues.</li>\r
-  <li>To insert or edit the gaps in one sequence in alignment, the &quot;Shift&quot;\r
-    key must be held down when dragging the mouse.</li>\r
-  <li>To insert or edit gaps for a group of sequences, the &quot;Alt&quot; key\r
-    (or in X windows the &quot;Control&quot; key) must be held down.</li>\r
-  <li>Selecting colour schemes in the colour menu either sets just the &quot;background&quot;\r
-    colourscheme for the alignment, or - when the tickbox &quot;Apply colour to\r
-    all groups&quot; is ticked, applies the scheme to the background and all groups\r
-    defined on the alignment.</li>\r
-  <li>Use the right mouse button (apple and click on the Mac) whilst the pointer\r
-    is within the selection area to access the &quot;define&quot; region menu\r
-    to define a new region, give it a name, and change its colourscheme and display\r
-    properties.</li>\r
-  <li>Conservation is automatically updated whenever the alignment is edited</li>\r
-  <li>There is no &quot;quick draw&quot; option</li>\r
-  <li>Edits can be undone, and redone!</li>\r
-</ul>\r
-<table border="1">\r
-  <tr>\r
-    <td><div align="center"><em><strong>Release</strong></em></div></td>\r
-    <td><div align="center"><em><strong>New Features</strong></em></div></td>\r
-    <td><div align="center"><em><strong>Issues Resolved</strong></em></div></td>\r
-  </tr>\r
-  <tr>\r
-    <td><div align="center"><strong>2.06</strong><br>\r
-        28/9/05</div></td>\r
-    <td><ul>\r
-        <li>View annotations in wrapped mode</li>\r
-        <li>More options for PCA viewer</li>\r
-      </ul></td>\r
-    <td><ul>\r
-        <li>GUI bugs resolved</li>\r
-        <li>Runs with -nodisplay from command line</li>\r
-      </ul></td>\r
-  </tr>\r
-  <tr>\r
-    <td><div align="center"><strong>2.05b</strong><br>\r
-        15/9/05</div></td>\r
-    <td><ul>\r
-        <li>Choose EPS export as lineart or text</li>\r
-        <li>Jar files are executable</li>\r
-        <li>Can read in Uracil - maps to unknown residue</li>\r
-      </ul></td>\r
-    <td><ul>\r
-        <li>Known OutOfMemory errors give warning message</li>\r
-        <li>Overview window calculated more efficiently</li>\r
-        <li>Several GUI bugs resolved</li>\r
-      </ul></td>\r
-  </tr>\r
-  <tr>\r
-    <td><div align="center"><strong>2.05</strong><br>\r
-        30/8/05</div></td>\r
-    <td><ul>\r
-        <li>Edit and annotate in &quot;Wrapped&quot; view</li>\r
-      </ul></td>\r
-    <td><ul>\r
-        <li>Several GUI bugs resolved</li>\r
-      </ul></td>\r
-  </tr>\r
-  <tr>\r
-    <td><div align="center"><strong>2.04</strong><br>\r
-        24/8/05</div></td>\r
-    <td><ul>\r
-        <li>Hold down mouse wheel &amp; scroll to change font size</li>\r
-      </ul></td>\r
-    <td><ul>\r
-        <li>Improved JPred client reliability</li>\r
-        <li>Improved loading of Jalview files</li>\r
-      </ul></td>\r
-  </tr>\r
-  <tr>\r
-    <td> <div align="center"><strong>2.03</strong><br>\r
-        18/8/05</div></td>\r
-    <td><ul>\r
-        <li>Set Proxy server name and port in preferences</li>\r
-        <li>Multiple URL links from sequence ids</li>\r
-        <li>User Defined Colours can have a scheme name and added to Colour Menu</li>\r
-        <li>Choose to ignore gaps in consensus calculation</li>\r
-        <li>Unix users can set default web browser</li>\r
-        <li>Runs without GUI for batch processing</li>\r
-        <li>Dynamically generated Web Service Menus</li>\r
-      </ul></td>\r
-    <td><ul>\r
-        <li>InstallAnywhere download for Sparc Solaris</li>\r
-      </ul></td>\r
-  </tr>\r
-  <tr>\r
-    <td> <div align="center"><strong>2.02</strong><br>\r
-        18/7/05</div></td>\r
-    <td>&nbsp;</td>\r
-    <td><ul>\r
-        <li>Copy &amp; Paste order of sequences maintains alignment order.</li>\r
-      </ul></td>\r
-  </tr>\r
-  <tr>\r
-    <td><div align="center"><strong>2.01</strong><br>\r
-        12/7/05</div></td>\r
-    <td><ul>\r
-        <li>Use delete key for deleting selection.</li>\r
-        <li>Use Mouse wheel to scroll sequences.</li>\r
-        <li>Help file updated to describe how to add alignment annotations.</li>\r
-        <li>Version and build date written to build properties file.</li>\r
-        <li>InstallAnywhere installation will check for updates at launch of Jalview.</li>\r
-      </ul></td>\r
-    <td><ul>\r
-        <li>Delete gaps bug fixed.</li>\r
-        <li>FileChooser sorts columns.</li>\r
-        <li>Can remove groups one by one.</li>\r
-        <li>Filechooser icons installed.</li>\r
-        <li>Finder ignores return character when searching. Return key will initiate\r
-          a search.<br>\r
-        </li>\r
-      </ul></td>\r
-  </tr>\r
-  <tr>\r
-    <td> <div align="center"><strong>2.0</strong><br>\r
-        20/6/05</div></td>\r
-    <td ><ul>\r
-        <li> New codebase</li>\r
-      </ul></td>\r
-    <td >&nbsp;</td>\r
-  </tr>\r
-</table>\r
-<p>&nbsp;</p>\r
-</body>\r
-</html>\r
+<html>
+<!--
+ * 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.
+ *  
+ * 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/>.
+ * The Jalview Authors are detailed in the 'AUTHORS' file.
+ -->
+<head>
+<title>What's new ?</title>
+</head>
+<body>
+  <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>