Debian Codegraph @

examples/coarse_grained/membrane_examples/membrane+protein_vesicle_Br2005+Be2010/README.md

raw
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.)