examples/appletParameters.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   2 <!--
   3  * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
   4  * Copyright (C) $$Year-Rel$$ 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>Applet Parameters</TITLE>
  22   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
  23
  24   <link href="css/reset.css" rel="stylesheet" type="text/css" />
  25   <link href="css/style.css" rel="stylesheet" type="text/css" />
  26
  27   <!--[if IE 6]>
  28       <link rel="stylesheet" type="text/css" href="css/ie6.css" />
  29       <![endif]-->
  30
  31   <!--[if IE 7]>
  32       <link rel="stylesheet" type="text/css" href="css/ie7.css" />
  33       <![endif]-->
  34
  35   <!-- dd menu -->
  36   <script type="text/javascript">
  37     <!--
  38         var timeout         = 500;
  39         var closetimer  = 0;
  40         var ddmenuitem      = 0;
  41
  42         // open hidden layer
  43         function mopen(id)
  44         {
  45         // cancel close timer
  46         mcancelclosetime();
  47
  48         // close old layer
  49         if(ddmenuitem) ddmenuitem.style.visibility = 'hidden';
  50
  51         // get new layer and show it
  52         ddmenuitem = document.getElementById(id);
  53         ddmenuitem.style.visibility = 'visible';
  54
  55         }
  56         // close showed layer
  57         function mclose()
  58         {
  59         if(ddmenuitem) ddmenuitem.style.visibility = 'hidden';
  60         }
  61
  62         // go close timer
  63         function mclosetime()
  64         {
  65         closetimer = window.setTimeout(mclose, timeout);
  66         }
  67
  68         // cancel close timer
  69         function mcancelclosetime()
  70         {
  71         if(closetimer)
  72         {
  73         window.clearTimeout(closetimer);
  74         closetimer = null;
  75         }
  76         }
  77
  78         // close layer when click-out
  79         document.onclick = mclose;
  80         // -->
  81   </script>
  82   <script>
  83     <!--//--><![CDATA[//><!--
  84 var _gaq = _gaq || [];_gaq.push(["_setAccount", "UA-9060947-1"]);_gaq.push(["_trackPageview"]);(function() {var ga = document.createElement("script");ga.type = "text/javascript";ga.async = true;ga.src = ("https:" == document.location.protocol ? "https://ssl" : "http://www") + ".google-analytics.com/ga.js";var s = document.getElementsByTagName("script")[0];s.parentNode.insertBefore(ga, s);})();
  85 //--><!]]>
  86   </script>
  87
  88 </head>
  89
  90
  91 <body>
  92
  93
  94   <div id="header">
  95     <div id="logo"><a href="http://www.jalview.org" title="Home"></a></div>
  96     <ul id="buttons">
  97       <li id="applet"><a href="applets.html" title="applet"></a></li>
  98       <li id="desktop"><a href="../webstart/jalview.jnlp" title="desktop"></a></li>
  99     </ul>
 100   </div>
 101
 102
 103   <div id ="nav">
 104     <div id="navInner">
 105
 106       <ul id="sddm">
 107         <li><a href="http://www.jalview.org">Home</a></li>
 108         <li><a href="http://www.jalview.org/about" onmouseover="mopen('m1')" onmouseout="mclosetime()">About</a>
 109           <div id="m1" onmouseover="mcancelclosetime()" onmouseout="mclosetime()">
 110             <a href="http://www.jalview.org/about/documentation">Documentation</a>
 111             <a href="http://www.jalview.org/about/citation">Publications</a>
 112             <a href="http://www.jalview.org/about/credits">Credits</a>
 113           </div>
 114         </li>
 115         <li><a href="http://www.jalview.org/faq">FAQ</a></li>
 116         <li><a href="http://www.jalview.org/community" onmouseover="mopen('m3')" onmouseout="mclosetime()" class="community">Community</a>
 117           <div id="m3" onmouseover="mcancelclosetime()" onmouseout="mclosetime()">
 118             <a href="http://www.jalview.org/mailman/listinfo/jalview-announce">News Mailing List</a>
 119             <a href="http://www.jalview.org/mailman/listinfo/jalview-discuss">Discussion Mailing List</a>
 120             <a href="http://www.jalview.org/community/links">Links</a>
 121             <a href="http://www.jalview.org/community/community-news">Community News</a>
 122           </div>
 123         </li>
 124         <li><a href="http://www.jalview.org/development" onmouseover="mopen('m4')" onmouseout="mclosetime()" class="development">Development</a>
 125           <div id="m4" onmouseover="mcancelclosetime()" onmouseout="mclosetime()">
 126             <a href="http://www.jalview.org/development/release-history">Release History</a>
 127             <a href="http://issues.jalview.org">Jalview Bug Tracker</a>
 128             <a href="http://source.jalview.org/gitweb/">Jalview Git Web</a>
 129             <a href="http://www.jalview.org/development/development-news">Development News</a>
 130           </div>
 131         </li>
 132         <li><a href="http://www.jalview.org/training" onmouseover="mopen('m5')" onmouseout="mclosetime()" class="training">Training</a>
 133           <div id="m5" onmouseover="mcancelclosetime()" onmouseout="mclosetime()">
 134             <a href="http://www.jalview.org/training/training-courses">Training Courses</a>
 135             <a href="http://www.jalview.org/training/training-news">Training News</a>
 136           </div>
 137         </li>
 138         <li><a href="http://www.jalview.org/download" class="download-right">Download</a></li>
 139       </ul>
 140       <div style="clear:both"></div>
 141     </div>
 142
 143   </div>
 144 <div id="pageWrap">
 145
 146 <div id="sideNav">
 147   <ul>
 148       <li ><a href="applets.html">JalviewLite Examples</a></li>
 149       <li ><a href="jalviewLiteJs.html">Javascript API</a></li>
 150       <li class="jvlite-nav-small"><a href="appletParameters.html">Applet Parameters</a></li>
 151       <li ><a href="embedded.html">Embedded Alignment</a></li>
 152       <li ><a href="embeddedWJmol.html">Jalview and Jmol</a></li>
 153       <li ><a href="formComplete.html">Access from Javascript</a></li>
 154       <li ><a href="javascriptLaunch.html">Javascript Launch</a></li>
 155       <li ><a href="linkedapplets_ng.html">Linked JalviewLites</a></li>
 156   </ul>
 157 </div>
 158
 159 <div id="content" class="content">
 160
 161
 162 <!-- content start -->
 163 <h2>JalviewLite Applet Parameter Documentation</h2>
 164 <p>
 165 The JalviewLite applet is configured through a series of applet parameters,
 166 which are described <a href="#parameters"> below</a>. Once initialised,
 167 the applet can be interacted with <em>via</em> its
 168 <a href="jalviewLiteJs.html">Javascript API</a>.
 169 </p><p><strong>Issues arising from tightening of Java Security default settings</strong><br/>JalviewLite is provided as a signed applet with 'sandbox' permissions and wildcards that allow it to be run from any website. Unfortunately, earlier versions of Java are not compatible with these settings, so if you find that you cannot see any of the examples on the left, try the <a href="u_applets.html">unsigned applet examples</a>.
 170 </p>
 171     <p>For additional deployment notes, <a href="#appletdeploymentnotes">see below</a>.</p>
 172             <p><h2>Applet Parameters</h2><br/>The applet takes the following initialisation parameters.</p>
 173         <a name="parameters"></a>        <table width="97%" class="borderTable" align="center" >
 174           <tr>
 175             <td width="103" height="23"><strong>&lt;param name=&quot;&quot;</strong></td>
 176             <td width="80" ><strong>value=&quot;&quot;&gt;</strong></td>
 177             <td width="100%"><strong>Description</strong></td>
 178           </tr>
 179           <tr>
 180           <td>permissions</td>
 181           <td>sandbox</td>
 182           <td><strong>This parameter is necessary, and must have the value <em>sandbox</em> to allow the JalviewLite applet to run.</strong></td>
 183           </tr>
 184           <tr>
 185             <td>file</td>
 186             <td>fileName</td>
 187             <td>The file to open, must be on same server as the applet.</td>
 188           </tr>
 189           <tr>
 190             <td>file2</td>
 191             <td>fileName</td>
 192             <td>A second file to open. If one file is nucleotide and the other peptide, and at least one peptide sequence
 193             is the translation of one of the nucleotide sequences, then alignments will be displayed linked in a split frame (<em>since 2.8.3</em>).</td>
 194           </tr>
 195           <tr>
 196             <td>sequence1,<br>
 197               sequence2,<br>
 198               sequence3</td>
 199             <td>sequence in (preferably) PFAM or Fasta format</td>
 200             <td>The alignment can be added as a series of sequences instead of
 201               from a file.</td>
 202           </tr>
 203           <tr>
 204             <td>tree</td>
 205             <td>fileName</td>
 206             <td>Tree file in Newick format</td>
 207           </tr>
 208           <tr>
 209             <td>features</td>
 210             <td>fileName</td>
 211             <td>Jalview Features file to be applied to the alignment</td>
 212           </tr>
 213           <tr>
 214             <td>annotations</td>
 215             <td>fileName</td>
 216             <td>Jalview Annotation file will be added to the alignment</td>
 217           </tr>
 218           <tr>
 219             <td>jnetfile</td>
 220             <td>fileName</td>
 221             <td>Secondary structure predictions from a <a
 222             href="http://www.compbio.dundee.ac.uk/~www-jpred/">Jnet</a> Concise
 223               file will be added to the first sequence in the alignment.</td>
 224           </tr>
 225           <tr>
 226             <td>PDBfile(x)</td>
 227             <td><p>fileName seq1 seq2 seq3</p>
 228               <p>or</p>
 229               <p>fileName A=seq1 B=seq2 C=seq3</p></td>
 230             <td>PDB file which is to be associated with a sequence, followed by
 231               space separated list of alignment sequence ids. PDB chains can be
 232               specifed to map to particular sequence by using A=SeqA notation</td>
 233           </tr>
 234           <tr>
 235             <td><p>PDBSeq<br>
 236                 *Not needed post Jalview 2.3, use PDBFile instead</p></td>
 237             <td>SequenceId</td>
 238             <td>The sequence to associate a PDB file with. Note the value is case
 239               sensitive.</td>
 240           </tr>
 241           <tr>
 242             <td>defaultColour</td>
 243             <td> <em>One of: </em><br>
 244               Clustal, Blosum62, % Identity, Hydrophobic, Zappo, Taylor, Helix
 245               Propensity, Strand Propensity, Turn Propensity, Buried Index, Nucleotide, T-Coffee Scores, RNA Helices</td>
 246             <td>Default is no colour.</td>
 247           </tr>
 248           <tr>
 249             <td>userDefinedColour</td>
 250             <td><p><em>Example:</em><br>
 251                 D,E=red; K,R,H=0022FF; c=yellow</p></td>
 252             <td>Define residue colours</td>
 253           </tr>
 254           <tr>
 255             <td height="35">showFullId</td>
 256             <td>true <em>or</em> false</td>
 257             <td>if true displays start and end residue at the end of sequence
 258               Id.</td>
 259           </tr>
 260           <tr>
 261             <td>showAnnotation</td>
 262             <td>true <em>or</em> false</td>
 263             <td>If true shows the annotation panel below the alignment.</td>
 264           </tr>
 265           <tr>
 266             <td>showConservation</td>
 267             <td>true <em>or</em> false</td>
 268             <td>Default is true.</td>
 269           </tr>
 270           <tr>
 271             <td>showQuality</td>
 272             <td>true <em>or</em> false</td>
 273             <td>Default is true.</td>
 274           </tr>
 275           <tr>
 276             <td>showConsensus</td>
 277             <td>true <em>or</em> false</td>
 278             <td>Default is true.</td>
 279           </tr>
 280           <tr>
 281             <td>sortBy</td>
 282             <td> Id <em>, </em> Pairwise Identity<em>, or</em> Length</td>
 283             <td> Sorts the alignment on startup</td>
 284           </tr>
 285           <tr>
 286             <td>RGB</td>
 287             <td>colour as hex string</td>
 288             <td>Background colour for applet button - purely cosmetic to blend
 289               in with your web page. For orange, enter the value FF6600</td>
 290           </tr>
 291           <tr>
 292             <td>embedded</td>
 293             <td>true <em>or</em> false</td>
 294             <td>The applet is embedded in the web page, the &quot;Start Jalview&quot;
 295               button is not displayed.</td>
 296           </tr>
 297           <tr>
 298             <td>windowWidth</td>
 299             <td>value</td>
 300             <td>frame width</td>
 301           </tr>
 302           <tr>
 303             <td>windowHeight</td>
 304             <td>value</td>
 305             <td>frame height</td>
 306           </tr>
 307           <tr>
 308             <td>label</td>
 309             <td>label text</td>
 310             <td>Change text for the Launch Jalview Button</td>
 311           </tr>
 312           <tr>
 313             <td>wrap</td>
 314             <td>true <em>or</em> false</td>
 315             <td>Opens new windows in wrapped mode</td>
 316           </tr>
 317           <tr>
 318             <td>linkLabel_1</td>
 319             <td>EMBL-EBI Search</td>
 320             <td rowspan="2"><p>Right click on sequence id to see list of available
 321                 links. Any new links MUST have $SEQUENCE_ID$ as part of the linkURL_n
 322                 value. For multiple links, increment the label and url name by
 323                 1. ie <br>
 324                 &lt;param name=&quot;linkLabel_2&quot; ..., <br>
 325                 &lt;param name=&quot;linkUrl_2&quot;....<br>
 326               </p>
 327               <p>Regular expressions may also be used (<em>since Jalview 2.4</em>) to process the ID string inserted into the URL:
 328               <br>$SEQUENCE_ID=/&lt;regex to extract ID&gt;/=$<br><em>Use the debug flag to check parsing and make sure that special symbols are properly escaped (particularly when generating applet tags from CGI scripts).
 329               <br>Regex URL links are also applied to the description line (since Jalview 2.4.+).</em></p></td>
 330           </tr>
 331           <tr>
 332             <td> <p>
 333             <br>
 334                 linkUrl_1<br>
 335               </p></td>
 336             <td><p><br>
 337                 http://www.ebi.ac.uk/ebisearch/<br/>search.ebi?db=allebi&query=$SEQUENCE_ID$</p>
 338                                                 </td>
 339           </tr>
 340           <tr>
 341             <td>showFeatureSettings</td>
 342             <td>true <em>or</em> false</td>
 343             <td>Shows the feature settings window when starting the applet</td>
 344           </tr>
 345           <tr>
 346             <td>showfeaturegroups</td>
 347             <td><em>separator</em> separated list of feature groups</td>
 348             <td>Display the features in the given groups on the alignment</td>
 349           </tr>
 350           <tr>
 351             <td>hidefeaturegroups</td>
 352             <td><em>separator</em> separated list of feature groups</td>
 353             <td>Hide the features in the given groups on the alignment
 354             (will be overridden by showfeaturegroups for group names
 355             found in both lists)</td>
 356           </tr>
 357           <tr>
 358             <td>application_url</td>
 359             <td><p><em>URL of dynamic JNLP servlet,</em></p>
 360               <p>http://www.jalview.org/services/launchApp</p></td>
 361             <td>Launches full application with original alignment, features and
 362               annotations files used in applet</td>
 363           </tr>
 364           <tr>
 365           <td>separator</td>
 366           <td><em>non-empty separator string</em><br>default: |</td>
 367           <td>string used to separate fields in list parameters (such as <em>showfeaturegroups</em>)</td>
 368           </tr>
 369           <tr><td>debug</td>
 370           <td>true</td>
 371           <td>Instruct the applet to output additional debug messages to the java console</td>
 372           </tr>
 373           <tr><td>nojmol</td>
 374           <td>false</td>
 375           <td>When set, do not try to find Jmol classes. Set this to supress URL not found errors appearing
 376           in server logs when Jmol is not available.
 377           </td>
 378           </tr>
 379           <tr><td>showbutton</td>
 380           <td>true</td>
 381           <td>Show the jalview button on the page. When false, JalviewLite will open immediately.</td>
 382           </tr>
 383           </tr>
 384                   <tr><td>sortByTree</td>
 385                   <td>true or false (default is false)</td>
 386                   <td>automatically sort the associated alignment view by the tree when a new tree is opened.</td>
 387                   </tr>
 388                   <tr>
 389                    <td>showTreeBootstraps</td><td>true or false (default is true)</td><td>show or hide branch bootstraps</td>
 390                         </tr>
 391         <tr><td>showTreeDistances</td><td>true or false (default is true)</td><td>show or hide branch lengths</td></tr>
 392         <tr><td>showUnlinkedTreeNodes</td><td>true or false (default is false)</td><td>indicate if unassociated nodes should be highlighted in the tree view</td>
 393         </tr>
 394           <tr><td>heightScale</td>
 395           <td>1.0 or greater</td>
 396           <td>Adjust the height of each cell in the alignment grid relative to the height of a character in the alignment font. (<em>since 2.5.1</em>)</td>
 397           </tr>
 398           <tr><td>widthScale</td>
 399           <td>1.0 or greater</td>
 400           <td>Adjust the width of each cell in the alignment grid relative to the width of a character in the alignment font. (<em>since 2.5.1</em>)</td>
 401           </tr>
 402           <tr><td>scaleProteinAsCdna</td><td>true or false (default is false)</td>
 403           <td>Set true to shown protein residues the same width as their encoding codons.
 404           For use with parameter file2 when showing a split frame of cDNA and protein. (<em>since 2.8.3</em>)</td></tr>
 405           <tr><td>centrecolumnlabels</td>
 406           <td>true or false (default is false)</td>
 407           <td>When true, text labels associated with a column in the alignment will be shown centered with respect to the column. (<em>since 2.4</em>)</td>
 408           <tr><td>showUnconserved</td>
 409           <td>true or false (default is false)</td>
 410           <td>When true, only gaps and symbols different to the consensus sequence for a column will be shown. Useful for visualizing alignments exhibiting low sequence variation, where it is important to highlight mutations. (<em>since 2.5</em>)</td>
 411           </tr>
 412           <tr><td>upperCase</td>
 413           <td><em>bold</em> or other value</td>
 414           <td>Indicate a text style to apply to uppercase sequence symbols. Currently, only <strong>bold</strong> is supported.</td>
 415           </tr>
 416           <tr><td>automaticScrolling</td>
 417           <td>true or false (default is true)</td>
 418           <td>When true, alignment panels will automatically scroll to show any regions of the alignment highlighted due to javascript events or when mousing over a position in an associated structure. (<em>since 2.6</em>)</td>
 419           </tr>
 420
 421           <tr><td>showGroupConsensus</td>
 422           <td>true or false (default is false)</td>
 423           <td>When true, shows consensus annotation row for any groups on the alignment. (<em>since 2.7</em>)</td>
 424           </tr>
 425
 426           <tr><td>showGroupConservation</td>
 427           <td>true or false (default is false)</td>
 428           <td>When true, shows amino-acid property conservation annotation row for any groups on the alignment. (<em>since 2.7</em>)</td>
 429           </tr>
 430           <tr><td>showConsensusHistogram</td>
 431           <td>true or false (default is true)</td>
 432           <td>When true, shows the percentage occurence of the consensus symbol for each column as a histogram above the consensus sequence row. (<em>since 2.7</em>)</td>
 433           </tr>
 434           <tr><td>showSequenceLogo</td>
 435           <td>true or false (default is false)</td>
 436           <td>When true, shows a sequence logo above the consensus sequence (overlaid above the Consensus Histogram, if visible, with symbols coloured using the alignment's default colourscheme). (<em>since 2.7</em>)</td>
 437           </tr>
 438           <tr><td>normaliseSequenceLogo</td>
 439           <td>true or false (default is false)</td>
 440           <td>When true, all sequence logos will be normalised (all symbol stacks add up to full height of annotation row), rather than being scaled according to the fraction of symbols identical to the consensus. (<em>since 2.8</em>)</td>
 441           </tr>
 442           <tr><td>oninit</td>
 443           <td><em>after_init()</em></td>
 444           <td>name of javascript function that will be called after the jalviewLite instance has completed its initialisation. (<em>since 2.7</em>)</td>
 445           </tr>
 446           <tr><td>relaxedidmatch</td>
 447           <td><em>true or false (default is false)</em></td>
 448           <td>When true, use stem based matching to identify sequences that match features imported from a GFF or Jalview sequence features file, and for associating PDB data (passed on PDBfile parguments) with sequences (based on a given destination sequence ID). (<em>since 2.7</em>)</td>
 449           </tr>
 450           <tr><td>alignpdbfiles</td>
 451           <td><em>true or false (default is false)</em></td>
 452           <td>When true, and jalviewLite is able to use jmol as a structure viewer, attempt to show a superposition of all structures loaded onto the alignment, superimposed using the aligned regions of corresponding sequences. [experimental] (<em>since 2.7</em>)</td>
 453           </tr>
 454           <tr><td>externalstructureviewer</td>
 455           <td><em>true or false (default is false)</em></td>
 456           <td>re-route jmol colouring commands, selection and mouseover events to an external viewer using javascript callbacks. [experimental] (<em>since 2.7</em>)</td>
 457
 458           </tr>
 459           <tr><td>annotationcolour_max</td>
 460           <td>colour name or RGB hex triplet (default is red)</td>
 461           <td>Default colour used for maximum value when shading by annotation. (<em>since 2.7</em>)</td>
 462           </tr>
 463           <tr><td>annotationcolour_min</td>
 464           <td>colour name or RGB hex triplet (default is orange)</td>
 465           <td>Default colour used for minimum value when shading by annotation. (<em>since 2.7</em>)</td>
 466           </tr>
 467           <tr><td>jalviewhelpurl</td>
 468           <td>absolute or relative url or javascript function prefixed by <em>javascript:</em> (default is http://www.jalview.org/help.html)</td>
 469           <td>Optional parameter allowing modification of the default Jalview Help URL normally opened when JalviewLite's 'Help' menu item is selected. (<em>since 2.7</em>)</td>
 470           </tr>
 471           <tr><td>resolvetocodebase</td>
 472           <td>True or False (False)</td>
 473           <td>Set to true to re-instate pre-JalviewLite 2.7 behaviour where relative URLs were prepended with the applet 'codebase' rather than the current document base URL before resolution. (<em>since 2.7</em>)</td>
 474           </tr>
 475           <tr><td>scoreFile</td>
 476           <td>file</td>
 477           <td>Multiple sequences aligment scores file. Currently is supported only the T-Coffee score_ascii file format</td>
 478           </tr>
 479                   </table>
 480                   <p><h2><a name="appletdeploymentnotes"/>Notes on applet deployment</h2><br/>
 481         <ul>
 482           <li>Package all your data files into a single (or multiple) zip / jar
 483             files. This is very useful to reduce download time of large data files.
 484             The applet archive tag can take multiple entries separated by commas,
 485             eg<br>
 486             <pre>&lt;applet code=&quot;jalview.bin.JalviewLite&quot;<em><strong>
 487             archive=&quot;jalviewApplet.jar, mydata.zip&quot;</strong></em>&gt;<br>
 488             </pre></li>
 489           <li> Use Jalview for input to a HTML form. For an example of how to
 490             code this using Javascript, click <a href="formComplete.html">here</a>.
 491             <br>
 492           </li>
 493           <li>Embed Jalview into the web page, without the &quot;Start Jalview&quot;
 494             button by setting the embed parameter to true;<br>
 495             &lt;param name=&quot;embedded&quot;
 496           value=&quot;true&quot;&gt; </li>
 497         </ul>
 498         <p><strong>**NEW FEATURES** in Jalview 2.8</strong></p>
 499         <ul>
 500         <li>Normalised sequence logo display
 501         </li>
 502         <li>RNA secondary structure annotation row
 503         </li>
 504 <li>Jmol compatibility updated to Jmol 12.2.x series - <a href="JmolApplet-12.2.4.jar">download the JmolApplet here</a></li>
 505 <li>To use Jmol as the structure viewer for Jalview, you must include
 506             the jar file in the applet archive argument thus:<br>
 507             <pre>archive=&quot;jalviewApplet.jar,Jmol-12.2.4.jar&quot;</pre>
 508           </li>
 509           <li>Jmol 12.2.x requires at least Java 1.6 to run in the clients web browser. If the client does not have
 510             Java 1.6, or if the Jmol-12.2.jar is not added to the archive, the
 511             original Jalview structure viewer will still be available. <br>
 512           </li>
 513
 514         </ul>
 515         <p><strong>**NEW FEATURES** in Jalview 2.7</strong></p>
 516         <ul>
 517         <li>Javascript callbacks capabilities<ul><li>oninit parameter and methods for registering javascript handlers for selections, mouseovers and linking to Jmol applets on the page.</li>
 518         <li>To use javascript callbacks, ensure the applet tag includes the '<a href="http://download.oracle.com/javase/6/docs/technotes/guides/plugin/developer_guide/java_js.html">mayscript</a>' attribute - either as a parameter (&lt;param name="mayscript" value="true"/;gt;) or as a bare attribute in the applet html tag).</li></ul>
 519         </li>
 520         <li>New <a href="jalviewLiteJs.html">jalviewLite java api</a> methods for selecting, highlighting, scrolling and reordering sequences in an alignment view.
 521         </li></ul>
 522         <p><strong>**NEW FEATURES** in Jalview 2.6</strong></p>
 523         <ul>
 524         <li>Jmol compatibility updated to Jmol 12.1.x series</li>
 525           <li>Jalview 2.6 works only with Jmol version 12.1.13 or later. You can use the JmolApplet.jar from
 526           the Jmol binary distribution available at the Jmol Sourceforge site,
 527           or <a href="JmolApplet-12.1.13.jar">download the Jmol applet from here</a></li>
 528           <li>Minimum recommended version of Java runtime for the applet is now 1.5 (JalviewLite v2.6 without the Jmol viewer may work ok on earlier Java environments but compatibility can no-longer be guaranteed).</li>
 529   </ul>
 530         <br><strong>**NEW FEATURES** in Jalview 2.5</strong></p>
 531         <ul>
 532         <li>New parameters to control display of tree annotation, width of alignment columns, and to disable the jalview button and check for Jmol on startup.</li>
 533   </ul>
 534         <br><strong>**NEW FEATURES** in Jalview 2.4</strong></p>
 535         <ul>
 536         <li>New applet API methods for feature display control, views, and obtaining current selection via javascript.</li>
 537           <li>Group show and hide parameters:
 538         &quot;showfeaturegroups&quot; and
 539         &quot;hidefeaturegroups&quot;. Both take a list
 540         of feature group names (separarated by &quot;|&quot; by default) to hide or show on the displayed
 541         alignment.
 542         </li>
 543         <li>Regular expressions can be used in URL links for sequence IDs.</li>
 544         <li>&quot;debug&quot; parameter to control verbosity of the applet's console output.</li>
 545         <li>&quot;showbutton&quot; parameter to disable launch button and open JalviewLite immediatly.</li>
 546         <li>&quot;nojmol&quot; parameter to disable check for Jmol classes.</li>
 547         </ul><br>
 548         <strong>**NEW FEATURES** in Jalview 2.3</strong></p>
 549         <ul>
 550           <li>Note that Parameter &quot;PDBFile&quot; now takes
 551             the PDB file followed by a space separated list of alignment sequence
 552             ids to associate the structure to. It is also possible to associate
 553             multiple PDB files by adding an incremental value to PDBFile (up to
 554             10). It is also possible to map specific sequences to specific chains
 555             by using the following notation:<br>
 556             <br>
 557             <pre>
 558             &lt;param name=&quot;PDBFile&quot; value=&quot;First.pdb SeqA SeqB
 559             SeqC&quot;&gt;<br>
 560             &lt;param name=&quot;PDBFile2&quot; value=&quot;Second.pdb
 561             A=SeqA B=SeqB C=SeqC&quot;&gt;<br>
 562             &lt;param name=&quot;PDBFile3&quot; value=&quot;Third.pdb
 563             D=SeqX B=SeqY C=SeqZ&quot;&gt;<br>
 564             </pre>
 565           </li>
 566           <li>Note parameter &quot;PDBSeq&quot; is no longer required.<br>
 567           </li>
 568           <li>Jalview 2.3 was updated to work with Jmol 11. See the <a href="/development">versions archive if you want to download the old Jmol applet</a>.</li>
 569             <p>&nbsp;</p>
 570           </li>
 571         </ul>
 572         <strong>**NEW FEATURES** in Jalview 2.1</strong>
 573         <ul>
 574           <li>Jalview Applet can read and display JNet secondary structure annotation
 575             directly via the <strong>jnetfile</strong> parameter. <br>
 576           </li>
 577           <li>Param &quot;UserDefinedColour&quot; - specify your own colours for each residue using a semi colon
 578             separated list. Multiple residues can be assigned the same colour
 579             using commas. eg:<br>
 580             <pre>&lt;param name=&quot;userDefinedColour&quot;
 581             value=&quot;D,E=red; K,R,H=0022FF; C=yellow&quot;&gt;</pre>
 582           </li>
 583           <li>Param &quot;showFeatureSettings&quot;
 584             - this will display the feature settings window when the applet starts.
 585           </li>
 586           <li>Param &quot;Application_URL&quot; value=&quot;http://www.jalview.org/services/launchApp&quot;<br/>
 587             This calls a servlet which creates a JNLP file with the alignment
 588             file, annotations file and features file of the applet as arguments.
 589             If the user has Java installed, the returned JNLP file should start
 590             up the full Jalview Application. BUT this does not currently work
 591             for alignment files added to the applet in a zip file.
 592             <br/>Look at the XML comments in the file downloaded from <a href="http://www.jalview.org/services/launchApp">The LaunchApp page</a> for full documentation.
 593           </li>
 594           <li>Alignment file can be a series of parameters using eg PFAM format
 595             <br>
 596             <pre>&lt;param name=&quot;sequence1&quot;
 597             value=&quot;Q93XJ9_SOLTU/11-26 TSFLPRKPVVTSLKAI&quot;&gt;<br>
 598             &lt;param name=&quot;sequence2&quot; value=&quot;FER1_PEA/14-29 TSFLRTQPMPMSVTTT&quot;&gt;<br>
 599             </pre>(All the usual Jalview File formats are valid, however each
 600             new line in an alignment file must be entered as a parameter)</li>
 601         </ul>
 602
 603
 604 <!-- content end -->
 605
 606
 607 </div> <!-- end content div -->
 608
 609 </div> <!-- content -->
 610 </div> <!-- pagewrap -->
 611 <div id ="footer">
 612 <div id="innerFooter">
 613 <div id="copyright"><p>Published under <a href="http://creativecommons.org/licenses/by-sa/3.0/">CC-SA 3.0</a></p></div>
 614 <div id="cite">
 615 <p>
 616 If you use Jalview in your work, please cite this publication:
 617 </p>
 618 <br />
 619 <p>
 620 Waterhouse, A.M., Procter, J.B., Martin, D.M.A, Clamp, M. and Barton, G. J. (2009)
 621 "Jalview Version 2 - a multiple sequence alignment editor and analysis workbench"
 622 Bioinformatics 25 (9) 1189-1191 <a href="http://dx.doi.org/10.1093/bioinformatics/btp033">doi: 10.1093/bioinformatics/btp033</a>
 623 </p>
 624 </div>
 625 </div>
 626 </div>
 627 </body>
 628 </html>