Installation

Installation of the stable release

You will need write privileges in VMD's program directory (abbreviated $VMDDIR below).

1. Download the latest release package from sourceforge.net.
2. Extract the distribution archive.
3. Copy the membplugin1.x subfolder (NOT the whole membplugin-release-1.x distribution folder!) into $VMDDIR/plugins/noarch/tcl/ .
4. Copy the file loadmembplugin.tcl into $VMDDIR/scripts/init.d/ folder (create init.d folder if it does not exist).

The plugin should appear in the "Extensions/Analysis" menu upon VMD's next run.

Windows users may need to install Microsoft Visual C++ 2005 SP1 Redistributable Package (x86), available to download at http://www.microsoft.com/en-us/download/details.aspx?id=5638.

Linux users default $VMDDIR is /usr/local/lib/vmd. You can get this directory by typing the following command in VMD console or in a TK console:

puts $env(VMDDIR) # 'VMDDIR' here is literal. Do not replace by anything.

---

Transient installation without write privileges

Every time you open VMD, type the following commands in VMD console or in a TK console instead of copying any file on $VMDDIR:

lappend auto_path /path/to/membplugin-release-1.x/membplugin1.x
source /path/to/membplugin-release-1.x/loadmembplugin.tcl

---

Installation from git source code (unstable)

If you want to help developing MEMBPLUGIN or you require an already implemented feature that has not yet made its way to our latest release you should consider installing the latest developing code.

The easiest way to go if this is a one-off process is to download the latest snapshot available form Sourceforge.net and follow then the instructions for the stable release.

Instead, if you want to be in sync with development or you are considering contributing code to the project you should use git. The procedure goes as follows:

1. Create a folder accessible to each vmd user, let's call it /directory/of/repos/. Unless you are the only user of your vmd installation do not use your home directory.
2. Create a new MEMBPLUGIN repository inside /directory/of/repos/.
3. Now instead of coping the membplugin1.x subfolder as indicated in the stable release installation, this time we will a create link to membplugin-DEVEL.
4. We also create a link to the the file loadmembplugin.tcl into $VMDDIR/scripts/init.d/ folder (create init.d folder if it does not exist).

In Linux/MACOSX systems if git is installed that can be done by:

mkdir /directory/of/repos/
chmod 755 /directory/of/repos/
cd /directory/of/repos/
git clone http://git.code.sf.net/p/membplugin/code membplugin
ln -s  /directory/of/repos/membplugin/membplugin-DEVEL/ $VMDDIR/plugins/noarch/tcl/
mkdir -p  $VMDDIR/scripts/init.d/
ln -s  /directory/of/repos/membplugin/loadmembplugin.tcl  $VMDDIR/scripts/init.d/

Now to retrieve the latest updates you just need to update your git tree.

cd /directory/of/repos/membplugin
git pull