NOTE: This project has been deprecated, and exists only for educational purposes -- there will be no further changes made to the source unless someone else has an interest in taking over the project. --Christian

ImmersiveViz is a PyMol script to interface with the Head Tracking Driver Project in order to control the molecule by moving around in physical space.

The script requires Python and wxPython to be installed, and currently only works on the Mac operating system. In time, it will be released for Linux and Windows as well.

This project extends from the MolViz Project of Christian Muise and Ryan Lilien at the University of Toronto.

Installation

1. Make sure you have Python, wxPython, and PyMol installed. (Note: Most Macs come with Python installed and newer ones come with wxPython)
2. Download the latest dmg file [here].
3. Your system may place a drive 'immersiveviz' on your desktop. If it does not, locate the 'immersiveviz' dmg file and double-click it (the 'immersivevis' drive should now appear on your desktop).
4. Copy the ImmViz folder from the immersiveviz drive onto the desktop
5. If you installed PyMol in step 1 to /Applications/MacPyMOL.app, then you're done (this will be the case if you installed PyMol by dragging the application into the Application folder). Otherwise, place your MacPyMOL.app in the ImmViz folder and run the Install application.

Running

1. Run the ImmersiveViz program to start things normally.
2. (Alternatively) Run the ImmersiveVizDemo program to start things with a molecule preloaded.
3. Start a Head Tracking Driver (obtained from [here])

You may want to hide the message window in PyMol since that is used to pass messages between the GUI and the program.

Note: Information on the Plugin's GUI and a more general user manual can be found [here].