ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/OpenMD/trunk/src/primitives/Molecule.hpp
Revision: 1908
Committed: Fri Jul 19 21:25:45 2013 UTC (11 years, 9 months ago) by gezelter
File size: 13069 byte(s)
Log Message:
Added infrastructure for region-constrained fluctuating charges.

File Contents

# User Rev Content
1 gezelter 507 /*
2 gezelter 246 * Copyright (c) 2005 The University of Notre Dame. All Rights Reserved.
3     *
4     * The University of Notre Dame grants you ("Licensee") a
5     * non-exclusive, royalty free, license to use, modify and
6     * redistribute this software in source and binary code form, provided
7     * that the following conditions are met:
8     *
9 gezelter 1390 * 1. Redistributions of source code must retain the above copyright
10 gezelter 246 * notice, this list of conditions and the following disclaimer.
11     *
12 gezelter 1390 * 2. Redistributions in binary form must reproduce the above copyright
13 gezelter 246 * notice, this list of conditions and the following disclaimer in the
14     * documentation and/or other materials provided with the
15     * distribution.
16     *
17     * This software is provided "AS IS," without a warranty of any
18     * kind. All express or implied conditions, representations and
19     * warranties, including any implied warranty of merchantability,
20     * fitness for a particular purpose or non-infringement, are hereby
21     * excluded. The University of Notre Dame and its licensors shall not
22     * be liable for any damages suffered by licensee as a result of
23     * using, modifying or distributing the software or its
24     * derivatives. In no event will the University of Notre Dame or its
25     * licensors be liable for any lost revenue, profit or data, or for
26     * direct, indirect, special, consequential, incidental or punitive
27     * damages, however caused and regardless of the theory of liability,
28     * arising out of the use of or inability to use software, even if the
29     * University of Notre Dame has been advised of the possibility of
30     * such damages.
31 gezelter 1390 *
32     * SUPPORT OPEN SCIENCE! If you use OpenMD or its source code in your
33     * research, please cite the appropriate papers when you publish your
34     * work. Good starting points are:
35     *
36     * [1] Meineke, et al., J. Comp. Chem. 26, 252-271 (2005).
37     * [2] Fennell & Gezelter, J. Chem. Phys. 124, 234104 (2006).
38 gezelter 1879 * [3] Sun, Lin & Gezelter, J. Chem. Phys. 128, 234107 (2008).
39 gezelter 1782 * [4] Kuang & Gezelter, J. Chem. Phys. 133, 164101 (2010).
40     * [5] Vardeman, Stocker & Gezelter, J. Chem. Theory Comput. 7, 834 (2011).
41 gezelter 246 */
42    
43     /**
44     * @file Molecule.hpp
45     * @author tlin
46     * @date 10/25/2004
47     * @version 1.0
48     */
49 gezelter 2
50 gezelter 246 #ifndef PRIMITIVES_MOLECULE_HPP
51     #define PRIMITIVES_MOLECULE_HPP
52 gezelter 2 #include <vector>
53 gezelter 246 #include <iostream>
54 gezelter 2
55 gezelter 246 #include "constraints/ConstraintPair.hpp"
56     #include "math/Vector3.hpp"
57 tim 3 #include "primitives/Atom.hpp"
58     #include "primitives/RigidBody.hpp"
59 gezelter 246 #include "primitives/Bond.hpp"
60     #include "primitives/Bend.hpp"
61     #include "primitives/Torsion.hpp"
62 cli2 1275 #include "primitives/Inversion.hpp"
63 tim 3 #include "primitives/CutoffGroup.hpp"
64 cli2 1360 #include "utils/PropertyMap.hpp"
65 gezelter 2
66 gezelter 1390 namespace OpenMD{
67 gezelter 2
68 gezelter 507 class Constraint;
69 gezelter 2
70 gezelter 507 /**
71     * @class Molecule Molecule.hpp "primitives/Molecule.hpp"
72     * @brief
73     */
74     class Molecule {
75     public:
76 gezelter 2
77 gezelter 507 typedef std::vector<Atom*>::iterator AtomIterator;
78     typedef std::vector<Bond*>::iterator BondIterator;
79     typedef std::vector<Bend*>::iterator BendIterator;
80     typedef std::vector<Torsion*>::iterator TorsionIterator;
81 cli2 1275 typedef std::vector<Inversion*>::iterator InversionIterator;
82 gezelter 507 typedef std::vector<RigidBody*>::iterator RigidBodyIterator;
83     typedef std::vector<CutoffGroup*>::iterator CutoffGroupIterator;
84 gezelter 1211 typedef std::vector<StuntDouble*>::iterator IntegrableObjectIterator;
85 gezelter 507 typedef std::vector<ConstraintPair*>::iterator ConstraintPairIterator;
86     typedef std::vector<ConstraintElem*>::iterator ConstraintElemIterator;
87 gezelter 1782 typedef std::vector<Atom*>::iterator FluctuatingChargeIterator;
88 gezelter 1211
89 gezelter 1908 Molecule(int stampId, int globalIndex, const std::string& molName, int region);
90 gezelter 507 virtual ~Molecule();
91 cli2 1407
92 gezelter 507 /**
93     * Returns the global index of this molecule.
94     * @return the global index of this molecule
95     */
96     int getGlobalIndex() {
97     return globalIndex_;
98     }
99 gezelter 1211
100 gezelter 507 /**
101     * Returns the stamp id of this molecule
102 gezelter 1211 * @note Ideally, every molecule should keep a pointer of its
103     * molecule stamp instead of its stamp id. However, the pointer
104     * will become invalid, if the molecule migrate to other
105     * processor.
106 gezelter 507 */
107     int getStampId() {
108     return stampId_;
109     }
110 gezelter 1908 int getRegion() {
111     return region_;
112     }
113 gezelter 1211
114 gezelter 507 /** Returns the name of the molecule */
115     std::string getType() {
116     return moleculeName_;
117     }
118 gezelter 1211
119 gezelter 507 /**
120     * Sets the global index of this molecule.
121 gezelter 1879 * @param index new global index to be set
122 gezelter 507 */
123     void setGlobalIndex(int index) {
124     globalIndex_ = index;
125     }
126 gezelter 1782
127     void setConstrainTotalCharge(bool ctc) {
128     constrainTotalCharge_ = ctc;
129     }
130 gezelter 1211
131 gezelter 1782 bool constrainTotalCharge() {
132     return constrainTotalCharge_;
133     }
134    
135 gezelter 507 /** add an atom into this molecule */
136     void addAtom(Atom* atom);
137 gezelter 1211
138 gezelter 507 /** add a bond into this molecule */
139     void addBond(Bond* bond);
140 gezelter 1211
141 gezelter 507 /** add a bend into this molecule */
142     void addBend(Bend* bend);
143 gezelter 1211
144 gezelter 507 /** add a torsion into this molecule*/
145     void addTorsion(Torsion* torsion);
146 cli2 1275
147     /** add an improper torsion into this molecule*/
148     void addInversion(Inversion* inversion);
149 gezelter 1211
150 gezelter 507 /** add a rigidbody into this molecule */
151     void addRigidBody(RigidBody *rb);
152 gezelter 1211
153 gezelter 507 /** add a cutoff group into this molecule */
154     void addCutoffGroup(CutoffGroup* cp);
155 gezelter 1211
156 gezelter 507 void addConstraintPair(ConstraintPair* consPair);
157 gezelter 1211
158 gezelter 507 void addConstraintElem(ConstraintElem* consElem);
159 gezelter 1211
160 gezelter 507 /** */
161     void complete();
162 gezelter 1211
163 gezelter 507 /** Returns the total number of atoms in this molecule */
164     unsigned int getNAtoms() {
165     return atoms_.size();
166     }
167 gezelter 1211
168 gezelter 507 /** Returns the total number of bonds in this molecule */
169     unsigned int getNBonds(){
170     return bonds_.size();
171     }
172 gezelter 1211
173 gezelter 507 /** Returns the total number of bends in this molecule */
174     unsigned int getNBends() {
175     return bends_.size();
176     }
177 gezelter 1211
178 gezelter 507 /** Returns the total number of torsions in this molecule */
179     unsigned int getNTorsions() {
180     return torsions_.size();
181     }
182 cli2 1275
183     /** Returns the total number of improper torsions in this molecule */
184     unsigned int getNInversions() {
185     return inversions_.size();
186     }
187 gezelter 1211
188 gezelter 507 /** Returns the total number of rigid bodies in this molecule */
189     unsigned int getNRigidBodies() {
190     return rigidBodies_.size();
191     }
192 gezelter 1211
193 gezelter 507 /** Returns the total number of integrable objects in this molecule */
194     unsigned int getNIntegrableObjects() {
195     return integrableObjects_.size();
196     }
197 gezelter 1211
198 gezelter 507 /** Returns the total number of cutoff groups in this molecule */
199     unsigned int getNCutoffGroups() {
200     return cutoffGroups_.size();
201     }
202 gezelter 1211
203 gezelter 507 /** Returns the total number of constraints in this molecule */
204     unsigned int getNConstraintPairs() {
205     return constraintPairs_.size();
206     }
207 gezelter 1782
208     /** Returns the total number of fluctuating charges in this molecule */
209     unsigned int getNFluctuatingCharges() {
210     return fluctuatingCharges_.size();
211     }
212    
213 gezelter 507 Atom* getAtomAt(unsigned int i) {
214     assert(i < atoms_.size());
215     return atoms_[i];
216     }
217 gezelter 1211
218 gezelter 507 RigidBody* getRigidBodyAt(unsigned int i) {
219     assert(i < rigidBodies_.size());
220     return rigidBodies_[i];
221     }
222 gezelter 1211
223 gezelter 507 Atom* beginAtom(std::vector<Atom*>::iterator& i) {
224     i = atoms_.begin();
225     return (i == atoms_.end()) ? NULL : *i;
226     }
227 gezelter 1211
228 gezelter 507 Atom* nextAtom(std::vector<Atom*>::iterator& i) {
229     ++i;
230     return (i == atoms_.end()) ? NULL : *i;
231     }
232 gezelter 1211
233 gezelter 507 Bond* beginBond(std::vector<Bond*>::iterator& i) {
234     i = bonds_.begin();
235     return (i == bonds_.end()) ? NULL : *i;
236     }
237 gezelter 1211
238 gezelter 507 Bond* nextBond(std::vector<Bond*>::iterator& i) {
239     ++i;
240     return (i == bonds_.end()) ? NULL : *i;
241 gezelter 1211
242 gezelter 507 }
243 gezelter 1211
244 gezelter 507 Bend* beginBend(std::vector<Bend*>::iterator& i) {
245     i = bends_.begin();
246     return (i == bends_.end()) ? NULL : *i;
247     }
248 gezelter 1211
249 gezelter 507 Bend* nextBend(std::vector<Bend*>::iterator& i) {
250     ++i;
251     return (i == bends_.end()) ? NULL : *i;
252     }
253 gezelter 1211
254 gezelter 507 Torsion* beginTorsion(std::vector<Torsion*>::iterator& i) {
255     i = torsions_.begin();
256     return (i == torsions_.end()) ? NULL : *i;
257     }
258 gezelter 1211
259 gezelter 507 Torsion* nextTorsion(std::vector<Torsion*>::iterator& i) {
260     ++i;
261     return (i == torsions_.end()) ? NULL : *i;
262     }
263 cli2 1275
264     Inversion* beginInversion(std::vector<Inversion*>::iterator& i) {
265     i = inversions_.begin();
266     return (i == inversions_.end()) ? NULL : *i;
267     }
268 gezelter 1211
269 cli2 1275 Inversion* nextInversion(std::vector<Inversion*>::iterator& i) {
270     ++i;
271     return (i == inversions_.end()) ? NULL : *i;
272     }
273    
274 gezelter 507 RigidBody* beginRigidBody(std::vector<RigidBody*>::iterator& i) {
275     i = rigidBodies_.begin();
276     return (i == rigidBodies_.end()) ? NULL : *i;
277     }
278 gezelter 1211
279 gezelter 507 RigidBody* nextRigidBody(std::vector<RigidBody*>::iterator& i) {
280     ++i;
281     return (i == rigidBodies_.end()) ? NULL : *i;
282     }
283 gezelter 1211
284 gezelter 507 StuntDouble* beginIntegrableObject(std::vector<StuntDouble*>::iterator& i) {
285     i = integrableObjects_.begin();
286     return (i == integrableObjects_.end()) ? NULL : *i;
287     }
288 gezelter 1211
289 gezelter 507 StuntDouble* nextIntegrableObject(std::vector<StuntDouble*>::iterator& i) {
290     ++i;
291     return (i == integrableObjects_.end()) ? NULL : *i;
292     }
293 gezelter 1211
294 gezelter 507 CutoffGroup* beginCutoffGroup(std::vector<CutoffGroup*>::iterator& i) {
295     i = cutoffGroups_.begin();
296     return (i == cutoffGroups_.end()) ? NULL : *i;
297     }
298 gezelter 246
299 gezelter 1211 CutoffGroup* nextCutoffGroup(std::vector<CutoffGroup*>::iterator& i) {
300 gezelter 507 ++i;
301     return (i == cutoffGroups_.end()) ? NULL : *i;
302     }
303 gezelter 1211
304 gezelter 507 ConstraintPair* beginConstraintPair(std::vector<ConstraintPair*>::iterator& i) {
305     i = constraintPairs_.begin();
306     return (i == constraintPairs_.end()) ? NULL : *i;
307     }
308 gezelter 1211
309 gezelter 507 ConstraintPair* nextConstraintPair(std::vector<ConstraintPair*>::iterator& i) {
310     ++i;
311     return (i == constraintPairs_.end()) ? NULL : *i;
312     }
313 gezelter 1211
314 gezelter 507 ConstraintElem* beginConstraintElem(std::vector<ConstraintElem*>::iterator& i) {
315     i = constraintElems_.begin();
316     return (i == constraintElems_.end()) ? NULL : *i;
317     }
318 gezelter 1211
319 gezelter 507 ConstraintElem* nextConstraintElem(std::vector<ConstraintElem*>::iterator& i) {
320     ++i;
321     return (i == constraintElems_.end()) ? NULL : *i;
322     }
323 gezelter 1782
324     Atom* beginFluctuatingCharge(std::vector<Atom*>::iterator& i) {
325     i = fluctuatingCharges_.begin();
326     return (i == fluctuatingCharges_.end()) ? NULL : *i;
327     }
328    
329     Atom* nextFluctuatingCharge(std::vector<Atom*>::iterator& i) {
330     ++i;
331     return (i == fluctuatingCharges_.end()) ? NULL : *i;
332     }
333    
334 cli2 1360
335 gezelter 1211 /**
336     * Returns the total potential energy of short range interaction
337     * of this molecule
338     */
339 tim 963 RealType getPotential();
340 gezelter 1211
341 gezelter 507 /** get total mass of this molecule */
342 tim 963 RealType getMass();
343 gezelter 1211
344 gezelter 507 /** return the center of mass of this molecule */
345     Vector3d getCom();
346 gezelter 1211
347 gezelter 507 /** Moves the center of this molecule */
348     void moveCom(const Vector3d& delta);
349 gezelter 1211
350 gezelter 507 /** Returns the velocity of center of mass of this molecule */
351     Vector3d getComVel();
352 gezelter 246
353 gezelter 507 std::string getMoleculeName() {
354     return moleculeName_;
355     }
356 tim 289
357 gezelter 507 friend std::ostream& operator <<(std::ostream& o, Molecule& mol);
358 cli2 1360
359     //below functions are just forward functions
360     /**
361     * Adds property into property map
362     * @param genData GenericData to be added into PropertyMap
363     */
364     void addProperty(GenericData* genData);
365    
366     /**
367     * Removes property from PropertyMap by name
368     * @param propName the name of property to be removed
369     */
370     void removeProperty(const std::string& propName);
371    
372     /**
373     * clear all of the properties
374     */
375     void clearProperties();
376    
377     /**
378     * Returns all names of properties
379     * @return all names of properties
380     */
381     std::vector<std::string> getPropertyNames();
382    
383     /**
384     * Returns all of the properties in PropertyMap
385     * @return all of the properties in PropertyMap
386     */
387     std::vector<GenericData*> getProperties();
388    
389     /**
390     * Returns property
391     * @param propName name of property
392     * @return a pointer point to property with propName. If no property named propName
393     * exists, return NULL
394     */
395     GenericData* getPropertyByName(const std::string& propName);
396 gezelter 1211
397 gezelter 507 private:
398 gezelter 1211
399 gezelter 507 int globalIndex_;
400 gezelter 1211
401 gezelter 507 std::vector<Atom*> atoms_;
402     std::vector<Bond*> bonds_;
403     std::vector<Bend*> bends_;
404     std::vector<Torsion*> torsions_;
405 cli2 1275 std::vector<Inversion*> inversions_;
406 gezelter 507 std::vector<RigidBody*> rigidBodies_;
407     std::vector<StuntDouble*> integrableObjects_;
408     std::vector<CutoffGroup*> cutoffGroups_;
409     std::vector<ConstraintPair*> constraintPairs_;
410     std::vector<ConstraintElem*> constraintElems_;
411 gezelter 1782 std::vector<Atom*> fluctuatingCharges_;
412 gezelter 507 int stampId_;
413 gezelter 1908 int region_;
414 gezelter 507 std::string moleculeName_;
415 cli2 1360 PropertyMap properties_;
416 gezelter 1782 bool constrainTotalCharge_;
417 cli2 1360
418 gezelter 507 };
419 gezelter 2
420 gezelter 1390 } //namespace OpenMD
421 gezelter 246 #endif //

Properties

Name Value
svn:keywords Author Id Revision Date