All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
SimbodyJoint.hh
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2012-2014 Open Source Robotics Foundation
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 */
17 
18 #ifndef _SIMBODY_JOINT_HH_
19 #define _SIMBODY_JOINT_HH_
20 
21 #include <boost/any.hpp>
22 #include <string>
23 
25 #include "gazebo/physics/Joint.hh"
26 #include "gazebo/util/system.hh"
27 
28 namespace gazebo
29 {
30  namespace physics
31  {
35 
38  {
40  public: SimbodyJoint(BasePtr _parent);
41 
43  public: virtual ~SimbodyJoint();
44 
45  // Documentation inherited.
46  public: virtual void Load(sdf::ElementPtr _sdf);
47 
48  // Documentation inherited.
49  public: virtual void Reset();
50 
51  // Documentation inherited.
52  public: virtual LinkPtr GetJointLink(unsigned int _index) const;
53 
54  // Documentation inherited.
55  public: virtual bool AreConnected(LinkPtr _one, LinkPtr _two) const;
56 
57  // Documentation inherited.
58  public: virtual void Detach();
59 
60  // Documentation inherited.
61  public: virtual void SetAnchor(unsigned int _index,
62  const gazebo::math::Vector3 &_anchor);
63 
64  // Documentation inherited.
65  public: virtual void SetDamping(unsigned int _index,
66  const double _damping);
67 
68  // Documentation inherited.
69  public: virtual void SetStiffness(unsigned int _index,
70  const double _stiffness);
71 
72  // Documentation inherited.
73  public: virtual void SetStiffnessDamping(unsigned int _index,
74  double _stiffness, double _damping, double _reference = 0);
75 
76  // Documentation inherited.
77  public: virtual math::Vector3 GetAnchor(unsigned int _index) const;
78 
79  // Documentation inherited.
80  public: virtual math::Vector3 GetLinkForce(unsigned int _index) const;
81 
82  // Documentation inherited.
83  public: virtual math::Vector3 GetLinkTorque(unsigned int _index) const;
84 
86  public: virtual void SetAttribute(Attribute, unsigned int _index,
87  double _value);
88 
89  // Documentation inherited.
90  public: virtual bool SetParam(const std::string &_key,
91  unsigned int _index,
92  const boost::any &_value);
93 
94  // Documentation inherited.
95  public: virtual double GetParam(const std::string &_key,
96  unsigned int _index);
97 
98  // Save current Simbody State
99  public: virtual void SaveSimbodyState(const SimTK::State &_state);
100 
101  // Restore saved Simbody State
102  public: virtual void RestoreSimbodyState(SimTK::State &_state);
103 
104  // Documentation inherited.
105  public: virtual void SetForce(unsigned int _index, double _force);
106 
107  // Documentation inherited.
108  public: virtual double GetForce(unsigned int _index);
109 
110  // Documentation inherited.
111  public: virtual void SetAxis(unsigned int _index,
112  const math::Vector3 &_axis);
113 
114  // Documentation inherited.
115  public: virtual JointWrench GetForceTorque(unsigned int _index);
116 
127  protected: virtual void SetForceImpl(unsigned int _index,
128  double _force) = 0;
129 
133  private: void SaveForce(unsigned int _index, double _force);
134 
135  // Documentation inherited.
136  public: virtual void CacheForceTorque();
137 
141  public: bool mustBreakLoopHere;
142 
145  public: SimTK::Transform xPA;
146 
148  public: SimTK::Transform xCB;
149 
151  public: SimTK::Transform defxAB;
152 
158  public: SimTK::Force::MobilityLinearSpring spring[MAX_JOINT_AXIS];
159 
164  public: SimTK::Force::MobilityLinearDamper damper[MAX_JOINT_AXIS];
165 
171  public: SimTK::Force::MobilityLinearStop limitForce[MAX_JOINT_AXIS];
172 
178  public: SimTK::MobilizedBody mobod;
179 
182  public: bool isReversed;
183 
189  public: SimTK::Constraint constraint;
190 
191  // Keeps track if simbody physics has been initialized
192  public: bool physicsInitialized;
193 
194  // Documentation inherited.
195  public: virtual bool SetHighStop(unsigned int _index,
196  const math::Angle &_angle);
197 
198  // Documentation inherited.
199  public: virtual bool SetLowStop(unsigned int _index,
200  const math::Angle &_angle);
201 
202  // Documentation inherited.
203  public: virtual math::Angle GetHighStop(unsigned int _index);
204 
205  // Documentation inherited.
206  public: virtual math::Angle GetLowStop(unsigned int _index);
207 
209  protected: SimTK::MultibodySystem *world;
210 
213 
222  private: double forceApplied[MAX_JOINT_AXIS];
223 
226  private: common::Time forceAppliedTime;
227  };
229  }
230 }
231 #endif
SimbodyPhysicsPtr simbodyPhysics
keep a pointer to the simbody physics engine for convenience
Definition: SimbodyJoint.hh:212
SimTK::Transform xPA
Normally A=F, B=M.
Definition: SimbodyJoint.hh:145
boost::shared_ptr< Base > BasePtr
Definition: PhysicsTypes.hh:66
bool isReversed
: if mobilizer, did it reverse parent&child? Set when we build the Simbody model. ...
Definition: SimbodyJoint.hh:182
SimTK::MobilizedBody mobod
Use isValid() if we used a mobilizer Set when we build the Simbody model.
Definition: SimbodyJoint.hh:178
The Vector3 class represents the generic vector containing 3 elements.
Definition: Vector3.hh:43
SimTK::Constraint constraint
: isValid() if we used a constraint to model this joint.
Definition: SimbodyJoint.hh:189
SimTK::MultibodySystem * world
Simbody Multibody System.
Definition: SimbodyJoint.hh:209
bool physicsInitialized
Definition: SimbodyJoint.hh:192
boost::shared_ptr< SimbodyPhysics > SimbodyPhysicsPtr
Definition: SimbodyTypes.hh:37
Base class for all joints.
Definition: SimbodyJoint.hh:37
bool mustBreakLoopHere
Force Simbody to break a loop by using a weld constraint.
Definition: SimbodyJoint.hh:141
SimTK::Transform xCB
child body frame to mobilizer frame
Definition: SimbodyJoint.hh:148
#define MAX_JOINT_AXIS
maximum number of axis per joint anticipated.
Definition: Joint.hh:39
SimTK::Transform defxAB
default mobilizer pose
Definition: SimbodyJoint.hh:151
Base class for all joints.
Definition: Joint.hh:50
Attribute
Joint attribute types.
Definition: Joint.hh:54
Wrench information from a joint.
Definition: JointWrench.hh:39
An angle and related functions.
Definition: Angle.hh:52
#define GAZEBO_VISIBLE
Use to represent "symbol visible" if supported.
Definition: system.hh:48
boost::shared_ptr< Link > LinkPtr
Definition: PhysicsTypes.hh:90
A Time class, can be used to hold wall- or sim-time.
Definition: Time.hh:43