Help:Jmol in EcoliWiki

From EcoliWiki
Revision as of 05:06, 1 August 2009 by JimHu (talk | contribs) (→Examples)
Jump to navigation Jump to search

About

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 and custom EcoliWiki templates.

What Types of Structures can I 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.

"How To" Embed the Image

  • 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 support, please contact us for help.
  • When you upload your pdb file, put {{subst:Jmol_template}} in the Description box. The template will automatically load all the technical details necessary to make this work. Click "Save" to save the page. 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. The box will appear with a "1" in it.
  • You will need to replace the one with your picture. Click the "Edit" link again and there will be a lot more text than what you wrote (that's suppose to happen). In place of the 1 (several lines from the top), insert the pdb file name. This will allow EcoliWiki to upload the file contents of the file. Click "Save." Your picture should replace the 1 and should be rotating around. Highlight and copy the title of the page (at the top) for the next step.
  • Go to the gene product page where you want to embed the image. Scroll down to the Structure Heading, and click the edit link for the structure notes. Paste the Image title into the text box and add 2 sets of curly brackets. Example:{{Image: 1JFE.pdb}}. Click "Save" and the image should be on the page

Troubleshooting

  • Biological vs crystallographic units: The coordinate files from the PDB are usually for the crystallographic asymmetric unit. This means that there may be multiple molecules in the same file, or that there may only be part of a multimer. The PDB provides a separate file for the biological unit in many cases. See tutorial at the PDB

Examples

See also

References

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