Molecular Playground/Procedures

From Proteopedia

This page details procedures for authoring content modules for Molecular Playground. It is a supplement to the main article on authoring modules, Molecular Playground/Authoring.

Installing a state script from Proteopedia

1. Choose or make a page in Proteopedia where you will create your customized molecular scene. A good place to do this is in a Sandbox in your User namespace, such as "User:Your Name/Sandbox 1". Step by step instructions for creating and using such a Sandbox are available in Help:Sandboxes.

2. Create the customized molecular scene that you wish to show in MP by using the Scene Authoring Tools in Proteopedia. Save your scene so that it is displayed on the page where you are developing it. Introductory videos and extensive help are available to get you started with these easy-to-use tools.

   Proteopedia:Video_Guide which includes A Video on Adding Molecular Scenes. Help:Editing which includes How To Create A New Page Instructions for creating a molecular scene with Proteopedia's Scene Authoring Tools.

3. Save your scene without "zoom-out" and "transition". Don't worry if you have already saved your scene. You can save as many versions of each scene as you wish.

   1. Edit your page and Show the Scene Authoring Tools.

   2. Load your scene.

   3. Click on the Save tab.

   4. Add to the description "No zoom-out, no transition".

   5. Set the scene to spin when it loads.

   6. Check show advanced options.

   7. Check both of the advanced options: skip the zoom-out and skip the transition.

   8. Save your scene, making sure to change the scene number in your wikitext to show this new version of the scene.

   9. Save the page and click the green link to display the scene. Fix any problems that you see.

4. Capture the state script for your scene. In order to project your scene in MP, you will need to capture the state script into a file on your computer. When completed, the script file will be submitted to the MP team. Having a local copy on your computer also has the advantage that you can display the scene in the Jmol application, in a 1024 x 768 pixel window, just as it will appear when projected in MP.
   1. Choose a short name for the MP module you are developing, typically using the name of the molecule. This name will be used in the names of all the files making up the module, thereby making them easy to identify. If there need to be spaces within the name, replace them with underscores (or simply omit the spaces). For example, "your_molecule" or "yourMolecule".

   2. Create a folder (directory) on your computer to contain the files for this module, e.g. a folder named yourMolecule.

   3. Display the state script: Display your scene in Proteopedia. Toggle spinning OFF. Orient the molecule as you would like it to first appear, by rotating it with the mouse. Click on "Jmol" (or right click) to open Jmol's menu, and select Show, Current state.

   4. Save the state script into a file: Block select the entire state script in the upper frame of the Jmol Script Console window. (On Macs, you'll have to use the mouse for this.) Copy the entire state script into a text editing program. On Macs, you'll have to drag the blocked text and drop it into the text editor program. Save the state script into a file named e.g. yourMolecule_state.spt. The file type .spt signifies that this is a Jmol script. Be sure to save it as plain text. On Macs, plain text editors are TextEdit (comes with OS X; select Make Plain Text on the Format menu), and TextWrangler (free from BareBoneSoftware).

5. Test your state script in the Jmol application.

   1. yy

   2. Put a copy of the PDB file used in your module in the yourMolecule folder. In Proteopedia, search for your PDB code, and on the page titled with that PDB code, use the coordinates: save as pdb link to download the file.