Requirements

• C/C++ compiler (platform dependent packages will need to be compiled on your machine).
• Python interpreter version 2.4 or higher.

  Mac users need also X11 for Mac OS X.

• SWIG version 1.3.31.
• Tcl and Tk libraries version 8.4.
• OpenGL version 1.2 or higher is required for using VolumeRendering tools available in VISION and PMV.
• GNU C++ (g++) compiler is required for installing QSlimLib package.

Installation Instructions

1) Download and untar mgltools_source_1.5.2.tar.gz.

gunzip mgltools_source_1.5.2.tar.gz
tar xvf mgltools_source_1.5.2.tar.gz
or
tar zxvf mgltools_source_1.5.2.tar.gz

2) Go to mgltools_source_1.5.2 directory.

cd mgltools_source_1.5.2


3) Run the installation script "startInstallation".

./startInstallation

This script uses the Python interperter available on your machine to install all the packages.
NOTE: By default MGLTools packages are installed in sys.exec_prefix/lib/python2.5/site-packages/MGLToolsPckgs
Other locations can be specified during the installation process.
runPmv, runAdt and runVision scripts are installed at user specified location.
Also, during the installation process, the user is asked whether or not he wants to install Numeric. If the user chooses to install Numeric, it will be installed in sys.exec_prefix/lib/python#version#/site-packages (required location). The user must have write permission to this directory.
The installation script will try to install sitecustomize.py to sys.prefix/lib/python#version#. If it fails due to file permissions, the user is asked to copy this file manually.
The user has to install Python Imaging Library (PIL) located in THIRDPARTY directory manually. Follow the installation instructions in THIRDPARTY/Imaging-1.1.5/README file.

4) Download and install package called 'binaries' (optional).

Package 'binaries' contains executables for APBS and Qhull. Refer to README file for the installation instructions.

Launching ADT, PMV or Vision

• Type: runPmv at a command prompt.

A Python Molecule Viewer should come up. You can load files from the Data directory and start playing with Pmv.

Troubleshooting

Problems with Tkinter support.

If you get ImportError: No module named _tkinter, you might need to reinstall Python with Tkinter support. http://wiki.python.org/moin/TkInter

 Cannot find -ltclstub8.4.

 Install tcl-devel-8.4.

 ImportError: No module named PIL.

 Install PIL located in mgltools_source_1.5.2/THIRDPARTY/Imaging-1.1.5. Make sure to compile with JPEG and PNG support as described in Prerequisites section in the README.

Problems building Python extensions such as geomutilis.

Our wrappers are build with SWIG version 1.3.31. You might get g++ error messages if your SWIG version is different.

Windows users

Click here for instructions on how to build Python extensions.

Problem with undefined symbol: glBlendEquationSeparateATI?

A quick fix for this problem is to remove/comment glBlendEquationSeparateATI from your /usr/include/GL/gl.h and rebuild opengltk package. Please see Bug 834. See also: Using hardware accelerated 3D renderer on Linux.