Difference between revisions of "Using the implicit membrane model IMM1"

From CUC3
Jump to navigation Jump to search
import>Jwll2
import>Jwll2
m
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[GMIN]] can now incorporate the IMM1 implicit membrane model described by Themis Lazaridis (1). To use this, first update and compile charmm and GMIN as described by [[Compiling_GMIN_with_CHARMM]].
+
[[GMIN]] can now incorporate the IMM1 implicit membrane model described by Themis Lazaridis [http://www3.interscience.wiley.com/cgi-bin/fulltext/104537101/HTMLSTART]. To use this, first update and compile charmm and GMIN as described by [[Compiling_GMIN_with_CHARMM]].
  +
  +
===Previously Existing Terms===
   
 
Since the use of a membrane introduces directionality to the system, previous parameters specifying orientation and spacial position become important. The system is optimised with respected to rotation, and the parameters behind the basin-hopping can be defined in the <i>data</i> file using the terms:
 
Since the use of a membrane introduces directionality to the system, previous parameters specifying orientation and spacial position become important. The system is optimised with respected to rotation, and the parameters behind the basin-hopping can be defined in the <i>data</i> file using the terms:
   
 
<pre>
 
<pre>
  +
CHRIGIDROT prot rotmax nrot
CHPMAX 0.4
 
CHPMIN 0.2
 
CHNMAX 10
 
CHNMIN 0
 
 
</pre>
 
</pre>
   
These parameters are described in the GMIN documentation. <b>Note that if including these terms in the <i>data</i> file, the directory must also contain a file entitled <i>segment.tomove</i> which contains the single character:</b>
+
This optimises rigid body rotation every nrot basin-hopping steps with maximum allowed probability prot and maximum allowed rotation angle rotmax (in degrees). <b>Note that if including these terms in the <i>data</i> file, the directory must also contain a file entitled <i>segment.tomove</i> which specifies the segments for rotation. If 2 segments were to be rotated eg in a dimer, the segments.tomove files would be:</b>
   
 
<pre>
 
<pre>
 
1
 
1
  +
2
 
</pre>
 
</pre>
 
The system can be translated so that the centre-of-mass lies at the origin after every quench. This is achieved by including in the <i>data</i> file the term:
 
 
<pre>
 
CENTRE
 
</pre>
 
 
At present, CENTRE causes convergence issues as moving back to z=0 actually changes the energy. It is advised the CENTREXY is used instead (see below).
 
   
 
===New Terms in GMIN===
 
===New Terms in GMIN===
   
Two new terms have been included for use with the implicit membrane. The coordinates of the centre of mass of the system before the initial quench can be specified using:
+
Two new terms have been included for use with the implicit membrane.
  +
  +
Firstly, the coordinates of the centre of mass of the system before the initial quench can be specified using:
   
 
<pre>
 
<pre>
SETCENTRE <i>x</i> <i>y</i> <i>z</i>
+
SETCENTRE x y z
 
</pre>
 
</pre>
   
 
Specifying <i>x</i> <i>y</i> <i>z</i> as 0.0, 0.0, 0.0 will set the centre of mass at the origin and hence the centre of the membrane. A protein can be moved out of the membrane by altering the <i>z</i> coordinate.
 
Specifying <i>x</i> <i>y</i> <i>z</i> as 0.0, 0.0, 0.0 will set the centre of mass at the origin and hence the centre of the membrane. A protein can be moved out of the membrane by altering the <i>z</i> coordinate.
   
  +
Secondly, the system can be translated so that the centre-of-mass lies at the origin after every quench, using the keyword CENTRE. At present, CENTRE causes convergence issues as moving back to z=0 actually changes the energy. It is advised that CENTREXY is used instead, moving the protein back to (0,0,z) i.e. preserving the z-coordinate, by using the keyword:
Secondly, CENTREXY moves the protein back to (0,0,z) i.e. it preserved the z-coordinate. This solves the convergence problem mentioned above when using CENTRE.
 
   
  +
<pre>
  +
CENTREXY
  +
</pre>
   
  +
This solves the convergence problem mentioned above when using CENTRE.
   
  +
===CHARMM keywords===
   
  +
The toppar parameters that should be used are the EEF1.1.inp files. This is done using:
   
  +
<pre>
-------------------------------------------------------------------------------------
 
  +
open read unit 11 card name toph19_eef1.1.inp
  +
read rtf card unit 11
  +
close unit 11
  +
  +
open read unit 12 card name param19_eef1.1.inp
  +
read para card unit 12
  +
close unit 12
  +
</pre>
   
  +
The charmm keywords are as follows:
A shorter dump interval is recommended as system size (and therefore time/quench) increases. To restore a run, you need the '''RESTORE''' keyword. Here are two excerpts from example data files to demonstrate:
 
   
Original data file:
 
 
<pre>
 
<pre>
  +
eef1 setup membrane slvt water slv2 chex nsmth 10 width 26.0 temp 298.15 -
...
 
  +
unit 93 name "/home/jwll2/svn/CHARMM31/toppar/solvpar.1.inp" aemp 0.85
DUMPINT 100
 
  +
!gouy anfr 0.3 area 70. conc 0.1 offset 3.0 valence 1
STEPS 10000
 
  +
update ctonnb 7. ctofnb 9. cutnb 15. group rdie
SAVE 100
 
...
 
 
</pre>
 
</pre>
   
  +
<b>membrane</b> introduces the membrane model and <b>slvt water</b> and <b>slv2 chex</b> specify that the exterior solvent is water and that the interior solvent is cyclohexane. <b>nsmith</b>, set to 10 as a default, determines how steep the transition is at the interface between interior and exterior. The <b>width</b> of the membrane can be altered by altering the value 26.0. This refers to the width of the membrane in angstroms and usually has a value 25-30. The last keyword <b>aemp</b>, default 0.85, determines the extent of strengthening of electrostatic interactions in the membrane (the smaller, the stronger). This parameter was empirically adjusted to give reasonable membrane insertion energies for model systems.
data file for restarted run:
 
  +
  +
Uncommenting the commented line and adding a continuation to the line above allows the inclusion of Gouy Chapman theory adjustments to the membrane. This describes the effect of a static surface charge on the membrane potential. <b>anfr</b> describes the molar fraction of anionic lipids (e.g. a 70/30 mixture of PC/PG corresponds to ANFR 0.3, which is the default). <b>area</b> is the area (Angstrom^2) per lipid (default 70) and <b>offset</b> is the distance of the plane of negative charge, usually the phosphates, from the hydrocarbon/water boundary (default 3). <b>conc</b> and <b>valence</b> is the molarity and valence of the salt (default 0.1 and 1, respectively).
  +
  +
  +
===Visualising the Membrane in VMD===
  +
  +
VMD can be loaded using the command:
  +
 
<pre>
 
<pre>
  +
module load vmd/1.8.6
...
 
DUMPINT 100
 
RESTORE GMIN.dump
 
STEPS 15000
 
SAVE 100
 
...
 
 
</pre>
 
</pre>
   
The number of steps in the new data file should always be greater than in the original. In this case, the run is being restarted for a further 5000 quenches - 10000 + 5000 = 15000! The [[makerestart]] script does a lot of this for you.
 
   
  +
To view the membrane in VMD, first create a file called <i>centre.pdb</i>, with the following line of text:
===What if I want to change the value of SAVE?===
 
  +
For large systems, it is nice to have the flexibility to change the number of structures that are tightly converged and dumped at the end of a run. This is because final quenches often take a long time, and you may only need to see one or two structures at the start of a long series of restart runs. If your dump file was generated by a version of [[GMIN]] compiled from the repository after 30/9/2008, you can do this by simply changing the value of '''SAVE''' in the new data file. If not, you need to make a simple modification to the dump file before you use it. Open the dump file in an editor e.g. vi:
 
 
<pre>
 
<pre>
  +
ATOM 1 Ne 1 0.0 0.0 0.0 1.00 0.00 MAIN
vi GMIN.dump
 
</pre>
 
In the new format, there is an extra line in the dump file which details the number of structures saved in the previous run. You need to input this manually if you have an old dump file, otherwise it will not be read in correctly. Here is an example, first the original - old dump file:
 
<pre>
 
steps completed J1 in mc
 
13000
 
COORDS
 
run number 1
 
22.174000000000000 83.915460000000000 47.511220000000000
 
21.352510000000000 82.452780000000000 47.773840000000000
 
22.240000000000000 82.880000000000000 47.440000000000000
 
...
 
 
</pre>
 
</pre>
   
  +
This is simply an Ne atom placed at the origin. Also, obtain <i>plotBox.tcl</i> from the Wales Group homepage [http://www-wales.ch.cam.ac.uk/~wales/plotBox.tcl].
Here, 13000 quenches have been done. Looking at the old data file above - we know that 100 structures were saved. This info must now be included in the dump file. The modification is performed as follows:
 
  +
  +
Load VMD and any molecules that you wish to visualise, followed by <i>centre.pdb</i>. Then open up the TK console and type:
  +
 
<pre>
 
<pre>
  +
source <PATH>/plotBox.tcl
steps completed J1 in mc
 
  +
plotBox z 30.0 30.0 13.0 0.0
13000
 
100
 
COORDS
 
run number 1
 
22.174000000000000 83.915460000000000 47.511220000000000
 
21.352510000000000 82.452780000000000 47.773840000000000
 
22.240000000000000 82.880000000000000 47.440000000000000
 
...
 
 
</pre>
 
</pre>
  +
With this change done, you are now free to set '''SAVE''' to anything you'd like for the restart run.
 
  +
The syntax of this: z refers to the direction of the surface normal of the membrane. 30.0 and 30.0 specify half the length of the membrane in the x and y directions in angstroms and can be increased if necessary. 13.0 describes half of the width of the membrane and 0.0 refers to the separation of the slab layers.
  +
  +
N.B It is important to load centre and input the commands into the console <i>after</i> all the molecules have been loaded. Otherwise the width of the membrane will be scaled by VMD.

Latest revision as of 13:12, 22 July 2009

GMIN can now incorporate the IMM1 implicit membrane model described by Themis Lazaridis [1]. To use this, first update and compile charmm and GMIN as described by Compiling_GMIN_with_CHARMM.

Previously Existing Terms

Since the use of a membrane introduces directionality to the system, previous parameters specifying orientation and spacial position become important. The system is optimised with respected to rotation, and the parameters behind the basin-hopping can be defined in the data file using the terms:

CHRIGIDROT prot rotmax nrot

This optimises rigid body rotation every nrot basin-hopping steps with maximum allowed probability prot and maximum allowed rotation angle rotmax (in degrees). Note that if including these terms in the data file, the directory must also contain a file entitled segment.tomove which specifies the segments for rotation. If 2 segments were to be rotated eg in a dimer, the segments.tomove files would be:

1
2

New Terms in GMIN

Two new terms have been included for use with the implicit membrane.

Firstly, the coordinates of the centre of mass of the system before the initial quench can be specified using:

SETCENTRE x y z

Specifying x y z as 0.0, 0.0, 0.0 will set the centre of mass at the origin and hence the centre of the membrane. A protein can be moved out of the membrane by altering the z coordinate.

Secondly, the system can be translated so that the centre-of-mass lies at the origin after every quench, using the keyword CENTRE. At present, CENTRE causes convergence issues as moving back to z=0 actually changes the energy. It is advised that CENTREXY is used instead, moving the protein back to (0,0,z) i.e. preserving the z-coordinate, by using the keyword:

CENTREXY

This solves the convergence problem mentioned above when using CENTRE.

CHARMM keywords

The toppar parameters that should be used are the EEF1.1.inp files. This is done using:

open read unit 11 card name toph19_eef1.1.inp
read rtf card unit 11
close unit 11

open read unit 12 card name param19_eef1.1.inp
read para card unit 12
close unit 12

The charmm keywords are as follows:

eef1 setup membrane slvt water slv2 chex nsmth 10 width 26.0 temp 298.15 -
unit 93 name "/home/jwll2/svn/CHARMM31/toppar/solvpar.1.inp" aemp 0.85
!gouy anfr 0.3 area 70. conc 0.1 offset 3.0 valence 1
update ctonnb 7. ctofnb 9. cutnb 15. group rdie

membrane introduces the membrane model and slvt water and slv2 chex specify that the exterior solvent is water and that the interior solvent is cyclohexane. nsmith, set to 10 as a default, determines how steep the transition is at the interface between interior and exterior. The width of the membrane can be altered by altering the value 26.0. This refers to the width of the membrane in angstroms and usually has a value 25-30. The last keyword aemp, default 0.85, determines the extent of strengthening of electrostatic interactions in the membrane (the smaller, the stronger). This parameter was empirically adjusted to give reasonable membrane insertion energies for model systems.

Uncommenting the commented line and adding a continuation to the line above allows the inclusion of Gouy Chapman theory adjustments to the membrane. This describes the effect of a static surface charge on the membrane potential. anfr describes the molar fraction of anionic lipids (e.g. a 70/30 mixture of PC/PG corresponds to ANFR 0.3, which is the default). area is the area (Angstrom^2) per lipid (default 70) and offset is the distance of the plane of negative charge, usually the phosphates, from the hydrocarbon/water boundary (default 3). conc and valence is the molarity and valence of the salt (default 0.1 and 1, respectively).


Visualising the Membrane in VMD

VMD can be loaded using the command:

module load vmd/1.8.6


To view the membrane in VMD, first create a file called centre.pdb, with the following line of text:

ATOM      1  Ne      1      0.0  0.0  0.0  1.00  0.00      MAIN

This is simply an Ne atom placed at the origin. Also, obtain plotBox.tcl from the Wales Group homepage [2].

Load VMD and any molecules that you wish to visualise, followed by centre.pdb. Then open up the TK console and type:

source <PATH>/plotBox.tcl
plotBox z 30.0 30.0 13.0 0.0

The syntax of this: z refers to the direction of the surface normal of the membrane. 30.0 and 30.0 specify half the length of the membrane in the x and y directions in angstroms and can be increased if necessary. 13.0 describes half of the width of the membrane and 0.0 refers to the separation of the slab layers.

N.B It is important to load centre and input the commands into the console after all the molecules have been loaded. Otherwise the width of the membrane will be scaled by VMD.