VMD

Visual Molecular Dynamics (VMD)

VMD is a good visualization tool for visualizing large molecular systems (typically used for large biomolecular systems). VMD has a long history of being interfaced to immersive technologies, including haptic devices and CAVE VR displays.

How to Run VMD in Immersive Mode

If VMD with the FreeVR interface is installed and properly configured, follow these steps to run in immersive mode:

1. % vmd -dispdev freevrforms ../proteins/brH.pdb
2. In order to grab and move an object, the grab tool must be initialized:

   1. →Graphics →Tools
   2. →Create a grab style tool
   3. set Position to FreeVRTracker
   4. set Buttons to FreeVRButtons

   The wand avatar will now appear in the scene

3. Now touch an object with the wand avatar and press Button-1 to move it.

How to Build VMD w/ Immersive features

This section specifically instructs on how to compile VMD using the FreeVR immersive interface library.

1. Install missing dependencies

   Commonly needed packages include:

   • tcl-devel (8.x -- perhaps 8.4 or greater)
   • tk-devel (8.x -- perhaps 8.4 or greater)
   • fltk-devel
   • netcdf-devel

2. Download the latest source (version 1.9.1 as of this writing [04/09/12])

   http://www.ks.uiuc.edu/Development/Download/download.cgi?PackageName=VMD

   NOTE: there is a (free) registration process required

   NOTE: the pre-built packages may not contain the Immersive features

3. Untar the source ball

   E.g. % tar -zxf vmd-1.9.1.src.tar.gz

4. Compile the plugins

   % cd plugins

   % make <architecture> — E.g. LINUXAMD64

   % make distrib

5. Configure VMD

   % cd ../vmd-<version>

   % $EDITOR configure.options

   Enter a list of desired options -- make sure to include FREEVR

   A sample list is:

   • LINUXAMD64 OPENGL FREEVR FLTK TK TCL PTHREADS

   % ./configure

6. Compile VMD

   % EXPORT PLUGINDIR=`pwd`/plugins

   % $EDITOR Makefile

   NOTE: you will need to edit the values for INCDIRS and LIBDIRS to point to the correct directory for the FreeVR includes and library.

   * make veryclean

   % make -j 8

   NOTE: you will get several compiler warnings. As long as they are only warnings, you should be fine.

7. Install VMD

   % sudo make install

At this point you can now run VMD in standard desktop mode.

• For example:

  % vmd ../proteins/brH.pdb

How to Configure VMD for Immersive displays

There are two stages of configuration required for the overall configuration of VMD for immersive displays. The first step is to configure FreeVR for the specific hardware setup of the immersive facility. This is explained in the FreeVR documentation. The second stage is to link the FreeVR inputs to VMD "sensors devices".

VMD "sensor devices" are specified in the .vmdsensors file. The format of this file is described in the VMD User's Guide: Tool Window documentation.

• Create a .vmdsensors file:

  Here is a sample .vmdsensors file for use with FreeVR:

###     
### Configuration for the FreeVR trackers
###     
device freevrtracker freevrtracker://local/freevr
scale 0.5
offset 0.9 -4.0 -1.0
device freevrbuttons freevrbuttons://local/freevr:0,1,2,3
## if you have more than one wand..
#device vrtracker2 freevrtracker://local/freevr:1
#scale 1.0
#offset 0.9 -4.0 -1.0

Usage Tidbits

• To change the overall world transformation via the Tcl command shell, try these options:
  • scale to .5
  • translate to 0 0 -3

• To place the FLTK menu interface on a screen separate from the immersive displays, use the DISPLAY environment variable.

Usage Issues

[NOTE: these issues are from tests with VMD version 1.9.2a15.]

• I still need to figure out the proper scale and offset (this would/will be easier if we can avoid the use of Euler angles in P_GrabTool.C).
• The grab tool only grabs one molecule object at a time, so multiple molecules won't stay together.
• The grab tool requires that the wand avatar be touching an object before it can be moved.
• The rotate tool does not work
• I don't know how to use the joystick tool — does it work with the VR interfaces?
• I need to learn whether (and if so what) the command-line and/or tcl-shell options for setting up the graphics tools w/o the need for the interactive menu.
• There are gimble lock issues when the wand points up or down.
• The material colors of some/all of the objects in the scene are not always present.
• Changes in representations seem to only have an effect on a single screen.

Development Issues

This section is for issues that are of interest to those working directly on the VMD code-base as it relates to immersive interfaces.

• Need to figure out how to pass RenderInfo * argument to FreeVRScene::draw() in order to add the navigation controls to where the virtual world is rendered.
• Need to go over the source code in P_GrabTool.C so that I can know how to improve it (and I'll add comments as we go.) My goal is to avoid the use of Euler angles, since there are gimble lock issues in the interface.
• Consider adding a grab-world tool that allows the entire world to be grabbed with the wand.
• Determine whether there is a mechanism to enable an X11 window always-on-top property for the FLTK control menu.