Skip to content

Commit 9bdd0ab

Browse files
authored
Add files via upload
1 parent 50c001f commit 9bdd0ab

1 file changed

Lines changed: 14 additions & 1 deletion

File tree

doc/applied_efp.rst

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,16 +24,19 @@ calculation like the one this walthrough will details.
2424

2525
.. image:: ../images/FMO_trimer_BCLs.bmp
2626
:width: 350
27+
:align: center
2728

2829
.. image:: ../images/FMO_mon.bmp
2930
:width: 400
31+
:align: center
3032

3133
The general procedure is to define the QM and EFP regions, fragment the residues in the
3234
EFP region, generate the starting fragment parameters, trim overlapping virtual/real atoms,
3335
then create the final calculation input.
3436

3537
.. image:: ../images/flowchart-1.png
3638
:width: 500
39+
:align: center
3740

3841
You will need a structure file (.g96), a topology file (.top), and a binary input from molecular dynamics (.tpr). A structure file can be extracted
3942
from a GROMACS molecular dynamics trajectory. In this example, water molecules more than 15 angstroms from the protein's surface have
@@ -44,6 +47,7 @@ and will be the QM region for the EFP calcuation.
4447

4548
.. image:: ../images/fmo_waters15a.bmp
4649
:width: 400
50+
:align: center
4751

4852
Structure Preparation
4953
=====================
@@ -57,13 +61,15 @@ The headring surrounded by the EFP region looks like this:
5761

5862
.. image:: ../images/tester.bmp
5963
:width: 400
64+
:align: center
6065

6166
As you can see, the solvatochromic environment of each BChl is an overwhelming ensemble. The mission of EFP is to break this
6267
complex environment into each contributing "fragment." Then, those fragments can be analyzed by individual contribution.
6368
The final calculation allows us to look at a focused version of the environment like the image below:
6469

6570
.. image:: ../images/surf_efp2.bmp
6671
:width: 400
72+
:align: center
6773

6874
Each fragment induces a shift to the BChl excited state energy. Pairwise excitation energy decomposition reveals the magnitude and
6975
direction (ie, blue or red shift) that each fragment induces to a given BChl molecule. Thus, EFP can offer deeper insight into the
@@ -87,6 +93,7 @@ Here is a visualization of atoms contained in the newly created index group:
8793

8894
.. image:: ../images/361_headring.bmp
8995
:width: 400
96+
:align: center
9097

9198
Note: the QM region will include the entire BChl, but the EFP region will be defined by distance to this ring group
9299
only.
@@ -109,20 +116,23 @@ BCL magnesium atom shown below.
109116

110117
.. image:: ../images/qm_region.bmp
111118
:width: 400
119+
:align: center
112120

113121
This shows the entire residue 361 (BCL) and 290 (HIS), however, we only want to include the side chain of this histidine.
114122
In other words, atoms that extend down the side chain after the alpha-carbon should be included in the QM region, and the
115123
backbone atoms should remain in the EFP region. That division looks like this:
116124

117125
.. image:: ../images/qm_w_cut.bmp
118126
:width: 400
127+
:align: center
119128

120129
This is a tricky problem. To generate the fragment parameters, we will need an input file with every atom in the
121130
amino acid. After we have obtained an efp file with the full fragment's parameters, the QM atoms will be stripped out.
122131
Now, this creates a second issue. The QM region must be capped with a virtual hydrogen, so the result looks like this:
123132

124133
.. image:: ../images/qm_capped.bmp
125134
:width: 400
135+
:align: center
126136

127137
There will be a virtual hydrogen resting in roughly the same position as the the alpha-carbon (that is in the EFP region, NOT
128138
the QM region). When the efp parameter file for residue 290 is created later, the QM atoms and the alpha-carbon will be stripped,
@@ -151,11 +161,13 @@ PDB residues are divided like this:
151161

152162
.. image:: ../images/pdb_67_col.bmp
153163
:width: 400
164+
:align: center
154165

155166
For EFP, we would rather these two fragments look like this:
156167

157168
.. image:: ../images/efp_67_col.bmp
158169
:width: 400
170+
:align: center
159171

160172
The atom coordinates are contained in the structure file, but they do not completely 'agree' with the amino
161173
acid numbering. Below is a snippet from the structure file (.g96) with the EFP fragment 8 highlighted. Note that atom
@@ -197,6 +209,7 @@ molecule input files made from make_AA.py). Below is the division of the head an
197209

198210
.. image:: ../images/efp_headtail.bmp
199211
:width: 400
212+
:align: center
200213

201214
The script ``make_bchls.py`` creates two fragment input files for each Bchl molecule according to that division. Virtual
202215
hydrogens are added where the two are normally covalently bound, much like the case for the amino acid backbone bonds. The
@@ -285,4 +298,4 @@ Time-Saving Tips
285298
In the case of FMO, the normal procedure is to repeat the EFP calculation for eight different BChl pigments. Fragments
286299
can be reused between calculations if they come from the same snapshot. ie, bchl360-79002.g96 will need a handful of new
287300
fragments than those created already for bchl361-79002, but the majority of EFP fragments are already made. This can save
288-
a lot of time in repeated calculations.
301+
a lot of time in repeated calculations.

0 commit comments

Comments
 (0)