Help:Jmol in EcoliWiki: Difference between revisions

From EcoliWiki
Jump to navigation Jump to search
Line 40: Line 40:




== Jmol documentation ==
== Jmol scripting ==
Here, we'll just cover a few commonly used commands.  See below for links to more extensive documentation and tutorials.
<protect><!--box uid=63ce1649aab8b3180235b0af7618f667.150401.D49e185e8b9d29-->
<!--
******************************************************************************************
*
*  ** PLEASE DON'T EDIT THIS TABLE DIRECTLY.  Use the edit table link under the table. **
*
****************************************************************************************** -->
{|class = 'sortable' border="2" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0; border: 1px #aaa solid; border-collapse: collapse;" 
|-
!|Command!!Notes!!Examples


|-class='sortbottom'
|[{{SERVER}}{{SCRIPTPATH}}?title=Special:TableEdit&id=63ce1649aab8b3180235b0af7618f667.150401.D49e185e8b9d29&page=150401&pagename={{FULLPAGENAMEE}}&type=0&template= edit table] || ||
|}
<!--box uid=63ce1649aab8b3180235b0af7618f667.150401.D49e185e8b9d29--></protect>
== See also ==
* [http://wiki.jmol.org:81/index.php/Scripting Scripting] on the Jmol wiki.
* [http://jmol.sourceforge.net/jscolors/ Colors]
* [http://chemapps.stolaf.edu/jmol/docs/?ver=11.8 scripting commands]


== References ==
== References ==
{{RefHelp}}
{{RefHelp}}
<references/>
<references/>

Revision as of 06:10, 12 April 2009

Jmol is a Java-based molecular visualization tool. Extensive documentation can be found on the Jmol website. This page describes how you can embed images and set scenes inside EcoliWiki using Jmol's MediaWiki extension.

Working with Jmol in EcoliWiki is a bit of an advanced topic, so it may be useful to familiarize yourself with Mediawiki markup conventions. See Category:Help

Embedding Jmol by transclusion

See Help:Jmol in EcoliWiki

Lex A C-terminal domain, residues 68-202 PDB:1JHE
<jmol>

 <jmolApplet>

<color>white</color>

   <uploadedFileContents >1JHE.pdb</uploadedFileContents>

<script> wireframe off; spacefill off; trace off; rotate ON; select *:A; spacefill on; color cyan; select *:B; cartoon on; color monomer; select *:3; color cyan; </script> </jmolApplet> </jmol>
<jmol> <jmolCheckbox > <scriptWhenChecked > rotate on; </scriptWhenChecked > <scriptWhenUnchecked > rotate off; </scriptWhenUnchecked > <checked>true</checked> <text>rotate</text> </jmolCheckbox > <jmolButton><script>reset; select all; wireframe off; spacefill off; trace off; rotate ON; select *:A; spacefill on; color cyan; select *:B; cartoon on; color monomer; select *:3; color cyan; </script><text>reset</text></jmolButton> </jmol>

The markup for Jmol can be verbose, and putting Jmol scripts directly in pages can make them hard to edit. So we suggest making a page for your Jmol viewer and including it in the desired page by transclusion. A convenient way to do this is to use the Image page created by uploading a .pdb coordinate file. For example, the page at Image:1JHE.pdb was created when the JHE.pdb file was uploaded to the wiki. The page was then edited to add the Jmol viewer. To put it in this page, we used {{Image:1JHE.pdb}}, where the curly brackets tell Mediawiki to copy the content of the Image page. Similar approaches can be used to transclude an image from any other page in the wiki, in case you want different default behavior.

Making the viewer

You can build a viewer from scratch, or you can start by using {{subst:Jmol_template}} and saving to incorporate a template viewer. You'll still have to edit it, but this will put the viewer in a box that allows text to wrap around it on the right, add the Help link, set the background to white, and so on.

The viewer block

The viewer settings reside inside flanking jmol and jmolApplet tags. For example:

 <jmol>
  <jmolApplet>
   <color>white</color>
   <uploadedFileContents >1JHE.pdb</uploadedFileContents>
   <script>
        wireframe off; trace off;
       rotate on;
       spacefill on;
       color chain;
  </script>
  </jmolApplet>
 </jmol>

The script tags are used in several contexts in the Jmol extension. Here, they tell the applet the default script to run when the applet loads.

Setting the pdb file

Put the name of the pdb file between

<uploadedFileContents >pdb file name</uploadedFileContents>

Note that this is just the filename, without Image: or Media; prefixes. Alternatively, you can create a wiki page with the the coordinates and use

<wikiPageContents>page of the wiki containing the molecular data</wikiPageContents>

or use

<inlineContents>contents of the molecular file</inlineContents>

to put the coordinates right in the viewer.

Making external links to control the viewer

As with the viewers, we suggest making link scripts on a separate wiki page and including them by transclusion. For example, we made a subpage of the LexA products page lexA:Gene_Product(s)/catalytic_triad which is incorporated using {{:lexA:Gene_Product(s)/catalytic_triad}} to make this link: lexA:Gene Product(s)/catalytic triad.

Examples

Jmol scripting

Here, we'll just cover a few commonly used commands. See below for links to more extensive documentation and tutorials.

Command Notes Examples
edit table


See also

References

See Help:References for how to manage references in EcoliWiki.