Collective Variables Module - Developer Documentation
Loading...
Searching...
No Matches
colvarproxy_lammps.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_LAMMPS_H
11#define COLVARPROXY_LAMMPS_H
12
13#include "colvarproxy_lammps_version.h" // IWYU pragma: export
14
15#include "colvarmodule.h"
16#include "colvarproxy.h"
17#include "colvartypes.h"
18
19#include "domain.h" // IWYU pragma: keep
20#include "force.h" // IWYU pragma: keep
21#include "lammps.h" // IWYU pragma: keep
22#include "random_park.h"
23#include "update.h" // IWYU pragma: keep
24
28
29 // LAMMPS specific data objects and flags
30 protected:
31 // pointers to LAMMPS class instances
32 LAMMPS_NS::LAMMPS *_lmp;
33 LAMMPS_NS::RanPark *_random;
34
35 // state of LAMMPS properties
36 double bias_energy;
37 cvm::step_number previous_step;
38
39 bool first_timestep;
40 bool do_exit;
41
42 std::vector<int> atoms_types;
43
44 public:
45 friend class cvm::atom;
46
47 colvarproxy_lammps(LAMMPS_NS::LAMMPS *lmp);
48
49 ~colvarproxy_lammps() override;
50
51 void init();
52
54 void set_random_seed(int seed);
55
56 int setup() override;
57
58 // disable default and copy constructor
59 private:
62
63 // methods for lammps to move data or trigger actions in the proxy
64 public:
65
66 bool total_forces_enabled() const override { return total_force_requested; };
67 bool total_forces_same_step() const override { return true; };
68 bool want_exit() const { return do_exit; };
69
70 // perform colvars computation. returns biasing energy
71 double compute();
72
73 // Request to set the units used internally by Colvars
74 int set_unit_system(std::string const &units_in, bool check_only) override;
75
77 char const *script_obj_to_str(unsigned char *obj);
78
80 std::vector<std::string> script_obj_to_str_vector(unsigned char *obj);
81
82 void add_energy(cvm::real energy) override { bias_energy += energy; };
83 void request_total_force(bool yesno) override { total_force_requested = yesno; };
84
85 void log(std::string const &message) override;
86 void error(std::string const &message) override;
87
88 cvm::rvector position_distance(cvm::atom_pos const &pos1, cvm::atom_pos const &pos2) const override;
89
90 cvm::real rand_gaussian(void) override { return _random->gaussian(); };
91
92 int init_atom(int atom_number) override;
93 int check_atom_id(int atom_number) override;
94
95 inline std::vector<int> *modify_atom_types() { return &atoms_types; }
96};
97
98#endif
Stores numeric id, mass and all mutable data for an atom, mostly used by a colvar::cvc.
Definition: colvaratoms.h:31
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
long long step_number
Use a 64-bit integer to store the step number.
Definition: colvarmodule.h:92
Communication between colvars and LAMMPS (implementation of colvarproxy)
Definition: colvarproxy_lammps.h:27
void request_total_force(bool yesno) override
Tell the proxy whether total forces are needed (they may not always be available)
Definition: colvarproxy_lammps.h:83
cvm::real rand_gaussian(void) override
Pseudo-random number with Gaussian distribution.
Definition: colvarproxy_lammps.h:90
int init_atom(int atom_number) override
Definition: colvarproxy_lammps.cpp:269
int setup() override
(Re)initialize required member data (called after the module)
Definition: colvarproxy_lammps.cpp:92
cvm::rvector position_distance(cvm::atom_pos const &pos1, cvm::atom_pos const &pos2) const override
Get the PBC-aware distance vector between two positions.
Definition: colvarproxy_lammps.cpp:187
void set_random_seed(int seed)
Set the internal seed used by rand_gaussian().
Definition: colvarproxy_lammps.cpp:82
bool total_forces_enabled() const override
Are total forces being used?
Definition: colvarproxy_lammps.h:66
std::vector< std::string > script_obj_to_str_vector(unsigned char *obj)
Convert a command-line argument to a vector of strings.
Definition: colvarproxy_lammps.cpp:227
int set_unit_system(std::string const &units_in, bool check_only) override
Request to set the units used internally by Colvars.
Definition: colvarproxy_lammps.cpp:238
void add_energy(cvm::real energy) override
Pass restraint energy value for current timestep to MD engine.
Definition: colvarproxy_lammps.h:82
void error(std::string const &message) override
Print a message to the main log and/or let the host code know about it.
Definition: colvarproxy_lammps.cpp:212
int check_atom_id(int atom_number) override
Definition: colvarproxy_lammps.cpp:250
bool total_forces_same_step() const override
Are total forces from the current step available?
Definition: colvarproxy_lammps.h:67
char const * script_obj_to_str(unsigned char *obj)
Convert a command-line argument to string.
Definition: colvarproxy_lammps.cpp:220
void log(std::string const &message) override
Print a message to the main log.
Definition: colvarproxy_lammps.cpp:199
bool total_force_requested
Whether the total forces have been requested.
Definition: colvarproxy_system.h:162
Definition: colvarproxy.h:542
Collective variables main module.
Colvars proxy classes.