Help:Jmol in EcoliWiki

From EcoliWiki
Revision as of 16:21, 5 June 2009 by Azweifel (talk | contribs)
Jump to navigation Jump to search

Description

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.

What types of structures to Display

The structures that are most displayed are protein, nucleotide, inorganic and organic molecules, etc.

Selecting a Compatible File

There are several file formats compatible with the jmol viewer, such as .pdb, .mol. Other file formats such as .pse will not work.

Embedding the Image

1. Click on the "Upload File" link toolbox to the left. EcoliWiki allows you to upload pdb files so you may display a picture of the structure on any page you wish. If you encounter a file format that EcoliWiki does not allow, please contact us for help.

2. When you upload your pdb file, put {{subst:Jmol_template}} in the description txt box. The template automatically loads all the details necessary to make this work. If you try to edit the image page from now on, there will be a lot more text than what you wrote (that's suppose to happen).

This will put the viewer in a box on the right that allows text to wrap around it, add the Help link, set the background to white, and so on.

3. To embed this image into your page of interest. To insert an image anywhere in EcoliWiki, place {{Image:1JHE.pdb}}, where the Image: 1JHE is replaced with the title of your image page.


More 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

select [atom-expression]

You need to select things to work on them selectively. Atom expressions include:

  • numbers for residues
  • :chain_id for chains (subunits)
  • backbone
  • sidechains
  • select 1-10; selects residues 1-10 in all chains
  • select *:A; selects all atoms in chain A
  • select 84:A, 156:B; selects two residues, one in chain A and one in chain B.

spacefill (on/off/only) (synonym: cpk)

Shows atoms as VdW sized spheres

wireframe (on/off/only)

shows the bonds between atoms.

cartoon (on/off/only)

shows helices and sheets in cartoon form.

  • zoom (atom-expression) %zoom
  • zoomto (atom-expression) %zoom

centers on atom-expression and zooms there to the specified percentage of the 100% default. The zoom factor can range from 5 to 20,000, where larger numbers are zoomed in.

zoomto (84:A) 500;

color [drawn-object] [RGB-color]

if drawn-object is ommitted, color uses whatever is selected. Colors can be:

  • color names:
    • white, blue, red, cyan, etc.
    • special names
      • monomer - gives a rainbow from N to C
      • cpk
      • amino - by aa type for proteins
      • shapely - by base type for nucleic acids
      • structure - helices and sheets
      • chain - subunits
  • hex values: [xRRGGBB] (brackets needed)
  • RGB triples: [255,0,255]


edit table


See also

References

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