ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/group/trunk/OOPSE-4/src/primitives/RigidBody.hpp
(Generate patch)

Comparing trunk/OOPSE-4/src/primitives/RigidBody.hpp (file contents):
Revision 1490 by gezelter, Fri Sep 24 04:16:43 2004 UTC vs.
Revision 1968 by tim, Fri Feb 4 04:57:04 2005 UTC

# Line 1 | Line 1
1 < #ifndef __RIGIDBODY_HPP__
2 < #define __RIGIDBODY_HPP__
1 > /*
2 > * 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 > * 1. Acknowledgement of the program authors must be made in any
10 > *    publication of scientific results based in part on use of the
11 > *    program.  An acceptable form of acknowledgement is citation of
12 > *    the article in which the program was described (Matthew
13 > *    A. Meineke, Charles F. Vardeman II, Teng Lin, Christopher
14 > *    J. Fennell and J. Daniel Gezelter, "OOPSE: An Object-Oriented
15 > *    Parallel Simulation Engine for Molecular Dynamics,"
16 > *    J. Comput. Chem. 26, pp. 252-271 (2005))
17 > *
18 > * 2. Redistributions of source code must retain the above copyright
19 > *    notice, this list of conditions and the following disclaimer.
20 > *
21 > * 3. Redistributions in binary form must reproduce the above copyright
22 > *    notice, this list of conditions and the following disclaimer in the
23 > *    documentation and/or other materials provided with the
24 > *    distribution.
25 > *
26 > * This software is provided "AS IS," without a warranty of any
27 > * kind. All express or implied conditions, representations and
28 > * warranties, including any implied warranty of merchantability,
29 > * fitness for a particular purpose or non-infringement, are hereby
30 > * excluded.  The University of Notre Dame and its licensors shall not
31 > * be liable for any damages suffered by licensee as a result of
32 > * using, modifying or distributing the software or its
33 > * derivatives. In no event will the University of Notre Dame or its
34 > * licensors be liable for any lost revenue, profit or data, or for
35 > * direct, indirect, special, consequential, incidental or punitive
36 > * damages, however caused and regardless of the theory of liability,
37 > * arising out of the use of or inability to use software, even if the
38 > * University of Notre Dame has been advised of the possibility of
39 > * such damages.
40 > */
41 >
42 > /**
43 > * @file RigidBody.hpp
44 > * @author    tlin
45 > * @date  10/23/2004
46 > * @version 1.0
47 > */
48  
49 + #ifndef PRIMITIVES_RIGIDBODY_HPP
50 + #define PRIMITIVES_RIGIDBODY_HPP
51 +
52   #include <vector>
5 //#include "Atom.hpp"
6 //#include "AtomStamp.hpp"
7 #include "RigidBodyStamp.hpp"
8 #include "StuntDouble.hpp"
9 using namespace std;
53  
54 < class Atom;
55 < class AtomStamp;
56 <
57 < typedef struct {
15 <  double vec[3];
16 <  double& operator[](int index) {return vec[index];}  
17 < } vec3;
18 <
19 < typedef struct {
20 <  double mat[3][3];
21 <  double* operator[](int index) {return mat[index];}  
22 < } mat3x3;
23 <
54 > #include "primitives/StuntDouble.hpp"
55 > #include "primitives/DirectionalAtom.hpp"
56 > #include "types/AtomStamp.hpp"
57 > namespace oopse{
58   class RigidBody : public StuntDouble {
59 +    public:
60  
61 < public:
27 <  
28 <  RigidBody();
29 <  //RigidBody(const RigidBody& rb);
30 <  
31 <  virtual ~RigidBody();
32 <
33 <  void addAtom(Atom* at, AtomStamp* ats);
61 >        typedef std::vector<Atom*>::iterator AtomIterator;        
62  
63 <  void getPos( double theP[3] );
36 <  void setPos( double theP[3] );
63 >        RigidBody();
64  
65 <  void getVel( double theV[3] );
66 <  void setVel( double theV[3] );
65 >        virtual std::string getType() { return name_;}
66 >        
67 >        /** Sets the name of this stuntdouble*/
68 >        virtual void setType(const std::string& name) { name_ = name;}
69 >    
70  
71 <  void getFrc( double theF[3] );
72 <  void addFrc( double theF[3] );
73 <  void zeroForces();
74 <  
75 <  virtual bool isLinear() {return is_linear;}
76 <  virtual int linearAxis() {return linear_axis;}
71 >       /**
72 >         * Sets  the previous rotation matrix of this stuntdouble
73 >         * @param a  new rotation matrix
74 >         */        
75 >       virtual void setPrevA(const RotMat3x3d& a);
76 >      
77 >       /**
78 >         * Sets  the current rotation matrix of this stuntdouble
79 >         * @param a  new rotation matrix
80 >         * @note setA will not change the position and rotation matrix of Directional atoms belong to
81 >         * this rigidbody. If you want to do that, use #updateAtoms
82 >         */        
83 >        virtual void setA(const RotMat3x3d& a);
84 >       /**
85 >         * Sets  the rotation matrix of this stuntdouble in specified snapshot
86 >         * @param a rotation matrix to be set
87 >         * @param snapshotNo
88 >         * @see #getA
89 >         */        
90 >        virtual void setA(const RotMat3x3d& a, int snapshotNo);
91  
92 <  double getMass( void ) { return mass; }
92 >        /**
93 >         * Returns the inertia tensor of this stuntdouble
94 >         * @return the inertia tensor of this stuntdouble
95 >         */
96 >        virtual Mat3x3d getI();
97  
50  void printAmatIndex( void );
51  void setEuler( double phi, double theta, double psi );
52  void getQ( double the_q[4] ); // get the quanternions
53  void setQ( double the_q[4] );
98  
99 <  void getA( double the_A[3][3] ); // get the full rotation matrix
100 <  void setA( double the_A[3][3] );
99 >        /** Sets the internal unit frame of this stuntdouble by three euler angles */
100 >        void setElectroFrameFromEuler(double phi, double theta, double psi);
101 >        
102 >        /**
103 >         * Returns the gradient of this stuntdouble
104 >         * @return the inertia tensor of this stuntdouble
105 >         * @see #setI
106 >         */
107 >        virtual std::vector<double> getGrad();
108  
109 <  void getJ( double theJ[3] );
59 <  void setJ( double theJ[3] );
109 >        virtual void accept(BaseVisitor* v);
110  
111 <  virtual void setType(char* type) {strcpy(rbName, type);}
62 <  virtual char* getType() { return rbName;}
111 >        void addAtom(Atom* at, AtomStamp* ats);
112  
113 <  void getTrq( double theT[3] );
114 <  void addTrq( double theT[3] );
113 >        /** calculate the reference coordinates */
114 >        void calcRefCoords();
115  
116 <  void getI( double the_I[3][3] );
117 <  void lab2Body( double r[3] );
69 <  void body2Lab( double r[3] );
116 >        /** Convert Atomic forces and torques to total forces and torques */
117 >        void calcForcesAndTorques();
118  
119 <  double getZangle( );
120 <  void setZangle( double zAng );
73 <  void addZangle( double zAng );
119 >        /** update the positions of atoms belong to this rigidbody */
120 >        void updateAtoms();
121  
122 <  void calcRefCoords( void );
76 <  void doEulerToRotMat(vec3 &euler, mat3x3 &myA );
77 <  void calcForcesAndTorques( void );
78 <  void updateAtoms( void );
122 >        Atom* beginAtom(std::vector<Atom*>::iterator& i);
123  
124 <  //void yourAtomsHaveMoved( void );
124 >        Atom* nextAtom(std::vector<Atom*>::iterator& i);
125  
126 <  // Four functions added for derivatives with respect to Euler Angles:
127 <  // (Needed for minimization routines):
126 >        std::vector<Atom*>::iterator getBeginAtomIter() {
127 >            return atoms_.begin();
128 >        }
129 >        
130 >        std::vector<Atom*>::iterator getEndAtomIter() {
131 >            return atoms_.end();
132 >        }
133  
134 <  void getGrad(double gradient[6] );
135 <  void getEulerAngles( double myEuler[3] );
136 <
137 <  double max(double x, double y);
138 <  double min(double x, double y);
134 >        /**
135 >         * Returns the atoms of this rigid body
136 >         * @return the atoms of this rigid body in a vector
137 >         * @deprecate
138 >         */          
139 >        std::vector<Atom*> getAtoms() {
140 >            return atoms_;
141 >        }
142  
143 +        /**
144 +         * Returns the number of atoms in this rigid body
145 +         * @return the number of atoms in this rigid body
146 +         */
147 +        int getNumAtoms() {
148 +            return atoms_.size();
149 +        }
150  
151 <  // utility routines
151 >        /**
152 >         * Return the position of atom which belongs to this rigid body.
153 >         * @return true if index is valid otherwise return false
154 >         * @param pos the position of atom which will be set on return if index is valid
155 >         * @param index the index of the atom in rigid body's private data member atoms_
156 >         */
157 >        bool getAtomPos(Vector3d& pos, unsigned int index);
158  
159 <  void findCOM( void );
159 >        /**
160 >         * Return the position of atom which belongs to this rigid body.
161 >         * @return true if atom belongs to this rigid body,otherwise return false
162 >         * @param pos position of atom which will be set on return if atom belongs to this rigid body
163 >         * @param atom the pointer to an atom
164 >         */            
165 >        bool getAtomPos(Vector3d& pos, Atom* atom);
166  
167 <  virtual void accept(BaseVisitor* v);
167 >        /**
168 >         * Return the velocity of atom which belongs to this rigid body.
169 >         * @return true if index is valid otherwise return false
170 >         * @param vel the velocity of atom which will be set on return if index is valid
171 >         * @param index the index of the atom in rigid body's private data member atoms_
172 >         */
173 >        bool getAtomVel(Vector3d& vel, unsigned int index);
174  
175 <  vector<Atom*> getAtoms() { return myAtoms;}
176 <  int getNumAtoms() {return myAtoms.size();}
175 >        /**
176 >         * Return the velocity of atom which belongs to this rigid body.
177 >         * @return true if atom belongs to this rigid body,otherwise return false
178 >         * @param vel velocity of atom which will be set on return if atom belongs to this rigid body
179 >         * @param atom the pointer to an atom
180 >         */
181 >        bool getAtomVel(Vector3d& vel, Atom*);
182  
183 <  void getAtomPos(double theP[3], int index);
184 <  void getAtomVel(double theV[3], int index);
185 <  void getAtomRefCoor(double pos[3], int index);
186 < protected:
183 >        /**
184 >         * Return the reference coordinate of atom which belongs to this rigid body.
185 >         * @return true if index is valid otherwise return false
186 >         * @param coor the reference coordinate of atom which will be set on return if index is valid
187 >         * @param index the index of the atom in rigid body's private data member atoms_
188 >         */
189 >        bool getAtomRefCoor(Vector3d& coor, unsigned int index);
190  
191 <  double mass;     // the total mass
192 <  double pos[3];   // the position array (center of mass)
193 <  double vel[3];   // the velocity array (center of mass)
194 <  double frc[3];   // the force array    (center of mass)
195 <  double trq[3];   // the torque vector  ( space fixed )
196 <  double ji[3];    // the angular momentum vector (body fixed)
197 <  double A[3][3];  // the rotation matrix
113 <  double I[3][3];  // the inertial tensor (body fixed)
114 <  double sU[3][3]; // the standard unit vectors (body fixed)
115 <  double zAngle;   // the rotation about the z-axis (body fixed)
191 >        /**
192 >         * Return the velocity of atom which belongs to this rigid body.
193 >         * @return true if atom belongs to this rigid body,otherwise return false
194 >         * @param coor velocity of atom which will be set on return if atom belongs to this rigid body
195 >         * @param atom the pointer to an atom
196 >         */
197 >        bool getAtomRefCoor(Vector3d& coor, Atom* atom);
198  
199 <  bool is_linear;
200 <  int linear_axis;
201 <  double momIntTol;
199 >    private:
200 >        std::string name_;        
201 >        Mat3x3d inertiaTensor_;    
202 >        RotMat3x3d sU_;               /**< body fixed standard unit vector */
203 >        
204 >        std::vector<Atom*> atoms_;
205 >        std::vector<Vector3d> refCoords_;
206 >        std::vector<RotMat3x3d> refOrients_;
207 > };
208  
209 <  vector<Atom*> myAtoms;  // the vector of atoms
122 <  vector<vec3> refCoords;
123 <  vector<mat3x3> refOrients;
209 > }//namepace oopse
210  
211 <  char rbName[100]; //it will eventually be converted into string
126 < };
211 > #endif //PRIMITIVES_RIGIDBODY_HPP
212  
128 #endif

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines