Simbody  3.7
Body.h
Go to the documentation of this file.
1 #ifndef SimTK_SIMBODY_BODY_H_
2 #define SimTK_SIMBODY_BODY_H_
3 
4 /* -------------------------------------------------------------------------- *
5  * Simbody(tm) *
6  * -------------------------------------------------------------------------- *
7  * This is part of the SimTK biosimulation 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/home/simbody. *
11  * *
12  * Portions copyright (c) 2007-13 Stanford University and the Authors. *
13  * Authors: Michael Sherman *
14  * Contributors: *
15  * *
16  * Licensed under the Apache License, Version 2.0 (the "License"); you may *
17  * not use this file except in compliance with the License. You may obtain a *
18  * copy of the License at http://www.apache.org/licenses/LICENSE-2.0. *
19  * *
20  * Unless required by applicable law or agreed to in writing, software *
21  * distributed under the License is distributed on an "AS IS" BASIS, *
22  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. *
23  * See the License for the specific language governing permissions and *
24  * limitations under the License. *
25  * -------------------------------------------------------------------------- */
26 
32 #include "SimTKcommon.h"
35 
36 #include <cassert>
37 
38 namespace SimTK {
39 
40 class DecorativeGeometry;
41 
42 //==============================================================================
43 // BODY
44 //==============================================================================
56 public:
58 Body() : rep(0) { }
60 ~Body();
63 Body(const Body& source);
66 Body& operator=(const Body& source);
67 
72 Body(const MassProperties& massProps);
73 
78 Body& setDefaultRigidBodyMassProperties(const MassProperties&);
79 
83 const MassProperties& getDefaultRigidBodyMassProperties() const;
84 
93 int addDecoration(const Transform& X_BD, const DecorativeGeometry& geometry);
94 
97 int addDecoration(const DecorativeGeometry& geometry)
98 { return addDecoration(Transform(), geometry); }
99 
103 int getNumDecorations() const;
104 
108 const DecorativeGeometry& getDecoration(int i) const;
109 
115 DecorativeGeometry& updDecoration(int i) const;
116 
124 int addContactSurface(const Transform& X_BS,
125  const ContactSurface& shape);
126 
130 { return addContactSurface(Transform(), shape); }
131 
134 int getNumContactSurfaces() const;
137 const ContactSurface& getContactSurface(int i) const;
140 const Transform& getContactSurfaceTransform(int i) const;
144 ContactSurface& updContactSurface(int i);
148 Transform& updContactSurfaceTransform(int i);
149 
150 // These are the built-in Body types.
151 class Ground; // infinitely massive
152 class Massless; // just a reference frame
153 class Particle; // point mass only; com=0; no inertia
154 class Linear; // point masses along a line; scalar inertia
155 class Rigid; // general rigid body
156 class Deformable; // base class for bodies with internal deformation coords
157 
158 bool isOwnerHandle() const;
159 bool isEmptyHandle() const;
160 
161 // Internal use only
162 class BodyRep; // local subclass
163 explicit Body(class BodyRep* r) : rep(r) { }
164 bool hasRep() const {return rep!=0;}
165 const BodyRep& getRep() const {assert(rep); return *rep;}
166 BodyRep& updRep() const {assert(rep); return *rep;}
167 void setRep(BodyRep& r) {assert(!rep); rep = &r;}
168 
169 protected:
170 class BodyRep* rep;
171 };
172 
173 
174 
175 //==============================================================================
176 // BODY::RIGID
177 //==============================================================================
181 public:
184  Rigid();
187  explicit Rigid(const MassProperties&);
188 
191  return *this;
192  }
193 
194  class RigidRep; // local subclass
196 private:
197  RigidRep& updRep();
198  const RigidRep& getRep() const;
199 };
200 
201 
202 
203 
204 //==============================================================================
205 // BODY::LINEAR
206 //==============================================================================
211 public:
212  Linear(); // default mass properties (1,Vec3(0),Inertia(1,1,0))
213  explicit Linear(const MassProperties&);
214 
217  return *this;
218  }
219 
220  class LinearRep; // local subclass
222 private:
223  LinearRep& updRep();
224  const LinearRep& getRep() const;
225 };
226 
227 
228 // Particles aren't yet supported, so hide this in Doxygen.
230 //==============================================================================
231 // BODY::PARTICLE
232 //==============================================================================
236 class SimTK_SIMBODY_EXPORT Body::Particle : public Body {
237 public:
238  Particle(); // default mass properties (1,Vec3(0),Inertia(0))
239  explicit Particle(const Real& mass);
240 
241  Particle& setDefaultRigidBodyMassProperties(const MassProperties& m) {
243  return *this;
244  }
245 
246  class ParticleRep; // local subclass
247  SimTK_PIMPL_DOWNCAST(Particle, Body);
248 private:
249  ParticleRep& updRep();
250  const ParticleRep& getRep() const;
251 };
256 //==============================================================================
257 // BODY::MASSLESS
258 //==============================================================================
262 public:
263  Massless();
264 
265  class MasslessRep; // local subclass
267 private:
268  MasslessRep& updRep();
269  const MasslessRep& getRep() const;
270 };
271 
272 
273 
274 //==============================================================================
275 // BODY::GROUND
276 //==============================================================================
280 public:
281  Ground();
282 
283  class GroundRep; // local subclass
285 private:
286  GroundRep& updRep();
287  const GroundRep& getRep() const;
288 };
289 
290 } // namespace SimTK
291 
292 #endif // SimTK_SIMBODY_BODY_H_
293 
294 
295 
#define SimTK_PIMPL_DOWNCAST(Derived, Parent)
Similar to the above but for private implementation abstract classes, that is, abstract class hierarc...
Definition: SimTKcommon/include/SimTKcommon/internal/common.h:593
Declares ContactMaterial and ContactSurface classes.
Body()
Default constructor creates an empty Body handle.
Definition: Body.h:58
This is a Body representing something immobile, of effectively infinite mass and inertia, that cannot be modified to be anything else.
Definition: Body.h:279
The Body class represents a reference frame that can be used to describe mass properties and geometry...
Definition: Body.h:55
This is the top-level SimTK namespace into which all SimTK names are placed to avoid collision with o...
Definition: Assembler.h:37
A general rigid body.
Definition: Body.h:180
const BodyRep & getRep() const
Definition: Body.h:165
Linear & setDefaultRigidBodyMassProperties(const MassProperties &m)
Definition: Body.h:215
Every Simbody header and source file should include this header before any other Simbody header...
This class contains the mass, center of mass, and unit inertia matrix of a rigid body B...
Definition: MassProperties.h:85
SimTK_Real Real
This is the default compiled-in floating point type for SimTK, either float or double.
Definition: SimTKcommon/include/SimTKcommon/internal/common.h:606
class BodyRep * rep
Definition: Body.h:170
Body(class BodyRep *r)
Definition: Body.h:163
bool hasRep() const
Definition: Body.h:164
Includes internal headers providing declarations for the basic SimTK Core classes, including Simmatrix.
int addContactSurface(const ContactSurface &shape)
Convenience method for when the contact surface is to be placed at the body frame.
Definition: Body.h:129
This is a Body that is constitutively massless (and inertialess); meaning that no amount of fiddling ...
Definition: Body.h:261
int addDecoration(const DecorativeGeometry &geometry)
Convenience method for when the decorative geometry is to be placed at the body frame.
Definition: Body.h:97
This is a rigid body in the shape of a line, which is inherently inertialess about its axis...
Definition: Body.h:210
Body & setDefaultRigidBodyMassProperties(const MassProperties &)
Every type of Body should provide an initial set of rigid body mass properties defined at Topology st...
This is the client-side interface to an implementation-independent representation of "Decorations" su...
Definition: DecorativeGeometry.h:86
#define SimTK_SIMBODY_EXPORT
Definition: Simbody/include/simbody/internal/common.h:68
This class combines a piece of ContactGeometry with a ContactMaterial to make an object suitable for ...
Definition: ContactSurface.h:342
void setRep(BodyRep &r)
Definition: Body.h:167
Rigid & setDefaultRigidBodyMassProperties(const MassProperties &m)
Definition: Body.h:189
BodyRep & updRep() const
Definition: Body.h:166
Transform_< Real > Transform
Definition: Transform.h:44