ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/OpenMD/branches/development/src/primitives/Molecule.hpp
Revision: 1850
Committed: Wed Feb 20 15:39:39 2013 UTC (12 years, 2 months ago) by gezelter
File size: 12990 byte(s)
Log Message:
Fixed a widespread typo in the license 

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 1850 * [3] Sun, Lin & Gezelter, J. Chem. Phys. 128, 234107 (2008).
39 gezelter 1665 * [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 1715 typedef std::vector<Atom*>::iterator FluctuatingChargeIterator;
88 gezelter 1211
89 gezelter 507 Molecule(int stampId, int globalIndex, const std::string& molName);
90     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 1211
111 gezelter 507 /** Returns the name of the molecule */
112     std::string getType() {
113     return moleculeName_;
114     }
115 gezelter 1211
116 gezelter 507 /**
117     * Sets the global index of this molecule.
118 gezelter 1808 * @param index new global index to be set
119 gezelter 507 */
120     void setGlobalIndex(int index) {
121     globalIndex_ = index;
122     }
123 gezelter 1718
124     void setConstrainTotalCharge(bool ctc) {
125     constrainTotalCharge_ = ctc;
126     }
127 gezelter 1211
128 gezelter 1718 bool constrainTotalCharge() {
129     return constrainTotalCharge_;
130 gezelter 1715 }
131    
132 gezelter 507 /** add an atom into this molecule */
133     void addAtom(Atom* atom);
134 gezelter 1211
135 gezelter 507 /** add a bond into this molecule */
136     void addBond(Bond* bond);
137 gezelter 1211
138 gezelter 507 /** add a bend into this molecule */
139     void addBend(Bend* bend);
140 gezelter 1211
141 gezelter 507 /** add a torsion into this molecule*/
142     void addTorsion(Torsion* torsion);
143 cli2 1275
144     /** add an improper torsion into this molecule*/
145     void addInversion(Inversion* inversion);
146 gezelter 1211
147 gezelter 507 /** add a rigidbody into this molecule */
148     void addRigidBody(RigidBody *rb);
149 gezelter 1211
150 gezelter 507 /** add a cutoff group into this molecule */
151     void addCutoffGroup(CutoffGroup* cp);
152 gezelter 1211
153 gezelter 507 void addConstraintPair(ConstraintPair* consPair);
154 gezelter 1211
155 gezelter 507 void addConstraintElem(ConstraintElem* consElem);
156 gezelter 1211
157 gezelter 507 /** */
158     void complete();
159 gezelter 1211
160 gezelter 507 /** Returns the total number of atoms in this molecule */
161     unsigned int getNAtoms() {
162     return atoms_.size();
163     }
164 gezelter 1211
165 gezelter 507 /** Returns the total number of bonds in this molecule */
166     unsigned int getNBonds(){
167     return bonds_.size();
168     }
169 gezelter 1211
170 gezelter 507 /** Returns the total number of bends in this molecule */
171     unsigned int getNBends() {
172     return bends_.size();
173     }
174 gezelter 1211
175 gezelter 507 /** Returns the total number of torsions in this molecule */
176     unsigned int getNTorsions() {
177     return torsions_.size();
178     }
179 cli2 1275
180     /** Returns the total number of improper torsions in this molecule */
181     unsigned int getNInversions() {
182     return inversions_.size();
183     }
184 gezelter 1211
185 gezelter 507 /** Returns the total number of rigid bodies in this molecule */
186     unsigned int getNRigidBodies() {
187     return rigidBodies_.size();
188     }
189 gezelter 1211
190 gezelter 507 /** Returns the total number of integrable objects in this molecule */
191     unsigned int getNIntegrableObjects() {
192     return integrableObjects_.size();
193     }
194 gezelter 1211
195 gezelter 507 /** Returns the total number of cutoff groups in this molecule */
196     unsigned int getNCutoffGroups() {
197     return cutoffGroups_.size();
198     }
199 gezelter 1211
200 gezelter 507 /** Returns the total number of constraints in this molecule */
201     unsigned int getNConstraintPairs() {
202     return constraintPairs_.size();
203     }
204 gezelter 1715
205     /** Returns the total number of fluctuating charges in this molecule */
206     unsigned int getNFluctuatingCharges() {
207     return fluctuatingCharges_.size();
208     }
209    
210 gezelter 507 Atom* getAtomAt(unsigned int i) {
211     assert(i < atoms_.size());
212     return atoms_[i];
213     }
214 gezelter 1211
215 gezelter 507 RigidBody* getRigidBodyAt(unsigned int i) {
216     assert(i < rigidBodies_.size());
217     return rigidBodies_[i];
218     }
219 gezelter 1211
220 gezelter 507 Atom* beginAtom(std::vector<Atom*>::iterator& i) {
221     i = atoms_.begin();
222     return (i == atoms_.end()) ? NULL : *i;
223     }
224 gezelter 1211
225 gezelter 507 Atom* nextAtom(std::vector<Atom*>::iterator& i) {
226     ++i;
227     return (i == atoms_.end()) ? NULL : *i;
228     }
229 gezelter 1211
230 gezelter 507 Bond* beginBond(std::vector<Bond*>::iterator& i) {
231     i = bonds_.begin();
232     return (i == bonds_.end()) ? NULL : *i;
233     }
234 gezelter 1211
235 gezelter 507 Bond* nextBond(std::vector<Bond*>::iterator& i) {
236     ++i;
237     return (i == bonds_.end()) ? NULL : *i;
238 gezelter 1211
239 gezelter 507 }
240 gezelter 1211
241 gezelter 507 Bend* beginBend(std::vector<Bend*>::iterator& i) {
242     i = bends_.begin();
243     return (i == bends_.end()) ? NULL : *i;
244     }
245 gezelter 1211
246 gezelter 507 Bend* nextBend(std::vector<Bend*>::iterator& i) {
247     ++i;
248     return (i == bends_.end()) ? NULL : *i;
249     }
250 gezelter 1211
251 gezelter 507 Torsion* beginTorsion(std::vector<Torsion*>::iterator& i) {
252     i = torsions_.begin();
253     return (i == torsions_.end()) ? NULL : *i;
254     }
255 gezelter 1211
256 gezelter 507 Torsion* nextTorsion(std::vector<Torsion*>::iterator& i) {
257     ++i;
258     return (i == torsions_.end()) ? NULL : *i;
259     }
260 cli2 1275
261     Inversion* beginInversion(std::vector<Inversion*>::iterator& i) {
262     i = inversions_.begin();
263     return (i == inversions_.end()) ? NULL : *i;
264     }
265 gezelter 1211
266 cli2 1275 Inversion* nextInversion(std::vector<Inversion*>::iterator& i) {
267     ++i;
268     return (i == inversions_.end()) ? NULL : *i;
269     }
270    
271 gezelter 507 RigidBody* beginRigidBody(std::vector<RigidBody*>::iterator& i) {
272     i = rigidBodies_.begin();
273     return (i == rigidBodies_.end()) ? NULL : *i;
274     }
275 gezelter 1211
276 gezelter 507 RigidBody* nextRigidBody(std::vector<RigidBody*>::iterator& i) {
277     ++i;
278     return (i == rigidBodies_.end()) ? NULL : *i;
279     }
280 gezelter 1211
281 gezelter 507 StuntDouble* beginIntegrableObject(std::vector<StuntDouble*>::iterator& i) {
282     i = integrableObjects_.begin();
283     return (i == integrableObjects_.end()) ? NULL : *i;
284     }
285 gezelter 1211
286 gezelter 507 StuntDouble* nextIntegrableObject(std::vector<StuntDouble*>::iterator& i) {
287     ++i;
288     return (i == integrableObjects_.end()) ? NULL : *i;
289     }
290 gezelter 1211
291 gezelter 507 CutoffGroup* beginCutoffGroup(std::vector<CutoffGroup*>::iterator& i) {
292     i = cutoffGroups_.begin();
293     return (i == cutoffGroups_.end()) ? NULL : *i;
294     }
295 gezelter 246
296 gezelter 1211 CutoffGroup* nextCutoffGroup(std::vector<CutoffGroup*>::iterator& i) {
297 gezelter 507 ++i;
298     return (i == cutoffGroups_.end()) ? NULL : *i;
299     }
300 gezelter 1211
301 gezelter 507 ConstraintPair* beginConstraintPair(std::vector<ConstraintPair*>::iterator& i) {
302     i = constraintPairs_.begin();
303     return (i == constraintPairs_.end()) ? NULL : *i;
304     }
305 gezelter 1211
306 gezelter 507 ConstraintPair* nextConstraintPair(std::vector<ConstraintPair*>::iterator& i) {
307     ++i;
308     return (i == constraintPairs_.end()) ? NULL : *i;
309     }
310 gezelter 1211
311 gezelter 507 ConstraintElem* beginConstraintElem(std::vector<ConstraintElem*>::iterator& i) {
312     i = constraintElems_.begin();
313     return (i == constraintElems_.end()) ? NULL : *i;
314     }
315 gezelter 1211
316 gezelter 507 ConstraintElem* nextConstraintElem(std::vector<ConstraintElem*>::iterator& i) {
317     ++i;
318     return (i == constraintElems_.end()) ? NULL : *i;
319     }
320 gezelter 1715
321     Atom* beginFluctuatingCharge(std::vector<Atom*>::iterator& i) {
322     i = fluctuatingCharges_.begin();
323     return (i == fluctuatingCharges_.end()) ? NULL : *i;
324     }
325    
326     Atom* nextFluctuatingCharge(std::vector<Atom*>::iterator& i) {
327     ++i;
328     return (i == fluctuatingCharges_.end()) ? NULL : *i;
329     }
330    
331 cli2 1360
332 gezelter 1211 /**
333     * Returns the total potential energy of short range interaction
334     * of this molecule
335     */
336 tim 963 RealType getPotential();
337 gezelter 1211
338 gezelter 507 /** get total mass of this molecule */
339 tim 963 RealType getMass();
340 gezelter 1211
341 gezelter 507 /** return the center of mass of this molecule */
342     Vector3d getCom();
343 gezelter 1211
344 gezelter 507 /** Moves the center of this molecule */
345     void moveCom(const Vector3d& delta);
346 gezelter 1211
347 gezelter 507 /** Returns the velocity of center of mass of this molecule */
348     Vector3d getComVel();
349 gezelter 246
350 gezelter 507 std::string getMoleculeName() {
351     return moleculeName_;
352     }
353 tim 289
354 gezelter 507 friend std::ostream& operator <<(std::ostream& o, Molecule& mol);
355 cli2 1360
356     //below functions are just forward functions
357     /**
358     * Adds property into property map
359     * @param genData GenericData to be added into PropertyMap
360     */
361     void addProperty(GenericData* genData);
362    
363     /**
364     * Removes property from PropertyMap by name
365     * @param propName the name of property to be removed
366     */
367     void removeProperty(const std::string& propName);
368    
369     /**
370     * clear all of the properties
371     */
372     void clearProperties();
373    
374     /**
375     * Returns all names of properties
376     * @return all names of properties
377     */
378     std::vector<std::string> getPropertyNames();
379    
380     /**
381     * Returns all of the properties in PropertyMap
382     * @return all of the properties in PropertyMap
383     */
384     std::vector<GenericData*> getProperties();
385    
386     /**
387     * Returns property
388     * @param propName name of property
389     * @return a pointer point to property with propName. If no property named propName
390     * exists, return NULL
391     */
392     GenericData* getPropertyByName(const std::string& propName);
393 gezelter 1211
394 gezelter 507 private:
395 gezelter 1211
396 gezelter 507 int globalIndex_;
397 gezelter 1211
398 gezelter 507 std::vector<Atom*> atoms_;
399     std::vector<Bond*> bonds_;
400     std::vector<Bend*> bends_;
401     std::vector<Torsion*> torsions_;
402 cli2 1275 std::vector<Inversion*> inversions_;
403 gezelter 507 std::vector<RigidBody*> rigidBodies_;
404     std::vector<StuntDouble*> integrableObjects_;
405     std::vector<CutoffGroup*> cutoffGroups_;
406     std::vector<ConstraintPair*> constraintPairs_;
407     std::vector<ConstraintElem*> constraintElems_;
408 gezelter 1715 std::vector<Atom*> fluctuatingCharges_;
409 gezelter 507 int stampId_;
410     std::string moleculeName_;
411 cli2 1360 PropertyMap properties_;
412 gezelter 1718 bool constrainTotalCharge_;
413 cli2 1360
414 gezelter 507 };
415 gezelter 2
416 gezelter 1390 } //namespace OpenMD
417 gezelter 246 #endif //

Properties

Name Value
svn:keywords Author Id Revision Date