Collective Variables Module - Developer Documentation
Loading...
Searching...
No Matches
colvarproxy_namd.h
1// -*- c++ -*-
2
3// This file is part of the Collective Variables module (Colvars).
4// The original version of Colvars and its updates are located at:
5// https://github.com/Colvars/colvars
6// Please update all Colvars source files before making any changes.
7// If you wish to distribute your changes, please submit them to the
8// Colvars repository at GitHub.
9
10#ifndef COLVARPROXY_NAMD_H
11#define COLVARPROXY_NAMD_H
12
13#ifndef NAMD_VERSION_NUMBER
14// Assume 2.14b1 for now until the NAMD macro is merged
15#define NAMD_VERSION_NUMBER 34471681
16#endif
17
18#include "colvarproxy_namd_version.h"
19
20#include "Vector.h"
21#include "ResizeArray.h"
22#include "NamdTypes.h"
23#include "SimParameters.h"
24#include "Lattice.h"
25#include "GlobalMaster.h"
26#include "Random.h"
27#include "ConfigList.h"
28
29#include "colvarmodule.h"
30#include "colvarproxy.h"
31#include "colvarvalue.h"
32
33#define GLOBAL_MASTER_CKLOOP_CALC_ITEM 2000
34#define GLOBAL_MASTER_CKLOOP_CALC_BIASES 2001
35#define GLOBAL_MASTER_CKLOOP_CALC_SCRIPTED_BIASES 2002
36
39class colvarproxy_namd : public colvarproxy, public GlobalMaster {
40
41protected:
42
45 std::vector<int> atoms_map;
46
48 SimParameters *simparams;
49
51 Controller const *controller;
52
54 Random random;
55
56 bool first_timestep;
57 cvm::step_number previous_NAMD_step;
58
60 SubmitReduction *reduction;
61#if defined(NODEGROUP_FORCE_REGISTER) && !defined(NAMD_UNIFIED_REDUCTION)
62 NodeReduction *nodeReduction;
63#endif
64
67 cvm::real amd_weight_factor;
68 void update_accelMD_info();
69
70public:
71
72 void init_tcl_pointers() override;
73
74 friend class cvm::atom;
75
78
79 int setup() override;
80 int reset() override;
81
84
87
88 // synchronize the local arrays with requested or forced atoms
89 int update_atoms_map(AtomIDList::const_iterator begin,
90 AtomIDList::const_iterator end);
91
92 void calculate();
93
94 void log(std::string const &message) override;
95 void error(std::string const &message) override;
96 int set_unit_system(std::string const &units_in, bool check_only) override;
97 void add_energy(cvm::real energy) override;
98 void request_total_force(bool yesno) override;
99
100 bool total_forces_enabled() const override
101 {
103 }
104
105 int run_force_callback() override;
106 int run_colvar_callback(std::string const &name,
107 std::vector<const colvarvalue *> const &cvcs,
108 colvarvalue &value) override;
109 int run_colvar_gradient_callback(std::string const &name,
110 std::vector<const colvarvalue *> const &cvcs,
111 std::vector<cvm::matrix2d<cvm::real> > &gradient) override;
112
114 {
115 return random.gaussian();
116 }
117
118 cvm::real get_accelMD_factor() const override {
119 return amd_weight_factor;
120 }
121
122 bool accelMD_enabled() const override {
123 return accelMDOn;
124 }
125
126#if CMK_SMP && USE_CKLOOP
127 int check_smp_enabled() override;
128
129 int smp_colvars_loop() override;
130
131 int smp_biases_loop();
132
134
135 friend void calc_colvars_items_smp(int first, int last, void *result, int paramNum, void *param);
136 friend void calc_cv_biases_smp(int first, int last, void *result, int paramNum, void *param);
137 friend void calc_cv_scripted_forces(int paramNum, void *param);
138
139 int smp_thread_id()
140 {
141 return CkMyRank();
142 }
143
144 int smp_num_threads()
145 {
146 return CkMyNodeSize();
147 }
148
149protected:
150
151 CmiNodeLock charm_lock_state;
152
153public:
154
155 int smp_lock()
156 {
157 charm_lock_state = CmiCreateLock();
158 return COLVARS_OK;
159 }
160
161 int smp_trylock()
162 {
163 return COLVARS_NOT_IMPLEMENTED;
164 }
165
166 int smp_unlock()
167 {
168 CmiDestroyLock(charm_lock_state);
169 return COLVARS_OK;
170 }
171
172#endif // #if CMK_SMP && USE_CKLOOP
173
175 int replica_index() override;
176 int num_replicas() override;
177 void replica_comm_barrier() override;
178 int replica_comm_recv(char* msg_data, int buf_len, int src_rep) override;
179 int replica_comm_send(char* msg_data, int msg_len, int dest_rep) override;
180
182 int init_atom(int atom_number) override;
183 int check_atom_id(int atom_number) override;
184 int init_atom(cvm::residue_id const &residue,
185 std::string const &atom_name,
186 std::string const &segment_id) override;
187 int check_atom_id(cvm::residue_id const &residue,
188 std::string const &atom_name,
189 std::string const &segment_id) override;
190 void clear_atom(int index) override;
191
192 void update_atom_properties(int index);
193
195 cvm::atom_pos const &pos2) const;
196
197 int load_atoms_pdb(char const *filename,
198 cvm::atom_group &atoms,
199 std::string const &pdb_field,
200 double const pdb_field_value) override;
201
202 int load_coords_pdb(char const *filename,
203 std::vector<cvm::atom_pos> &pos,
204 const std::vector<int> &indices,
205 std::string const &pdb_field,
206 double const pdb_field_value) override;
207
208
209 int scalable_group_coms() override
210 {
211 return COLVARS_OK;
212 }
213 int init_atom_group(std::vector<int> const &atoms_ids) override;
214 void clear_atom_group(int index) override;
215
216 int update_group_properties(int index);
217
218#if NAMD_VERSION_NUMBER >= 34471681
219
221
222 int init_volmap_by_id(int volmap_id) override;
223
224 int init_volmap_by_name(const char *volmap_name) override;
225
226 int check_volmap_by_id(int volmap_id) override;
227
228 int check_volmap_by_name(char const *volmap_name) override;
229
230 int get_volmap_id_from_name(char const *volmap_name) override;
231
232 void clear_volmap(int index) override;
233
234 int compute_volmap(int flags,
235 int volmap_id,
236 cvm::atom_iter atom_begin,
237 cvm::atom_iter atom_end,
238 cvm::real *value,
239 cvm::real *atom_field) override;
240
242 template<class T>
243 void getGridForceGridValue(int flags,
244 T const *grid,
245 cvm::atom_iter atom_begin,
246 cvm::atom_iter atom_end,
247 cvm::real *value,
248 cvm::real *atom_field);
249
251 template<class T, int flags>
252 void GridForceGridLoop(T const *g,
253 cvm::atom_iter atom_begin,
254 cvm::atom_iter atom_end,
255 cvm::real *value,
256 cvm::real *atom_field);
257
258#endif
259
260 std::ostream &output_stream(std::string const &output_name,
261 std::string const description) override;
262
263 int flush_output_stream(std::string const &output_name) override;
264
265 int flush_output_streams() override;
266
267 int close_output_stream(std::string const &output_name) override;
268
269 int close_output_streams() override;
270
271 int backup_file(char const *filename) override;
272
275
278
280 int request_alch_energy_freq(int const freq);
281
283 int get_dE_dlambda(cvm::real* dE_dlambda);
284
285};
286
287
288#endif
Group of atom objects, mostly used by a colvar::cvc object to gather all atomic data.
Definition: colvaratoms.h:159
Stores numeric id, mass and all mutable data for an atom, mostly used by a colvar::cvc.
Definition: colvaratoms.h:31
Arbitrary size array (two dimensions) suitable for linear algebra operations (i.e....
Definition: colvartypes.h:372
vector of real numbers with three components
Definition: colvartypes.h:723
double real
Defining an abstract real number allows to switch precision.
Definition: colvarmodule.h:100
int residue_id
Residue identifier.
Definition: colvarmodule.h:225
long long step_number
Use a 64-bit integer to store the step number.
Definition: colvarmodule.h:97
std::vector< int > atoms_ids
Array of 0-based integers used to uniquely associate atoms within the host program.
Definition: colvarproxy.h:254
Communication between colvars and NAMD (implementation of colvarproxy)
Definition: colvarproxy_namd.h:39
cvm::real get_accelMD_factor() const override
Get weight factor from accelMD.
Definition: colvarproxy_namd.h:118
void init_tcl_pointers() override
Set Tcl pointers.
int request_alch_energy_freq(int const freq)
Request energy computation every freq steps.
int init_volmap_by_id(int volmap_id) override
int check_volmap_by_id(int volmap_id) override
int replica_index() override
Index of this replica.
int init_atom(cvm::residue_id const &residue, std::string const &atom_name, std::string const &segment_id) override
bool total_forces_enabled() const override
Are total forces being used?
Definition: colvarproxy_namd.h:100
Random random
NAMD-style PRNG object.
Definition: colvarproxy_namd.h:54
void clear_atom(int index) override
Used by the atom class destructor: rather than deleting the array slot (costly) set the corresponding...
int init_atom(int atom_number) override
void error(std::string const &message) override
Print a message to the main log and/or let the host code know about it.
int update_target_temperature()
Get the target temperature from the NAMD thermostats supported so far.
int init_volmap_by_name(const char *volmap_name) override
int replica_comm_send(char *msg_data, int msg_len, int dest_rep) override
Send data to other replica.
int send_alch_lambda(void)
Set value of alchemical lambda parameter in back-end.
void add_energy(cvm::real energy) override
Pass restraint energy value for current timestep to MD engine.
void clear_atom_group(int index) override
Used by the atom_group class destructor.
int init_atom_group(std::vector< int > const &atoms_ids) override
Prepare this group for collective variables calculation, selecting atoms by internal ids (0-based)
void getGridForceGridValue(int flags, T const *grid, cvm::atom_iter atom_begin, cvm::atom_iter atom_end, cvm::real *value, cvm::real *atom_field)
Abstraction of the two types of NAMD volumetric maps.
SimParameters * simparams
Pointer to the NAMD simulation input object.
Definition: colvarproxy_namd.h:48
void init_atoms_map()
Allocate an atoms map with the same size as the NAMD topology.
Controller const * controller
Pointer to Controller object.
Definition: colvarproxy_namd.h:51
int load_coords_pdb(char const *filename, std::vector< cvm::atom_pos > &pos, const std::vector< int > &indices, std::string const &pdb_field, double const pdb_field_value) override
Load a set of coordinates from a PDB file.
int setup() override
(Re)initialize required member data (called after the module)
int backup_file(char const *filename) override
Rename the given file, before overwriting it.
int load_atoms_pdb(char const *filename, cvm::atom_group &atoms, std::string const &pdb_field, double const pdb_field_value) override
Read a selection of atom IDs from a PDB coordinate file.
int set_unit_system(std::string const &units_in, bool check_only) override
Request to set the units used internally by Colvars.
int num_replicas() override
Total number of replicas.
int compute_volmap(int flags, int volmap_id, cvm::atom_iter atom_begin, cvm::atom_iter atom_end, cvm::real *value, cvm::real *atom_field) override
int get_volmap_id_from_name(char const *volmap_name) override
Get the numeric ID of the given volumetric map (for the MD program)
int check_atom_id(int atom_number) override
int check_replicas_enabled() override
Indicate if multi-replica support is available and active.
std::ostream & output_stream(std::string const &output_name, std::string const description) override
int close_output_stream(std::string const &output_name) override
Closes the given output file/channel.
int get_dE_dlambda(cvm::real *dE_dlambda)
Get energy derivative with respect to lambda.
int flush_output_streams() override
Flushes all output files/channels.
int check_volmap_by_name(char const *volmap_name) override
int check_volmaps_available() override
Test whether this implementation can use volumetric maps as CVs.
cvm::real rand_gaussian() override
Pseudo-random number with Gaussian distribution.
Definition: colvarproxy_namd.h:113
int scalable_group_coms() override
Whether this proxy implementation has capability for scalable groups.
Definition: colvarproxy_namd.h:209
int run_force_callback() override
Run a user-defined colvar forces script.
void log(std::string const &message) override
Print a message to the main log.
void replica_comm_barrier() override
Synchronize replica with others.
int check_atom_id(cvm::residue_id const &residue, std::string const &atom_name, std::string const &segment_id) override
Check that this atom is valid, but do not initialize it yet.
int reset() override
Reset proxy state, e.g. requested atoms.
bool accelMDOn
Accelerated MD reweighting factor.
Definition: colvarproxy_namd.h:66
SubmitReduction * reduction
Used to submit restraint energy as MISC.
Definition: colvarproxy_namd.h:60
void clear_volmap(int index) override
Used by the CVC destructors.
void request_total_force(bool yesno) override
Tell the proxy whether total forces are needed (they may not always be available)
int flush_output_stream(std::string const &output_name) override
Flushes the given output file/channel.
cvm::rvector position_distance(cvm::atom_pos const &pos1, cvm::atom_pos const &pos2) const
Get the PBC-aware distance vector between two positions.
void GridForceGridLoop(T const *g, cvm::atom_iter atom_begin, cvm::atom_iter atom_end, cvm::real *value, cvm::real *atom_field)
Implementation of inner loop; allows for atom list computation and use.
std::vector< int > atoms_map
Array of atom indices (relative to the colvarproxy arrays), usedfor faster copy of atomic data.
Definition: colvarproxy_namd.h:45
int get_alch_lambda(cvm::real *lambda)
Get value of alchemical lambda parameter from back-end.
int close_output_streams() override
Close all open files/channels to prevent data loss.
int check_atom_name_selections_available() override
Check whether it is possible to select atoms by residue number name.
int replica_comm_recv(char *msg_data, int buf_len, int src_rep) override
Receive data from other replica.
virtual int smp_colvars_loop()
Distribute calculation of colvars (and their components) across threads.
Definition: colvarproxy.cpp:282
virtual int smp_biases_script_loop()
Distribute calculation of biases across threads 2nd through last, with all scripted biased on 1st thr...
Definition: colvarproxy.cpp:329
virtual int smp_thread_id()
Index of this thread.
Definition: colvarproxy.cpp:358
virtual int smp_trylock()
Attempt to lock the proxy's shared data.
Definition: colvarproxy.cpp:387
virtual int smp_lock()
Lock the proxy's shared data for access by a thread, if threads are implemented; if not implemented,...
Definition: colvarproxy.cpp:378
virtual int smp_num_threads()
Number of threads sharing this address space.
Definition: colvarproxy.cpp:368
virtual int check_smp_enabled()
Whether threaded parallelization is available (TODO: make this a cvm::deps feature)
Definition: colvarproxy.cpp:269
virtual int smp_unlock()
Release the lock.
Definition: colvarproxy.cpp:397
virtual int smp_biases_loop()
Distribute calculation of biases across threads.
Definition: colvarproxy.cpp:306
bool total_force_requested
Whether the total forces have been requested.
Definition: colvarproxy_system.h:168
Definition: colvarproxy.h:542
Value of a collective variable: this is a metatype which can be set at runtime. By default it is set ...
Definition: colvarvalue.h:43
Collective variables main module.
Colvars proxy classes.