VMD: Difference between revisions

From Alliance Doc
Jump to navigation Jump to search
(Marked this version for translation)
No edit summary
 
(8 intermediate revisions by 2 users not shown)
Line 3: Line 3:


<translate>
<translate>
== Using pre-installed VMD == <!--T:1-->
 
<!--T:27-->
"VMD is a molecular visualization program for displaying, animating, and analyzing large biomolecular systems using 3-D graphics and built-in scripting."
The VMD web site is [https://www.ks.uiuc.edu/Research/vmd/ here].
 
== Using a pre-installed version == <!--T:1-->


<!--T:22-->
<!--T:22-->
Connect with <code>ssh -X/-Y</code> or via VNC to have graphics enabled.
Connect to a cluster using [[VNC]], <code>ssh -X</code>, or <code>ssh -Y</code>, in order to enable graphics.
 
We recommend using VNC for best performance.
<!--T:23-->
There are, currently, two versions of VMD available on CC clusters:
<pre>
$ module avail vmd
...
------------------ Compiler-dependent avx2 modules ----------------------
  vmd/1.9.3 (L,vis)    vmd/1.9.4a43 (vis,D)
</pre>


<!--T:3-->
<!--T:3-->
The default version is <code>1.9.4a43</code>.
To run the default version of VMD, currently <code>1.9.4a43</code>, do:
To use it:
{{Commands
{{Commands
|module load vmd
|module load vmd
Line 26: Line 22:
This should open VMD graphical windows.
This should open VMD graphical windows.


<!--T:24-->
<!--T:28-->
You can also specify the version if you want to use the older one:
See [[Using modules]] for more on the <code>module</code> command, including how to find and use other pre-installed versions.
$ module load vmd/1.9.3


== Instructions for installing version 1.9.4 Alpha == <!--T:5-->
== Installing version 1.9.4 Alpha == <!--T:5-->


<!--T:6-->
<!--T:6-->
1. Download the 1.9.4 LATEST ALPHA tar file from [http://www.ks.uiuc.edu/Development/Download/download.cgi?PackageName=VMD http://www.ks.uiuc.edu/], selecting the LINUX_64 version (free registration is required).
1. Download the 1.9.4 LATEST ALPHA tar file from [http://www.ks.uiuc.edu/Development/Download/download.cgi?PackageName=VMD http://www.ks.uiuc.edu/], selecting the LINUX_64 version.  Free registration is required.


<!--T:7-->
<!--T:7-->
Line 39: Line 34:


<!--T:8-->
<!--T:8-->
3. Unpack the file with:
3. Unpack the file:


<!--T:9-->
</translate>
tar xvf vmd-1.9.4*.opengl.tar.gz
tar xvf vmd-1.9.4*.opengl.tar.gz
<translate>


<!--T:10-->
<!--T:10-->
4. Enter the created directory by:
4. Enter the newly-created directory:


<!--T:11-->
</translate>
cd vmd-1.9.4*
cd vmd-1.9.4*
<translate>


<!--T:12-->
<!--T:12-->
5.
5. Create two new directories to receive the program files:
 
</translate>
  mkdir ~/vmd_install
  mkdir ~/vmd_install
  mkdir ~/vmd_library
  mkdir ~/vmd_library
<translate>


<!--T:13-->
<!--T:13-->
6. edit the ''configure'' file to read
5. Edit the <code>configure</code> file to read as follows, replacing each instance of <code>your_user_name</code> with your actual user name:


<!--T:14-->
</translate>
# Directory where VMD startup script is installed, should be in users' paths.
# Directory where VMD startup script is installed, should be in users' paths.
  $install_bin_dir="/home/your_user_name/vmd_install";
  $install_bin_dir="/home/your_user_name/vmd_install";
 
  <!--T:15-->
  # Directory where VMD files and executables are installed
# Directory where VMD files and executables are installed
  $install_library_dir="/home/your_user_name/vmd_library";
  $install_library_dir="/home/your_user_name/vmd_library";
<translate>


<!--T:16-->
<!--T:17-->
but replace your_user_name with your actual user name.
6. Run <code>configure</code> and <code>make</code>:


<!--T:17-->
</translate>
7. Run configure:
  ./configure
  ./configure
<!--T:18-->
8. Run make
  cd src
  cd src
  make install
  make install
<translate>


<!--T:19-->
<!--T:19-->
9. Add the resulting executable to your path  
7. Add the resulting executable to your path:
</translate>
  export PATH=~/vmd_install:$PATH
  export PATH=~/vmd_install:$PATH
<translate>


<!--T:25-->
<!--T:25-->
Also, modify the RPATH of vmd files so it does not use libraries in /usr on our system
8. Use <code>setrpaths.sh</code> to modify the VMD executables so they use libraries from CVMFS:
 
</translate>
<!--T:26-->
  cd ~/vmd_library/
cd
  cd vmd_library/
  setrpaths.sh  --path .
  setrpaths.sh  --path .
<translate>


<!--T:20-->
<!--T:20-->
If getting a blank window on a Mac, try:
If you are using a Mac and getting a blank window, try running this:


<!--T:21-->
defaults write org.macosforge.xquartz.X11 enable_iglx -bool true
</translate>
</translate>
defaults write org.macosforge.xquartz.X11 enable_iglx -bool true
<translate>


== Installing plugins == <!--T:29-->


== Installing plugins ==
<!--T:30-->
 
VMD has many plugins available.  You can install them in your own space.   
VMD has many plugins available.  You should be able to install them in your own space.  The example that follows will illustrate how to install the [https://github.com/HuiLiuCode/CaFE_Plugin CaFE plugin].
The example that follows illustrates how to install the [https://github.com/HuiLiuCode/CaFE_Plugin CaFE plugin],
 
from detailed instructions which can be found [https://github.com/HuiLiuCode/CaFE_Plugin/blob/master/doc/manual.pdf here]:
The installation instructions are detailed [https://github.com/HuiLiuCode/CaFE_Plugin/blob/master/doc/manual.pdf here].


</translate>
  wget https://github.com/HuiLiuCode/CaFE_Plugin/archive/refs/heads/master.zip
  wget https://github.com/HuiLiuCode/CaFE_Plugin/archive/refs/heads/master.zip
  unzip master.zip
  unzip master.zip
Line 110: Line 109:
  mv cafe1.0 ~
  mv cafe1.0 ~
  cd
  cd
<translate>


Then edit the .vmdrc file with
<!--T:31-->
Edit the <code>.vmdrc</code> file with your favorite editor (<code>nano, vim, emacs</code> etc.) and add this line:


  nano .vmdrc
</translate>
  set auto_path [linsert $auto_path 0 {~/cafe1.0}]
<translate>


and add this line:
<!--T:32-->
After this, load the <code>vmd</code> module and any other modules which are required, such as <code>namd</code> and the CaFE plugin should be available.


set auto_path [linsert $auto_path 0 {~/cafe1.0}]
== Links == <!--T:33-->


After this load the vmd module and the other modules (namd) which are required, and the CaFE plugin should be available.
<!--T:34-->
* WestGrid webinars (in English)
** [https://www.youtube.com/watch?v=_skmrS6X4Ys Molecular visualization with VMD]
** [https://www.youtube.com/watch?v=Jce5JN2fLuo Advanced VMD: Trajectories, movies, scripting]


== Links ==
</translate>
 
* WestGrid webinars
** [https://www.youtube.com/watch?v=_skmrS6X4Ys Molecular visualization with VMD]
** [https://www.youtube.com/watch?v=Jce5JN2fLuo Intermediate VMD topics - Trajectories, movies, scripting]

Latest revision as of 22:14, 22 September 2022

Other languages:


"VMD is a molecular visualization program for displaying, animating, and analyzing large biomolecular systems using 3-D graphics and built-in scripting." The VMD web site is here.

Using a pre-installed version[edit]

Connect to a cluster using VNC, ssh -X, or ssh -Y, in order to enable graphics. We recommend using VNC for best performance.

To run the default version of VMD, currently 1.9.4a43, do:

[name@server ~]$ module load vmd
[name@server ~]$ vmd

This should open VMD graphical windows.

See Using modules for more on the module command, including how to find and use other pre-installed versions.

Installing version 1.9.4 Alpha[edit]

1. Download the 1.9.4 LATEST ALPHA tar file from http://www.ks.uiuc.edu/, selecting the LINUX_64 version. Free registration is required.

2. Copy the file to the home directory of the cluster you wish to use.

3. Unpack the file:

tar xvf vmd-1.9.4*.opengl.tar.gz

4. Enter the newly-created directory:

cd vmd-1.9.4*

5. Create two new directories to receive the program files:

mkdir ~/vmd_install
mkdir ~/vmd_library

5. Edit the configure file to read as follows, replacing each instance of your_user_name with your actual user name:

# Directory where VMD startup script is installed, should be in users' paths.
$install_bin_dir="/home/your_user_name/vmd_install";

# Directory where VMD files and executables are installed
$install_library_dir="/home/your_user_name/vmd_library";

6. Run configure and make:

./configure
cd src
make install

7. Add the resulting executable to your path:

export PATH=~/vmd_install:$PATH

8. Use setrpaths.sh to modify the VMD executables so they use libraries from CVMFS:

cd ~/vmd_library/
setrpaths.sh  --path .

If you are using a Mac and getting a blank window, try running this:

defaults write org.macosforge.xquartz.X11 enable_iglx -bool true

Installing plugins[edit]

VMD has many plugins available. You can install them in your own space. The example that follows illustrates how to install the CaFE plugin, from detailed instructions which can be found here:

wget https://github.com/HuiLiuCode/CaFE_Plugin/archive/refs/heads/master.zip
unzip master.zip
cd CaFE_Plugin-master
mv src cafe1.0
mv cafe1.0 ~
cd

Edit the .vmdrc file with your favorite editor (nano, vim, emacs etc.) and add this line:

set auto_path [linsert $auto_path 0 {~/cafe1.0}]

After this, load the vmd module and any other modules which are required, such as namd and the CaFE plugin should be available.

Links[edit]