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
28#include "colvarmodule.h"
29#include "colvarproxy.h"
30#include "colvarvalue.h"
31
32#define GLOBAL_MASTER_CKLOOP_CALC_ITEM 2000
33#define GLOBAL_MASTER_CKLOOP_CALC_BIASES 2001
34#define GLOBAL_MASTER_CKLOOP_CALC_SCRIPTED_BIASES 2002
35
38class colvarproxy_namd : public colvarproxy, public GlobalMaster {
39
40protected:
41
44 std::vector<int> atoms_map;
45
47 SimParameters *simparams;
48
50 Controller const *controller;
51
53 Random random;
54
55 bool first_timestep;
56 cvm::step_number previous_NAMD_step;
57
59 SubmitReduction *reduction;
60#ifdef NODEGROUP_FORCE_REGISTER
61 NodeReduction *nodeReduction;
62#endif
63
66 cvm::real amd_weight_factor;
67 void update_accelMD_info();
68
69public:
70
71 void init_tcl_pointers() override;
72
73 friend class cvm::atom;
74
77
78 int setup() override;
79 int reset() override;
80
83
86
87 // synchronize the local arrays with requested or forced atoms
88 int update_atoms_map(AtomIDList::const_iterator begin,
89 AtomIDList::const_iterator end);
90
91 void calculate();
92
93 void log(std::string const &message) override;
94 void error(std::string const &message) override;
95 int set_unit_system(std::string const &units_in, bool check_only) override;
96 void add_energy(cvm::real energy) override;
97 void request_total_force(bool yesno) override;
98
99 bool total_forces_enabled() const override
100 {
102 }
103
104 int run_force_callback() override;
105 int run_colvar_callback(std::string const &name,
106 std::vector<const colvarvalue *> const &cvcs,
107 colvarvalue &value) override;
108 int run_colvar_gradient_callback(std::string const &name,
109 std::vector<const colvarvalue *> const &cvcs,
110 std::vector<cvm::matrix2d<cvm::real> > &gradient) override;
111
113 {
114 return random.gaussian();
115 }
116
117 cvm::real get_accelMD_factor() const override {
118 return amd_weight_factor;
119 }
120
121 bool accelMD_enabled() const override {
122 return accelMDOn;
123 }
124
125#if CMK_SMP && USE_CKLOOP
126 int check_smp_enabled() override;
127
128 int smp_colvars_loop() override;
129
130 int smp_biases_loop();
131
133
134 friend void calc_colvars_items_smp(int first, int last, void *result, int paramNum, void *param);
135 friend void calc_cv_biases_smp(int first, int last, void *result, int paramNum, void *param);
136 friend void calc_cv_scripted_forces(int paramNum, void *param);
137
138 int smp_thread_id()
139 {
140 return CkMyRank();
141 }
142
143 int smp_num_threads()
144 {
145 return CkMyNodeSize();
146 }
147
148protected:
149
150 CmiNodeLock charm_lock_state;
151
152public:
153
154 int smp_lock()
155 {
156 charm_lock_state = CmiCreateLock();
157 return COLVARS_OK;
158 }
159
160 int smp_trylock()
161 {
162 return COLVARS_NOT_IMPLEMENTED;
163 }
164
165 int smp_unlock()
166 {
167 CmiDestroyLock(charm_lock_state);
168 return COLVARS_OK;
169 }
170
171#endif // #if CMK_SMP && USE_CKLOOP
172
174 int replica_index() override;
175 int num_replicas() override;
176 void replica_comm_barrier() override;
177 int replica_comm_recv(char* msg_data, int buf_len, int src_rep) override;
178 int replica_comm_send(char* msg_data, int msg_len, int dest_rep) override;
179
181 int init_atom(int atom_number) override;
182 int check_atom_id(int atom_number) override;
183 int init_atom(cvm::residue_id const &residue,
184 std::string const &atom_name,
185 std::string const &segment_id) override;
186 int check_atom_id(cvm::residue_id const &residue,
187 std::string const &atom_name,
188 std::string const &segment_id) override;
189 void clear_atom(int index) override;
190
191 void update_atom_properties(int index);
192
194 cvm::atom_pos const &pos2) const;
195
196 int load_atoms_pdb(char const *filename,
197 cvm::atom_group &atoms,
198 std::string const &pdb_field,
199 double const pdb_field_value) override;
200
201 int load_coords_pdb(char const *filename,
202 std::vector<cvm::atom_pos> &pos,
203 const std::vector<int> &indices,
204 std::string const &pdb_field,
205 double const pdb_field_value) override;
206
207
208 int scalable_group_coms() override
209 {
210 return COLVARS_OK;
211 }
212 int init_atom_group(std::vector<int> const &atoms_ids) override;
213 void clear_atom_group(int index) override;
214
215 int update_group_properties(int index);
216
217#if NAMD_VERSION_NUMBER >= 34471681
218
220
221 int init_volmap_by_id(int volmap_id) override;
222
223 int init_volmap_by_name(const char *volmap_name) override;
224
225 int check_volmap_by_id(int volmap_id) override;
226
227 int check_volmap_by_name(char const *volmap_name) override;
228
229 int get_volmap_id_from_name(char const *volmap_name) override;
230
231 void clear_volmap(int index) override;
232
233 int compute_volmap(int flags,
234 int volmap_id,
235 cvm::atom_iter atom_begin,
236 cvm::atom_iter atom_end,
237 cvm::real *value,
238 cvm::real *atom_field) override;
239
241 template<class T>
242 void getGridForceGridValue(int flags,
243 T const *grid,
244 cvm::atom_iter atom_begin,
245 cvm::atom_iter atom_end,
246 cvm::real *value,
247 cvm::real *atom_field);
248
250 template<class T, int flags>
251 void GridForceGridLoop(T const *g,
252 cvm::atom_iter atom_begin,
253 cvm::atom_iter atom_end,
254 cvm::real *value,
255 cvm::real *atom_field);
256
257#endif
258
259 std::ostream &output_stream(std::string const &output_name,
260 std::string const description) override;
261
262 int flush_output_stream(std::string const &output_name) override;
263
264 int flush_output_streams() override;
265
266 int close_output_stream(std::string const &output_name) override;
267
268 int close_output_streams() override;
269
270 int backup_file(char const *filename) override;
271
274
277
279 int request_alch_energy_freq(int const freq);
280
282 int get_dE_dlambda(cvm::real* dE_dlambda);
283
284};
285
286
287#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:376
vector of real numbers with three components
Definition: colvartypes.h:727
double real
Defining an abstract real number allows to switch precision.
Definition: colvarmodule.h:95
int residue_id
Residue identifier.
Definition: colvarmodule.h:193
long long step_number
Use a 64-bit integer to store the step number.
Definition: colvarmodule.h:92
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:38
cvm::real get_accelMD_factor() const override
Get weight factor from accelMD.
Definition: colvarproxy_namd.h:117
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:99
Random random
NAMD-style PRNG object.
Definition: colvarproxy_namd.h:53
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:47
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:50
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:112
int scalable_group_coms() override
Whether this proxy implementation has capability for scalable groups.
Definition: colvarproxy_namd.h:208
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:65
SubmitReduction * reduction
Used to submit restraint energy as MISC.
Definition: colvarproxy_namd.h:59
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:44
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.