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