JointAxis.hh
Go to the documentation of this file.
1 /*
2  * Copyright 2018 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 #ifndef SDF_JOINTAXIS_HH_
18 #define SDF_JOINTAXIS_HH_
19 
20 #include <memory>
21 #include <string>
22 #include <ignition/math/Vector3.hh>
23 #include <ignition/utils/ImplPtr.hh>
24 #include "sdf/Element.hh"
25 #include "sdf/Exception.hh"
26 #include "sdf/Types.hh"
27 #include "sdf/sdf_config.h"
28 #include "sdf/system_util.hh"
29 
30 namespace sdf
31 {
32  // Inline bracket to help doxygen filtering.
33  inline namespace SDF_VERSION_NAMESPACE {
34  //
35 
36  // Forward declare private data class.
37  struct PoseRelativeToGraph;
38  template <typename T> class ScopedGraph;
39 
43  {
45  public: JointAxis();
46 
53  public: Errors Load(ElementPtr _sdf);
54 
63  public: ignition::math::Vector3d Xyz() const;
64 
69  public: [[nodiscard]] sdf::Errors SetXyz(
70  const ignition::math::Vector3d &_xyz);
71 
77  public: double Damping() const;
78 
84  public: void SetDamping(const double _damping);
85 
90  public: double Friction() const;
91 
95  public: void SetFriction(const double _friction);
96 
101  public: double SpringReference() const;
102 
106  public: void SetSpringReference(const double _spring);
107 
112  public: double SpringStiffness() const;
113 
117  public: void SetSpringStiffness(const double _spring);
118 
124  public: double Lower() const;
125 
131  public: void SetLower(const double _lower);
132 
138  public: double Upper() const;
139 
145  public: void SetUpper(const double _upper);
146 
153  public: double Effort() const;
154 
160  public: void SetEffort(double _effort);
161 
166  public: double MaxVelocity() const;
167 
172  public: void SetMaxVelocity(const double _velocity);
173 
177  public: double Stiffness() const;
178 
183  public: void SetStiffness(const double _stiffness);
184 
188  public: double Dissipation() const;
189 
193  public: void SetDissipation(const double _dissipation);
194 
199  public: const std::string& XyzExpressedIn() const;
200 
205  public: void SetXyzExpressedIn(const std::string &_frame);
206 
215  ignition::math::Vector3d &_xyz,
216  const std::string &_resolveTo = "") const;
217 
222  public: sdf::ElementPtr Element() const;
223 
230  public: sdf::ElementPtr ToElement(unsigned int _index = 0u) const;
231 
236  private: void SetXmlParentName(const std::string &_xmlParentName);
237 
242  private: void SetPoseRelativeToGraph(
244 
246  friend class Joint;
247 
249  IGN_UTILS_IMPL_PTR(dataPtr)
250  };
251  }
252 }
253 #endif
Parameters related to the axis of rotation for rotational joints, and the axis of translation for pri...
Definition: JointAxis.hh:43
Errors ResolveXyz(ignition::math::Vector3d &_xyz, const std::string &_resolveTo="") const
Express xyz unit vector of this axis in the coordinates of another named frame.
sdf::ElementPtr Element() const
Get a pointer to the SDF element that was used during load.
void SetSpringReference(const double _spring)
Set the spring reference position for this joint axis.
double Damping() const
Get the physical velocity dependent viscous damping coefficient of the joint axis.
void SetFriction(const double _friction)
Set the physical static friction value of the joint.
void SetXyzExpressedIn(const std::string &_frame)
Set the name of the coordinate frame in which this joint axis's unit vector is expressed.
Errors Load(ElementPtr _sdf)
Load the joint axis based on a element pointer.
sdf::Errors SetXyz(const ignition::math::Vector3d &_xyz)
Set the x,y,z components of the axis unit vector.
void SetStiffness(const double _stiffness)
Get the joint stop stiffness.
double Lower() const
Get the lower joint axis limit (radians for revolute joints, meters for prismatic joints).
void SetUpper(const double _upper)
Set the upper joint axis limit (radians for revolute joints, meters for prismatic joints).
void SetEffort(double _effort)
Set the value for enforcing the maximum absolute joint effort that can be applied.
ignition::math::Vector3d Xyz() const
Get the x,y,z components of the axis unit vector.
void SetDissipation(const double _dissipation)
Set the joint stop dissipation.
sdf::ElementPtr ToElement(unsigned int _index=0u) const
Create and return an SDF element filled with data from this joint axis.
void SetDamping(const double _damping)
Set the physical velocity dependent viscous damping coefficient of the joint axis.
double Effort() const
Get the value for enforcing the maximum absolute joint effort that can be applied.
double Dissipation() const
Get the joint stop dissipation.
double SpringReference() const
Get the spring reference position for this joint axis.
void SetLower(const double _lower)
Set the lower joint axis limit (radians for revolute joints, meters for prismatic joints).
void SetMaxVelocity(const double _velocity)
Set the value for enforcing the maximum absolute joint velocity.
double MaxVelocity() const
Get the value for enforcing the maximum absolute joint velocity.
void SetSpringStiffness(const double _spring)
Set the spring stiffness for this joint axis.
double Stiffness() const
Get the joint stop stiffness.
double Friction() const
Get the physical static friction value of the joint.
double SpringStiffness() const
Get the spring stiffness for this joint axis.
double Upper() const
Get the upper joint axis limit (radians for revolute joints, meters for prismatic joints).
const std::string & XyzExpressedIn() const
Get the name of the coordinate frame in which this joint axis's unit vector is expressed.
Definition: Joint.hh:86
Definition: Collision.hh:39
std::vector< Error > Errors
A vector of Error.
Definition: Types.hh:106
std::shared_ptr< Element > ElementPtr
Definition: Element.hh:54
namespace for Simulation Description Format parser
Definition: Actor.hh:35
#define SDFORMAT_VISIBLE
Use to represent "symbol visible" if supported.
Definition: system_util.hh:25