LCOV - code coverage report
Current view: top level - secondarystructure - ParabetaRMSD.cpp (source / functions) Hit Total Coverage
Test: plumed test coverage Lines: 108 111 97.3 %
Date: 2020-11-18 11:20:57 Functions: 9 10 90.0 %

          Line data    Source code
       1             : /* +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
       2             :    Copyright (c) 2012-2019 The plumed team
       3             :    (see the PEOPLE file at the root of the distribution for a list of names)
       4             : 
       5             :    See http://www.plumed.org for more information.
       6             : 
       7             :    This file is part of plumed, version 2.
       8             : 
       9             :    plumed is free software: you can redistribute it and/or modify
      10             :    it under the terms of the GNU Lesser General Public License as published by
      11             :    the Free Software Foundation, either version 3 of the License, or
      12             :    (at your option) any later version.
      13             : 
      14             :    plumed is distributed in the hope that it will be useful,
      15             :    but WITHOUT ANY WARRANTY; without even the implied warranty of
      16             :    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      17             :    GNU Lesser General Public License for more details.
      18             : 
      19             :    You should have received a copy of the GNU Lesser General Public License
      20             :    along with plumed.  If not, see <http://www.gnu.org/licenses/>.
      21             : +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ */
      22             : #include "SecondaryStructureRMSD.h"
      23             : #include "core/ActionRegister.h"
      24             : #include "core/PlumedMain.h"
      25             : #include "core/Atoms.h"
      26             : 
      27             : namespace PLMD {
      28             : namespace secondarystructure {
      29             : 
      30             : //+PLUMEDOC COLVAR PARABETARMSD
      31             : /*
      32             : Probe the parallel beta sheet content of your protein structure.
      33             : 
      34             : Two protein segments containing three continguous residues can form a parallel beta sheet.
      35             : Although if the two segments are part of the same protein chain they must be separated by
      36             : a minimum of 3 residues to make room for the turn. This colvar thus generates the set of
      37             : all possible six residue sections that could conceivably form a parallel beta sheet
      38             : and calculates the RMSD distance between the configuration in which the residues find themselves
      39             : and an idealized parallel beta sheet structure. These distances can be calculated by either
      40             : aligning the instantaneous structure with the reference structure and measuring each
      41             : atomic displacement or by calculating differences between the set of interatomic
      42             : distances in the reference and instantaneous structures.
      43             : 
      44             : This colvar is based on the following reference \cite pietrucci09jctc.  The authors of
      45             : this paper use the set of distances from the parallel beta sheet configurations to measure
      46             : the number of segments whose configuration resembles a parallel beta sheet. This is done by calculating
      47             : the following sum of functions of the rmsd distances:
      48             : 
      49             : \f[
      50             : s = \sum_i \frac{ 1 - \left(\frac{r_i-d_0}{r_0}\right)^n } { 1 - \left(\frac{r_i-d_0}{r_0}\right)^m }
      51             : \f]
      52             : 
      53             : where the sum runs over all possible segments of parallel beta sheet.  By default the
      54             : NN, MM and D_0 parameters are set equal to those used in \cite pietrucci09jctc.  The R_0
      55             : parameter must be set by the user - the value used in \cite pietrucci09jctc was 0.08 nm.
      56             : 
      57             : If you change the function in the above sum you can calculate quantities such as the average
      58             : distance from a structure composed of only parallel beta sheets or the distance between the set of
      59             : residues that is closest to a parallel beta sheet and the reference configuration. To do these sorts of
      60             : calculations you can use the AVERAGE and MIN keywords. In addition you can use the LESS_THAN
      61             : keyword if you would like to change the form of the switching function. If you use any of these
      62             : options you no longer need to specify NN, R_0, MM and D_0.
      63             : 
      64             : Please be aware that for codes like gromacs you must ensure that plumed
      65             : reconstructs the chains involved in your CV when you calculate this CV using
      66             : anthing other than TYPE=DRMSD.  For more details as to how to do this see \ref WHOLEMOLECULES.
      67             : 
      68             : \par Examples
      69             : 
      70             : The following input calculates the number of six residue segments of
      71             : protein that are in an parallel beta sheet configuration.
      72             : 
      73             : \plumedfile
      74             : MOLINFO STRUCTURE=beta.pdb
      75             : pb: PARABETARMSD RESIDUES=all STRANDS_CUTOFF=1
      76             : \endplumedfile
      77             : 
      78             : Here the same is done use RMSD instead of DRMSD
      79             : 
      80             : \plumedfile
      81             : MOLINFO STRUCTURE=helix.pdb
      82             : WHOLEMOLECULES ENTITY0=1-100
      83             : hh: PARABETARMSD RESIDUES=all TYPE=OPTIMAL R_0=0.1  STRANDS_CUTOFF=1
      84             : \endplumedfile
      85             : 
      86             : */
      87             : //+ENDPLUMEDOC
      88             : 
      89          20 : class ParabetaRMSD : public SecondaryStructureRMSD {
      90             : public:
      91             :   static void registerKeywords( Keywords& keys );
      92             :   explicit ParabetaRMSD(const ActionOptions&);
      93             : };
      94             : 
      95        6462 : PLUMED_REGISTER_ACTION(ParabetaRMSD,"PARABETARMSD")
      96             : 
      97          11 : void ParabetaRMSD::registerKeywords( Keywords& keys ) {
      98          11 :   SecondaryStructureRMSD::registerKeywords( keys );
      99          55 :   keys.add("compulsory","STYLE","all","Parallel beta sheets can either form in a single chain or from a pair of chains. If STYLE=all all "
     100             :            "chain configuration with the appropriate geometry are counted.  If STYLE=inter "
     101             :            "only sheet-like configurations involving two chains are counted, while if STYLE=intra "
     102             :            "only sheet-like configurations involving a single chain are counted");
     103          22 :   keys.use("STRANDS_CUTOFF");
     104          11 : }
     105             : 
     106          10 : ParabetaRMSD::ParabetaRMSD(const ActionOptions&ao):
     107             :   Action(ao),
     108          10 :   SecondaryStructureRMSD(ao)
     109             : {
     110             :   // read in the backbone atoms
     111          20 :   std::vector<unsigned> chains; readBackboneAtoms( "protein", chains );
     112             : 
     113             :   bool intra_chain(false), inter_chain(false);
     114          20 :   std::string style; parse("STYLE",style);
     115          10 :   if( style=="all" ) {
     116             :     intra_chain=true; inter_chain=true;
     117           0 :   } else if( style=="inter") {
     118             :     intra_chain=false; inter_chain=true;
     119           0 :   } else if( style=="intra") {
     120             :     intra_chain=true; inter_chain=false;
     121             :   } else {
     122           0 :     error( style + " is not a valid directive for the STYLE keyword");
     123             :   }
     124             : 
     125             :   // Align the atoms based on the positions of these two atoms
     126          10 :   setAtomsFromStrands( 6, 21 );
     127             : 
     128             :   // This constructs all conceivable sections of antibeta sheet in the backbone of the chains
     129          10 :   if( intra_chain ) {
     130          10 :     unsigned nprevious=0; std::vector<unsigned> nlist(30);
     131         509 :     for(unsigned i=0; i<chains.size(); ++i) {
     132         163 :       if( chains[i]<40 ) error("segment of backbone is not long enough to form an antiparallel beta hairpin. Each backbone fragment must contain a minimum of 8 residues");
     133             :       // Loop over all possible triples in each 8 residue segment of protein
     134         163 :       unsigned nres=chains[i]/5;
     135         163 :       if( chains[i]%5!=0 ) error("backbone segment received does not contain a multiple of five residues");
     136         171 :       for(unsigned ires=0; ires<nres-8; ires++) {
     137          14 :         for(unsigned jres=ires+6; jres<nres-2; jres++) {
     138         310 :           for(unsigned k=0; k<15; ++k) {
     139         300 :             nlist[k]=nprevious + ires*5+k;
     140         300 :             nlist[k+15]=nprevious + jres*5+k;
     141             :           }
     142          10 :           addColvar( nlist );
     143             :         }
     144             :       }
     145         163 :       nprevious+=chains[i];
     146             :     }
     147             :   }
     148             :   // This constructs all conceivable sections of antibeta sheet that form between chains
     149          10 :   if( inter_chain ) {
     150          11 :     if( chains.size()==1 && style!="all" ) error("there is only one chain defined so cannot use inter_chain option");
     151          10 :     std::vector<unsigned> nlist(30);
     152         479 :     for(unsigned ichain=1; ichain<chains.size(); ++ichain) {
     153        2907 :       unsigned iprev=0; for(unsigned i=0; i<ichain; ++i) iprev+=chains[i];
     154         153 :       unsigned inres=chains[ichain]/5;
     155         153 :       if( chains[ichain]%5!=0 ) error("backbone segment received does not contain a multiple of five residues");
     156        1989 :       for(unsigned ires=0; ires<inres-2; ++ires) {
     157       17442 :         for(unsigned jchain=0; jchain<ichain; ++jchain) {
     158       96390 :           unsigned jprev=0; for(unsigned i=0; i<jchain; ++i) jprev+=chains[i];
     159       16524 :           unsigned jnres=chains[jchain]/5;
     160        8262 :           if( chains[jchain]%5!=0 ) error("backbone segment received does not contain a multiple of five residues");
     161      107406 :           for(unsigned jres=0; jres<jnres-2; ++jres) {
     162     1536732 :             for(unsigned k=0; k<15; ++k) {
     163     1487160 :               nlist[k]=iprev + ires*5+k;
     164     1487160 :               nlist[k+15]=jprev + jres*5+k;
     165             :             }
     166       49572 :             addColvar( nlist );
     167             :           }
     168             :         }
     169             :       }
     170             :     }
     171             :   }
     172             : 
     173             :   // Build the reference structure ( in angstroms )
     174          10 :   std::vector<Vector> reference(30);
     175          10 :   reference[0]=Vector( 1.244, -4.620, -2.127); // N    i
     176          10 :   reference[1]=Vector(-0.016, -4.500, -1.395); // CA
     177          10 :   reference[2]=Vector( 0.105, -5.089,  0.024); // CB
     178          10 :   reference[3]=Vector(-0.287, -3.000, -1.301); // C
     179          10 :   reference[4]=Vector( 0.550, -2.245, -0.822); // O
     180          10 :   reference[5]=Vector(-1.445, -2.551, -1.779); // N    i+1
     181          10 :   reference[6]=Vector(-1.752, -1.130, -1.677); // CA
     182          10 :   reference[7]=Vector(-2.113, -0.550, -3.059); // CB
     183          10 :   reference[8]=Vector(-2.906, -0.961, -0.689); // C
     184          10 :   reference[9]=Vector(-3.867, -1.738, -0.695); // O
     185          10 :   reference[10]=Vector(-2.774,  0.034,  0.190); // N    i+2
     186          10 :   reference[11]=Vector(-3.788,  0.331,  1.201); // CA
     187          10 :   reference[12]=Vector(-3.188,  0.300,  2.624); // CB
     188          10 :   reference[13]=Vector(-4.294,  1.743,  0.937); // C
     189          10 :   reference[14]=Vector(-3.503,  2.671,  0.821); // O
     190          10 :   reference[15]=Vector( 4.746, -2.363,  0.188); // N    j
     191          10 :   reference[16]=Vector( 3.427, -1.839,  0.545); // CA
     192          10 :   reference[17]=Vector( 3.135, -1.958,  2.074); // CB
     193          10 :   reference[18]=Vector( 3.346, -0.365,  0.181); // C
     194          10 :   reference[19]=Vector( 4.237,  0.412,  0.521); // O
     195          10 :   reference[20]=Vector( 2.261,  0.013, -0.487); // N    j+1
     196          10 :   reference[21]=Vector( 2.024,  1.401, -0.875); // CA
     197          10 :   reference[22]=Vector( 1.489,  1.514, -2.313); // CB
     198          10 :   reference[23]=Vector( 0.914,  1.902,  0.044); // C
     199          10 :   reference[24]=Vector(-0.173,  1.330,  0.052); // O
     200          10 :   reference[25]=Vector( 1.202,  2.940,  0.828); // N    j+2
     201          10 :   reference[26]=Vector( 0.190,  3.507,  1.718); // CA
     202          10 :   reference[27]=Vector( 0.772,  3.801,  3.104); // CB
     203          10 :   reference[28]=Vector(-0.229,  4.791,  1.038); // C
     204          10 :   reference[29]=Vector( 0.523,  5.771,  0.996); // O
     205             :   // Store the secondary structure ( last number makes sure we convert to internal units nm )
     206          10 :   setSecondaryStructure( reference, 0.17/atoms.getUnits().getLength(), 0.1/atoms.getUnits().getLength() );
     207             : 
     208          10 :   reference[0]=Vector(-1.439, -5.122, -1.144); // N    i
     209          10 :   reference[1]=Vector(-0.816, -3.803, -1.013); // CA
     210          10 :   reference[2]=Vector( 0.099, -3.509, -2.206); // CB
     211          10 :   reference[3]=Vector(-1.928, -2.770, -0.952); // C
     212          10 :   reference[4]=Vector(-2.991, -2.970, -1.551); // O
     213          10 :   reference[5]=Vector(-1.698, -1.687, -0.215); // N    i+1
     214          10 :   reference[6]=Vector(-2.681, -0.613, -0.143); // CA
     215          10 :   reference[7]=Vector(-3.323, -0.477,  1.267); // CB
     216          10 :   reference[8]=Vector(-1.984,  0.681, -0.574); // C
     217          10 :   reference[9]=Vector(-0.807,  0.921, -0.273); // O
     218          10 :   reference[10]=Vector(-2.716,  1.492, -1.329); // N    i+2
     219          10 :   reference[11]=Vector(-2.196,  2.731, -1.883); // CA
     220          10 :   reference[12]=Vector(-2.263,  2.692, -3.418); // CB
     221          10 :   reference[13]=Vector(-2.989,  3.949, -1.433); // C
     222          10 :   reference[14]=Vector(-4.214,  3.989, -1.583); // O
     223          10 :   reference[15]=Vector( 2.464, -4.352,  2.149); // N    j
     224          10 :   reference[16]=Vector( 3.078, -3.170,  1.541); // CA
     225          10 :   reference[17]=Vector( 3.398, -3.415,  0.060); // CB
     226          10 :   reference[18]=Vector( 2.080, -2.021,  1.639); // C
     227          10 :   reference[19]=Vector( 0.938, -2.178,  1.225); // O
     228          10 :   reference[20]=Vector( 2.525, -0.886,  2.183); // N    j+1
     229          10 :   reference[21]=Vector( 1.692,  0.303,  2.346); // CA
     230          10 :   reference[22]=Vector( 1.541,  0.665,  3.842); // CB
     231          10 :   reference[23]=Vector( 2.420,  1.410,  1.608); // C
     232          10 :   reference[24]=Vector( 3.567,  1.733,  1.937); // O
     233          10 :   reference[25]=Vector( 1.758,  1.976,  0.600); // N    j+2
     234          10 :   reference[26]=Vector( 2.373,  2.987, -0.238); // CA
     235          10 :   reference[27]=Vector( 2.367,  2.527, -1.720); // CB
     236          10 :   reference[28]=Vector( 1.684,  4.331, -0.148); // C
     237          10 :   reference[29]=Vector( 0.486,  4.430, -0.415); // O
     238             :   // Store the secondary structure ( last number makes sure we convert to internal units nm )
     239          10 :   setSecondaryStructure( reference, 0.17/atoms.getUnits().getLength(), 0.1/atoms.getUnits().getLength() );
     240          10 : }
     241             : 
     242             : }
     243        4839 : }

Generated by: LCOV version 1.13