This is a read-only mirror of pymolwiki.org

Difference between revisions of "GROMACS Plugin"

From PyMOL Wiki
Jump to navigation Jump to search
m (2 revisions)
(Add windows instructions)
Line 6: Line 6:
 
}}
 
}}
  
[https://github.com/tomaszmakarewicz/Dynamics Dynamics PyMOL Plugin] is plugin for PyMOL, which add molecular dynamics simulation feature. It is meant to be easy to use. The plugin uses GROMACS tools as a back-end. Project is developed as an open source and as such create full open source stack together with PyMOL and GROMACS. Because GROMACS can compile easily only on Unix like systems, the plugin also keep compatibility only with those. No Windows port is expected.
+
[https://github.com/tomaszmakarewicz/Dynamics Dynamics PyMOL Plugin] is plugin for PyMOL, which add molecular dynamics simulation feature. It is meant to be easy to use. The plugin uses GROMACS tools as a back-end. Project is developed as an open source and as such create full open source stack together with PyMOL and GROMACS. Software works on Linux, MacOS X and Windows/Cygwin.
  
 
== Website ==
 
== Website ==
Line 27: Line 27:
 
== Installation ==
 
== Installation ==
  
There are at least few ways to install the plugin. In this section we will describe the most common. Please keep in mind, that this plugin is develop for Unix platform - it will not work on MS Windows.
+
There are at least few ways to install the plugin. In this section we will describe the most common.
  
 
=== Ubuntu ===
 
=== Ubuntu ===
Line 42: Line 42:
 
  emerge --ask sci-chemistry/pymol-plugins-dynamics
 
  emerge --ask sci-chemistry/pymol-plugins-dynamics
  
=== Other GNU/Linux and Unix===
+
=== Other Linux distributions and MacOS X ===
  
 
The second way for all other platforms or Ubuntu as well, is to download latest release of the plugin directly from its GitHub webpage:<br>
 
The second way for all other platforms or Ubuntu as well, is to download latest release of the plugin directly from its GitHub webpage:<br>
Line 53: Line 53:
 
* ProDy (optional)
 
* ProDy (optional)
 
In order to take advantage of latest features you will need to have [http://www.csb.pitt.edu/prody/ ProDy] library installed.
 
In order to take advantage of latest features you will need to have [http://www.csb.pitt.edu/prody/ ProDy] library installed.
 +
 +
=== Windows/Cygwin ===
 +
 +
* Download and install the latest version of Cygwin including appropriate code development packages.
 +
* Download, compile, and install the latest version of GROMACS 2016.3 under Cygwin. Follow the standard compilation, installation and testing instructions to build, compile and install GROMACS 2016.3 under Cygwin. For example:
 +
% cd gromacs-2016.3
 +
% mkdir build
 +
% cmake .. -DBUILD_SHARED_LIBS=off -DGMX_BUILD_OWN_FFTW=ON -DCMAKE_INSTALL_PREFIX=/cygdrive/c/<YOUR_GROMACS_ROOT>
 +
% make >& make.log
 +
% make install >& make.install.log
 +
* Test GROMACS from Cywin command line.
 +
* Download and install 64 bit PyMOL 1.8.2.0, which comes with Python 2.7.9.
 +
* Test PyMOL.
 +
* Update PATH environment variable on Windows to include the following bin directories corresponding to GROMACS and Cygwin:
 +
C:\<YOUR_GROMACS_ROOT>\bin
 +
C:\<YOUR_CYGWIN_PATH>\bin
 +
* Install the GROMACS plugin following standard PyMOL instructions. Download latest plugin version from link: https://github.com/tomaszmakarewicz/Dynamics/archive/master.zip and unpack it. Run PyMOL. On the top Menu choose Plugin->Manage Plugins->Install... Then choose pymol_plugin_dynamics.py file. After installation restart PyMOL
  
 
=== Latest Snapshots ===
 
=== Latest Snapshots ===
Line 76: Line 93:
 
This software (including its Debian packaging) is available to you under the terms of the GPL-3, see "/usr/share/common-licenses/GPL-3". Software is created and maintained by Laboratory of Biomolecular Systems Simulation at University of Gdansk.<br>
 
This software (including its Debian packaging) is available to you under the terms of the GPL-3, see "/usr/share/common-licenses/GPL-3". Software is created and maintained by Laboratory of Biomolecular Systems Simulation at University of Gdansk.<br>
 
Contributors:<br>
 
Contributors:<br>
- Tomasz Makarewicz (btchtm [at] ug [dot] edu [dot] pl)
+
- Tomasz Makarewicz (btchtm [at] ug [dot] edu [dot] pl) <br>
 +
- Ajit B. Datta <br>
 +
- Sara Boch Kminikowska <br>
 +
- Manish Sud <br>
  
 
[[Category:Plugins]]
 
[[Category:Plugins]]

Revision as of 12:03, 31 May 2017

Type PyMOL Plugin
Download https://github.com/tomaszmakarewicz/Dynamics/releases
Author(s) Laboratory of Biomolecular Systems Simulations
License GPLv3

Dynamics PyMOL Plugin is plugin for PyMOL, which add molecular dynamics simulation feature. It is meant to be easy to use. The plugin uses GROMACS tools as a back-end. Project is developed as an open source and as such create full open source stack together with PyMOL and GROMACS. Software works on Linux, MacOS X and Windows/Cygwin.

Website

https://github.com/tomaszmakarewicz/Dynamics

Features

Menu1.png

  • Easy to use GUI, to take advantage of complex software GROMACS.
  • Work directly on molecules loaded to PyMOL.
  • Display results of calculations directly in PyMOL.
  • Set restraints, choose water models, force fields and many more.
  • Save your work and finish calculations later or on the other machine.
  • Do your work free of charge and without any restrictions. Feel free to modify any component of the stack.
  • Minimum dependencies. Plugin use the same graphic libraries as PyMOL, so working PyMOL and GROMACS installations are enough to make plugin work.

Note that exact instruction of how to use program is in the software manual, which is available together with the plugin.

Installation

There are at least few ways to install the plugin. In this section we will describe the most common.

Ubuntu

The easiest way to install the plugin is to use PPA repositories:

sudo add-apt-repository ppa:tomaszm/dynamics
sudo apt-get update
sudo apt-get install pymol-plugin-dynamics

All required libraries will be downloaded as dependencies. Supported versions of Ubuntu are latest stable and latest LTS.

Gentoo

The plugin is also present in Gentoo ebuild system. To make the installation use (as root):

emerge --ask sci-chemistry/pymol-plugins-dynamics

Other Linux distributions and MacOS X

The second way for all other platforms or Ubuntu as well, is to download latest release of the plugin directly from its GitHub webpage:
https://github.com/tomaszmakarewicz/Dynamics/releases
Then run PyMOL as a root. On the top Menu choose Plugin->Manage Plugins->Install... Then choose pymol_plugin_dynamics.py file. After installation restart PyMOL with normal user privilege.

Required dependencies:

  • PyMOL
  • GROMACS
  • ProDy (optional)

In order to take advantage of latest features you will need to have ProDy library installed.

Windows/Cygwin

  • Download and install the latest version of Cygwin including appropriate code development packages.
  • Download, compile, and install the latest version of GROMACS 2016.3 under Cygwin. Follow the standard compilation, installation and testing instructions to build, compile and install GROMACS 2016.3 under Cygwin. For example:
% cd gromacs-2016.3
% mkdir build
% cmake .. -DBUILD_SHARED_LIBS=off -DGMX_BUILD_OWN_FFTW=ON -DCMAKE_INSTALL_PREFIX=/cygdrive/c/<YOUR_GROMACS_ROOT>
% make >& make.log
% make install >& make.install.log
  • Test GROMACS from Cywin command line.
  • Download and install 64 bit PyMOL 1.8.2.0, which comes with Python 2.7.9.
  • Test PyMOL.
  • Update PATH environment variable on Windows to include the following bin directories corresponding to GROMACS and Cygwin:
C:\<YOUR_GROMACS_ROOT>\bin
C:\<YOUR_CYGWIN_PATH>\bin
  • Install the GROMACS plugin following standard PyMOL instructions. Download latest plugin version from link: https://github.com/tomaszmakarewicz/Dynamics/archive/master.zip and unpack it. Run PyMOL. On the top Menu choose Plugin->Manage Plugins->Install... Then choose pymol_plugin_dynamics.py file. After installation restart PyMOL

Latest Snapshots

You can download latest master snapshot by command:

git clone git://github.com/tomaszmakarewicz/Dynamics.git

Then run PyMOL as a root. On the top Menu choose Plugin->Manage Plugins->Install... Then choose pymol_plugin_dynamics.py file. After installation restart PyMOL with normal user privilege.

Required dependencies:

  • PyMOL
  • GROMACS
  • ProDy (optional)
  • PLUMED (optional, compiled into GROMACS)

In order to take advantage of latest features you will need to have ProDy library installed and PLUMED compiled into GROMACS.

References

Molecular Dynamics Simulation by GROMACS Using GUI Plugin for PyMOL Tomasz Makarewicz and Rajmund Kaźmierkiewicz Journal of Chemical Information and Modeling 2013 53 (5), 1229-1234
Improvements in GROMACS plugin for PyMOL including implicit solvent simulations and displaying results of PCA analysis Tomasz Makarewicz, Rajmund Kaźmierkiewicz Journal of Molecular Modeling May 2016, 22:109

License

This software (including its Debian packaging) is available to you under the terms of the GPL-3, see "/usr/share/common-licenses/GPL-3". Software is created and maintained by Laboratory of Biomolecular Systems Simulation at University of Gdansk.
Contributors:
- Tomasz Makarewicz (btchtm [at] ug [dot] edu [dot] pl)
- Ajit B. Datta
- Sara Boch Kminikowska
- Manish Sud