Line data Source code
1 : /* +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
2 : Copyright (c) 2013-2023 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 :
23 : #include "core/ActionPilot.h"
24 : #include "core/ActionWithArguments.h"
25 : #include "core/ActionRegister.h"
26 : #include "core/PlumedMain.h"
27 :
28 : namespace PLMD {
29 : namespace generic {
30 :
31 : //+PLUMEDOC PRINTANALYSIS COMMITTOR
32 : /*
33 : Does a committor analysis.
34 :
35 : \par Examples
36 :
37 : The following input monitors two torsional angles during a simulation,
38 : defines two basins (A and B) as a function of the two torsion angles and
39 : stops the simulation when it falls in one of the two. In the log
40 : file will be shown the latest values for the CVs and the basin reached.
41 : \plumedfile
42 : TORSION ATOMS=1,2,3,4 LABEL=r1
43 : TORSION ATOMS=2,3,4,5 LABEL=r2
44 : COMMITTOR ...
45 : ARG=r1,r2
46 : STRIDE=10
47 : BASIN_LL1=0.15,0.20
48 : BASIN_UL1=0.25,0.40
49 : BASIN_LL2=-0.25,-0.40
50 : BASIN_UL2=-0.15,-0.20
51 : ... COMMITTOR
52 : \endplumedfile
53 :
54 : */
55 : //+ENDPLUMEDOC
56 :
57 : class Committor :
58 : public ActionPilot,
59 : public ActionWithArguments {
60 : private:
61 : std::string file;
62 : OFile ofile;
63 : std::string fmt;
64 : std::vector< std::vector<double> > lowerlimits;
65 : std::vector< std::vector<double> > upperlimits;
66 : unsigned nbasins;
67 : unsigned basin;
68 : bool doNotStop;
69 : public:
70 : static void registerKeywords( Keywords& keys );
71 : explicit Committor(const ActionOptions&ao);
72 : void calculate() override;
73 30 : void apply() override {}
74 : };
75 :
76 : PLUMED_REGISTER_ACTION(Committor,"COMMITTOR")
77 :
78 13 : void Committor::registerKeywords( Keywords& keys ) {
79 13 : Action::registerKeywords(keys);
80 13 : ActionPilot::registerKeywords(keys);
81 13 : ActionWithArguments::registerKeywords(keys);
82 13 : keys.use("ARG");
83 26 : keys.add("numbered", "BASIN_LL","List of lower limits for basin #");
84 26 : keys.add("numbered", "BASIN_UL","List of upper limits for basin #");
85 26 : keys.reset_style("BASIN_LL","compulsory");
86 26 : keys.reset_style("BASIN_UL","compulsory");
87 26 : keys.add("compulsory","STRIDE","1","the frequency with which the CVs are analyzed");
88 26 : keys.add("optional","FILE","the name of the file on which to output the reached basin");
89 26 : keys.add("optional","FMT","the format that should be used to output real numbers");
90 26 : keys.addFlag("NOSTOP",false,"if true do not stop the simulation when reaching a basin but just keep track of it");
91 13 : }
92 :
93 9 : Committor::Committor(const ActionOptions&ao):
94 : Action(ao),
95 : ActionPilot(ao),
96 : ActionWithArguments(ao),
97 9 : fmt("%f"),
98 : basin(0),
99 18 : doNotStop(false) {
100 9 : ofile.link(*this);
101 18 : parse("FILE",file);
102 9 : if(file.length()>0) {
103 2 : ofile.open(file);
104 2 : log.printf(" on file %s\n",file.c_str());
105 : } else {
106 7 : log.printf(" on plumed log file\n");
107 7 : ofile.link(log);
108 : }
109 9 : parse("FMT",fmt);
110 9 : fmt=" "+fmt;
111 9 : log.printf(" with format %s\n",fmt.c_str());
112 :
113 13 : for(unsigned b=1;; ++b ) {
114 : std::vector<double> tmpl, tmpu;
115 22 : parseNumberedVector("BASIN_LL", b, tmpl );
116 44 : parseNumberedVector("BASIN_UL", b, tmpu );
117 22 : if( tmpl.empty() && tmpu.empty() ) {
118 : break;
119 : }
120 13 : if( tmpl.size()!=getNumberOfArguments()) {
121 0 : error("Wrong number of values for BASIN_LL: they should be equal to the number of arguments");
122 : }
123 13 : if( tmpu.size()!=getNumberOfArguments()) {
124 0 : error("Wrong number of values for BASIN_UL: they should be equal to the number of arguments");
125 : }
126 13 : lowerlimits.push_back(tmpl);
127 13 : upperlimits.push_back(tmpu);
128 13 : nbasins=b;
129 13 : }
130 :
131 9 : parseFlag("NOSTOP", doNotStop);
132 :
133 9 : checkRead();
134 :
135 :
136 22 : for(unsigned b=0; b<nbasins; b++) {
137 13 : log.printf(" BASIN %u definition:\n", b+1);
138 32 : for(unsigned i=0; i<getNumberOfArguments(); ++i) {
139 19 : if(lowerlimits[b][i]>upperlimits[b][i]) {
140 0 : error("COMMITTOR: UPPER bounds must always be greater than LOWER bounds");
141 : }
142 19 : log.printf(" %f - %f\n", lowerlimits[b][i], upperlimits[b][i]);
143 : }
144 13 : if(doNotStop) {
145 3 : log.printf(" COMMITOR will keep track of the visited basins without stopping the simulations\n");
146 : }
147 : }
148 :
149 20 : for(unsigned i=0; i<getNumberOfArguments(); ++i) {
150 11 : ofile.setupPrintValue( getPntrToArgument(i) );
151 : }
152 9 : }
153 :
154 30 : void Committor::calculate() {
155 : std::vector<unsigned> inbasin;
156 30 : inbasin.assign (nbasins,1);
157 :
158 : // check if current configuration belongs to a basin
159 106 : for(unsigned b=0; b<nbasins; ++b) {
160 221 : for(unsigned i=0; i<getNumberOfArguments(); ++i) {
161 145 : if(getArgument(i)>lowerlimits[b][i]&&getArgument(i)<upperlimits[b][i]) {
162 : inbasin[b]*=1;
163 : } else {
164 80 : inbasin[b]*=0;
165 : }
166 : }
167 : }
168 :
169 : // check in which basin we are if any and if this is the same or a new one
170 : bool inonebasin = false;
171 71 : for(unsigned b=0; b<nbasins; ++b) {
172 61 : if(inbasin[b]==1) {
173 20 : if(basin!=(b+1)) {
174 15 : basin = b+1;
175 15 : ofile.fmtField(" %f");
176 15 : ofile.printField("time",getTime());
177 38 : for(unsigned i=0; i<getNumberOfArguments(); i++) {
178 23 : ofile.fmtField(fmt);
179 23 : ofile.printField( getPntrToArgument(i), getArgument(i) );
180 : }
181 15 : ofile.printField("basin", static_cast<int> (b+1));
182 15 : ofile.printField();
183 : }
184 : inonebasin = true;
185 : break;
186 : }
187 : }
188 : if(!inonebasin) {
189 10 : basin = 0;
190 : }
191 :
192 : // then check if the simulation should be stopped
193 30 : if(inonebasin&&(!doNotStop)) {
194 : std::string num;
195 8 : Tools::convert( basin, num );
196 8 : std::string str = "COMMITTED TO BASIN " + num;
197 8 : ofile.addConstantField(str);
198 8 : ofile.printField();
199 8 : ofile.flush();
200 8 : plumed.stop();
201 : }
202 30 : }
203 :
204 : }
205 : }
|
