opensurgsim
RigidRepresentationBase.h
1 // This file is a part of the OpenSurgSim project.
2 // Copyright 2013, SimQuest Solutions Inc.
3 //
4 // Licensed under the Apache License, Version 2.0 (the "License");
5 // you may not use this file except in compliance with the License.
6 // You may obtain a copy of the License at
7 //
8 // http://www.apache.org/licenses/LICENSE-2.0
9 //
10 // Unless required by applicable law or agreed to in writing, software
11 // distributed under the License is distributed on an "AS IS" BASIS,
12 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 // See the License for the specific language governing permissions and
14 // limitations under the License.
15 
16 #ifndef SURGSIM_PHYSICS_RIGIDREPRESENTATIONBASE_H
17 #define SURGSIM_PHYSICS_RIGIDREPRESENTATIONBASE_H
18 
19 #include "SurgSim/DataStructures/Location.h"
20 #include "SurgSim/Math/Shape.h"
21 #include "SurgSim/Physics/Representation.h"
22 #include "SurgSim/Physics/RigidLocalization.h"
23 #include "SurgSim/Physics/RigidState.h"
24 
25 namespace SurgSim
26 {
27 
28 namespace Collision
29 {
30 class Representation;
31 }
32 
33 namespace Physics
34 {
35 
39 {
40 public:
43  explicit RigidRepresentationBase(const std::string& name);
44 
46  virtual ~RigidRepresentationBase();
47 
51  void setInitialState(const RigidState& state);
52 
53  void resetState() override;
54 
57  const RigidState& getInitialState() const;
60  const RigidState& getCurrentState() const;
63  const RigidState& getPreviousState() const;
64 
65  std::shared_ptr<Localization> createLocalization(const SurgSim::DataStructures::Location& location) override;
66 
69  void setDensity(double rho);
70 
73  double getDensity() const;
74 
77  double getMass() const;
78 
81  const SurgSim::Math::Vector3d& getMassCenter() const;
82 
85  const SurgSim::Math::Matrix33d& getLocalInertia() const;
86 
89  void setLinearDamping(double linearDamping);
90 
93  double getLinearDamping() const;
94 
97  void setAngularDamping(double angularDamping);
98 
101  double getAngularDamping() const;
102 
106  void setShape(const std::shared_ptr<SurgSim::Math::Shape> shape);
107 
110  const std::shared_ptr<SurgSim::Math::Shape> getShape() const;
111 
117  void setCollisionRepresentation(std::shared_ptr<SurgSim::Collision::Representation> representation) override;
118 
119  void beforeUpdate(double dt) override;
120  void afterUpdate(double dt) override;
121 
122 protected:
123  bool doInitialize() override;
124  bool doWakeUp() override;
125 
134 
137 
139  double m_rho;
140 
142  double m_mass;
143 
146 
149 
152 
155 
157  std::shared_ptr<SurgSim::Math::Shape> m_shape;
158 
163  template <class T>
164  std::shared_ptr<T> createTypedLocalization(const SurgSim::DataStructures::Location& location);
165 
166 private:
168  void updateProperties();
169 
170  virtual void updateGlobalInertiaMatrices(const RigidState& state) = 0;
171 };
172 
173 }; // Physics
174 }; // SurgSim
175 
176 #include "SurgSim/Physics/RigidRepresentationBase-inl.h"
177 
178 #endif // SURGSIM_PHYSICS_RIGIDREPRESENTATIONBASE_H
double m_angularDamping
Angular damping parameter (in N.m.s.rad-1)
Definition: RigidRepresentationBase.h:148
Wraps glewInit() to separate the glew opengl definitions from the osg opengl definitions only imgui n...
Definition: AddRandomSphereBehavior.cpp:36
std::shared_ptr< SurgSim::Math::Shape > m_shape
Shape to be used for the mass/inertia calculation.
Definition: RigidRepresentationBase.h:157
SurgSim::Math::Matrix33d m_localInertia
Inertia matrix in local coordinates.
Definition: RigidRepresentationBase.h:154
The Representation class defines the base class for all physics objects.
Definition: Representation.h:53
A Location defines a local position w.r.t.
Definition: Location.h:39
RigidState m_previousState
Previous rigid representation state.
Definition: RigidRepresentationBase.h:129
Eigen::Matrix< double, 3, 1 > Vector3d
A 3D vector of doubles.
Definition: Vector.h:57
RigidState m_initialState
Initial rigid representation state (useful for reset)
Definition: RigidRepresentationBase.h:127
The RigidRepresentationBase class defines the base class for all rigid motion based representations (...
Definition: RigidRepresentationBase.h:38
The RigidState class describes a state (position and velocity information).
Definition: RigidState.h:31
double m_mass
Total mass of the object (in Kg)
Definition: RigidRepresentationBase.h:142
RigidState m_currentState
Current rigid representation state.
Definition: RigidRepresentationBase.h:131
double m_rho
Density of the object (in Kg.m-3)
Definition: RigidRepresentationBase.h:139
bool m_parametersValid
Validity of the parameters.
Definition: RigidRepresentationBase.h:136
RigidState m_finalState
Last valid/final rigid representation state.
Definition: RigidRepresentationBase.h:133
double m_linearDamping
Linear damping parameter (in N.s.m-1 or Kg.s-1)
Definition: RigidRepresentationBase.h:145
SurgSim::Math::Vector3d m_massCenter
Mass-center of the object.
Definition: RigidRepresentationBase.h:151
Eigen::Matrix< double, 3, 3, Eigen::RowMajor > Matrix33d
A 3x3 matrix of doubles.
Definition: Matrix.h:51