| 1 |
Lipid membrane vesicle with membrane protein inclusions |
| 2 |
==================== |
| 3 |
This example shows how to build a spherical vesicle made from DPPC lipids and 120 trans-membrane protein inclusions. The coordinates for the ingredients of the vesicle are generated by PACKMOL (a 3rd-party tool). This is a slow example because PACKMOL has difficulty packing molecules uniformly on a surface. Several simulations are necessary to close holes in the membrane created by PACKMOL. |
| 4 |
|
| 5 |
### Images |
| 6 |
|
| 7 |
<img src="images/DPPC.jpg" height=100> <img src="images/plus.svg" height=80> <img src="images/4HelixBundle_LR.jpg" height=130> <img src="images/rightarrow.svg" height=80> |
| 8 |
<img src="images/vesicle_membrane+protein_LR.jpg" width=400> |
| 9 |
|
| 10 |
|
| 11 |
### Prerequisites |
| 12 |
|
| 13 |
1) This example requires PACKMOL. You can download PACKMOL [here](http://www.ime.unicamp.br/~martinez/packmol/) (Moltemplate does not come with an easy way to generate spherically-symmetric structures, so I used the PACKMOL program to move the lipids into position.) |
| 14 |
|
| 15 |
2) This example requires custom features to be added to LAMMPS, which usually require LAMMPS to be compiled from source code. If you encounter the error *"Invalid pair_style"*, then you must add these features to LAMMPS. To do that: |
| 16 |
a) Download the LAMMPS source code (if you have not yet done so), either from https://lammps.sandia.gov/download.html, or using *"git clone https://github.com/lammps/lammps ~/lammps_src"* |
| 17 |
b) download the "additional_lammps_code" from http://moltemplate.org (upper-left corner menu) |
| 18 |
c) unpack it |
| 19 |
d) copy the .cpp and .h files to the src folding of your lammps installation. |
| 20 |
e) (re)compile LAMMPS. |
| 21 |
|
| 22 |
3) This example uses "dihedral_style fourier" which requires a version of LAMMPS compiled with support for the optional "EXTRA-MOLECULE" package. If you encounter the error *"Invalid dihedral_style"*, then see [this page](https://docs.lammps.org/Build_package.html) for instructions to compile LAMMPS to support this package. |
| 23 |
|
| 24 |
|
| 25 |
### Instructions |
| 26 |
|
| 27 |
More detailed instructions on how to build LAMMPS input files and run a short simulation are provided in other README files. |
| 28 |
|
| 29 |
1) To build the files which LAMMPS needs, follow the instructions in: |
| 30 |
[README_setup.sh](README_setup.sh) |
| 31 |
|
| 32 |
2) To run LAMMPS with these files, follow these instructions: |
| 33 |
[README_run.sh](README_run.sh) |
| 34 |
|
| 35 |
|
| 36 |
### Details |
| 37 |
|
| 38 |
This example contains a coarse-grained model of a 4-helix bundle protein inserted into a lipid bilayer (made from a mixture of DPPC and DLPC). |
| 39 |
|
| 40 |
|
| 41 |
#### Protein Model |
| 42 |
|
| 43 |
The coarse-grained protein is described in: |
| 44 |
G. Bellesia, AI Jewett, and J-E Shea, Protein Science, Vol19 141-154 (2010) |
| 45 |
Here we use the "AUF2" model described in that paper. (In the paper, the protein is soluble and the hydrophobic beads face inwards. In this simulation, the protein is embedded in a lipid bilayer and the hydrophobic beads face outwards towards the lipids.) |
| 46 |
|
| 47 |
|
| 48 |
#### Memebrane Model |
| 49 |
|
| 50 |
The DPPC lipid bilayer is described in: |
| 51 |
1) G. Brannigan, P.F. Philips, and F.L.H. Brown, Physical Review E, Vol 72, 011915 (2005) |
| 52 |
2) M.C. Watson, E.S. Penev, P.M. Welch, and F.L.H. Brown, J. Chem. Phys. 135, 244701 (2011) |
| 53 |
|
| 54 |
As in Watson(JCP 2011), rigid bond-length constraints, have been replaced by harmonic bonds. |
| 55 |
|
| 56 |
|
| 57 |
--- Building the files necessary to run a simulation in LAMMPS --- |
| 58 |
|
| 59 |
step 1) Run PACKMOL |
| 60 |
|
| 61 |
Type these commands into the shell. |
| 62 |
(Each command could take several hours.) |
| 63 |
|
| 64 |
cd packmol_files |
| 65 |
packmol < step1_proteins.inp # This step determines the protein's location |
| 66 |
packmol < step2_innerlayer.inp # this step builds the inner monolayer |
| 67 |
packmol < step3_outerlayer.inp # this step builds the outer monolayer |
| 68 |
cd .. |
| 69 |
|
| 70 |
step 2) Run MOLTEMPLATE |
| 71 |
Type these commands into the shell. |
| 72 |
(This could take up to 10 minutes.) |
| 73 |
|
| 74 |
cd moltemplate_files |
| 75 |
moltemplate.sh system.lt -xyz ../system.xyz |
| 76 |
mv -f system.in* system.data ../ |
| 77 |
cp -f table_int.dat ../ |
| 78 |
cd .. |
| 79 |
|
| 80 |
--- Running LAMMPS --- |
| 81 |
|
| 82 |
step3) Run LAMMPS: |
| 83 |
Type these commands into the shell. |
| 84 |
(This could take days.) |
| 85 |
|
| 86 |
lmp_mpi -i run.in.min # Minimize the system (important, and very slow) |
| 87 |
lmp_mpi -i run.in.make_uniform |
| 88 |
lmp_mpi -i run_T=360K.in # Run a simulation at constant tmperature |
| 89 |
|
| 90 |
If you have compiled the MPI version of lammps, you can run lammps in parallel: |
| 91 |
|
| 92 |
mpiexec -np 4 lmp_mpi -i run.in.min |
| 93 |
mpiexec -np 4 lmp_mpi -i run.in.make_uniform |
| 94 |
mpiexec -np 4 lmp_mpi -i run.in_T=360K |
| 95 |
|
| 96 |
(Assuming you have 4 cores, for example.) |