JAL-1432 updated copyright notices
[jalview.git] / help / html / webServices / shmr.html
1 <html>
2 <!--
3  * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8.0b1)
4  * Copyright (C) 2014 The Jalview Authors
5  * 
6  * This file is part of Jalview.
7  * 
8  * Jalview is free software: you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License 
10  * as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
11  *  
12  * Jalview is distributed in the hope that it will be useful, but 
13  * WITHOUT ANY WARRANTY; without even the implied warranty 
14  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
15  * PURPOSE.  See the GNU General Public License for more details.
16  * 
17  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
18  * The Jalview Authors are detailed in the 'AUTHORS' file.
19 -->
20 <head>
21 <title>Multi-Group Sequence Harmony and Multi-Relief</title>
22 </head>
23 <body>
24         <strong>Functional residue analysis with Sequence Harmony and
25                 Multi-Relief</strong>
26         <p>
27                 The Multi-Harmony (a.k.a. Sequence Harmony and Multi-Relief, or SHMR) service (<a
28                         href="#shmrref">Brandt, Feenstra and Heringa, 2010</a>) available
29                 from the <em>Analysis</em> sub-menu of the alignment window's web
30                 services menu provides a method for the identification of significant
31                 patterns of <em>sub-family variation</em> amongst the columns of an
32                 alignment.
33         </p>
34         <p>
35                 <strong>Instructions for use</strong><br> The service requires a
36                 protein sequence multiple alignment that has been sub-divided into
37                 groups containing at least two non-identical protein sequences. An
38                 easy way to create groups is to use the built-in <a
39                         href="../calculations/tree.html">neighbour-joining or UPGMA tree</a>
40                 routines to calculate a tree for the alignment, and then click on the
41                 tree to subdivide the alignment.
42         </p>
43         <p>
44                 The SHMR service operates on the currently selected visible region(s)
45                 of the alignment. Once submitted, a job progress window will display
46                 status information about your job, including a URL which allows you to
47                 visit the status page on the
48                 <a href="http://zeus.few.vu.nl/programs/shmrwww/">IBIVU SHMR server</a>.
49         </p>
50         <p>When the job is complete, Jalview will automatically open a new
51                 window containing the alignment and groups that were submitted for
52                 analysis, with additional histograms added portraying the SHMR scores
53                 for each column of the sub-grouped alignment.</p>
54         <p>
55                 If you use this service in your work, please cite :<br /><a name="shmrref"/> Brandt,
56                 B.W.*, Feenstra, K.A*. and Heringa, J. (2010) Multi-Harmony: detecting
57                 functional specificity from sequence alignment. <a
58                         href="http://nar.oxfordjournals.org/cgi/content/abstract/gkq415">Nucleic
59                         Acids Res. 38: W35-W40.</a> (<em>* joint first authors</em>)
60         <p>
61         <strong><em>Note:</em></strong> The Multi-Harmony service is implemented with a prototype of Jalview's RESTful
62                 web service client introduced in Jalview 2.7. A few bugs remain in this prototype, which we intend to fixed in version 2.7.1.
63         </ul>
64         </p>
65 </body>
66 </html>