OpenMM
 All Classes Namespaces Functions Variables Enumerations Enumerator Friends
Context.h
1 #ifndef OPENMM_CONTEXT_H_
2 #define OPENMM_CONTEXT_H_
3 
4 /* -------------------------------------------------------------------------- *
5  * OpenMM *
6  * -------------------------------------------------------------------------- *
7  * This is part of the OpenMM molecular simulation toolkit originating from *
8  * Simbios, the NIH National Center for Physics-Based Simulation of *
9  * Biological Structures at Stanford, funded under the NIH Roadmap for *
10  * Medical Research, grant U54 GM072970. See https://simtk.org. *
11  * *
12  * Portions copyright (c) 2008-2012 Stanford University and the Authors. *
13  * Authors: Peter Eastman *
14  * Contributors: *
15  * *
16  * Permission is hereby granted, free of charge, to any person obtaining a *
17  * copy of this software and associated documentation files (the "Software"), *
18  * to deal in the Software without restriction, including without limitation *
19  * the rights to use, copy, modify, merge, publish, distribute, sublicense, *
20  * and/or sell copies of the Software, and to permit persons to whom the *
21  * Software is furnished to do so, subject to the following conditions: *
22  * *
23  * The above copyright notice and this permission notice shall be included in *
24  * all copies or substantial portions of the Software. *
25  * *
26  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR *
27  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, *
28  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL *
29  * THE AUTHORS, CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, *
30  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR *
31  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE *
32  * USE OR OTHER DEALINGS IN THE SOFTWARE. *
33  * -------------------------------------------------------------------------- */
34 
35 #include "Integrator.h"
36 #include "State.h"
37 #include "System.h"
38 #include <ctime>
39 #include <iosfwd>
40 #include <map>
41 #include <string>
42 #include <vector>
43 #include "internal/windowsExport.h"
44 
45 namespace OpenMM {
46 
47 class ContextImpl;
48 class Vec3;
49 class Platform;
50 
67 class OPENMM_EXPORT Context {
68 public:
75  Context(System& system, Integrator& integrator);
84  Context(System& system, Integrator& integrator, Platform& platform);
94  Context(System& system, Integrator& integrator, Platform& platform, const std::map<std::string, std::string>& properties);
95  ~Context();
99  const System& getSystem() const;
103  System& getSystem();
107  const Integrator& getIntegrator() const;
111  Integrator& getIntegrator();
115  const Platform& getPlatform() const;
119  Platform& getPlatform();
131  State getState(int types, bool enforcePeriodicBox=false, int groups=0xFFFFFFFF) const;
135  void setTime(double time);
144  void setPositions(const std::vector<Vec3>& positions);
151  void setVelocities(const std::vector<Vec3>& velocities);
159  void setVelocitiesToTemperature(double temperature, int randomSeed=time(NULL));
165  double getParameter(const std::string& name);
172  void setParameter(const std::string& name, double value);
184  void setPeriodicBoxVectors(const Vec3& a, const Vec3& b, const Vec3& c);
191  void applyConstraints(double tol);
197  void applyVelocityConstraints(double tol);
204  void computeVirtualSites();
214  void reinitialize();
221  void createCheckpoint(std::ostream& stream);
241  void loadCheckpoint(std::istream& stream);
242 private:
243  friend class Force;
244  friend class Platform;
245  ContextImpl& getImpl();
246  ContextImpl* impl;
247  std::map<std::string, std::string> properties;
248 };
249 
250 } // namespace OpenMM
251 
252 #endif /*OPENMM_CONTEXT_H_*/