New pose proposal: support rotation in degrees (#252)

include/sdf/Element.hh

@@ -243,6 +243,10 @@ namespace sdf
     /// \return The number of attributes.
     public: size_t GetAttributeCount() const;
 
+    /// \brief Get all the attribute params.
+    /// \return The vector of parameter attributes.
+    public: const Param_V &GetAttributes() const;
+
     /// \brief Get an attribute using an index.
     /// \param[in] _index the index of the attribute to get.
     /// \return A Param pointer to the attribute.

include/sdf/Param.hh

@@ -53,6 +53,10 @@ namespace sdf
   inline namespace SDF_VERSION_NAMESPACE {
   //
 
+  class SDFORMAT_VISIBLE Element;
+  using ElementPtr = std::shared_ptr<Element>;
+  using ElementWeakPtr = std::weak_ptr<Element>;
+
   class SDFORMAT_VISIBLE Param;
 
   /// \def ParamPtr
@@ -180,13 +184,44 @@ namespace sdf
     /// of the parameter. nullopt otherwise.
     public: std::optional<std::string> GetMaxValueAsString() const;
 
+    /// \brief Set the parameter value from a string.
+    /// \param[in] _value New value for the parameter in string form.
+    /// \param[in] _ignoreParentAttributes Whether to ignore parent element
+    /// attributes when parsing value from string as well as subsequent
+    /// reparses.
+    public: bool SetFromString(const std::string &_value,
+                               bool _ignoreParentAttributes);
+
     /// \brief Set the parameter value from a string.
     /// \param[in] _value New value for the parameter in string form.
     public: bool SetFromString(const std::string &_value);
 
+    /// \brief Get the parent Element of this Param.
+    /// \return Pointer to this Param's parent Element, nullptr if there is no
+    /// parent Element.
+    public: ElementPtr GetParentElement() const;
+
+    /// \brief Set the parent Element of this Param.
+    /// \param[in] _parentElement Pointer to new parent Element. A nullptr can
+    /// provided to remove the current parent Element.
+    public: void SetParentElement(ElementPtr _parentElement);
+
     /// \brief Reset the parameter to the default value.
     public: void Reset();
 
+    /// \brief Reparse the parameter value. This should be called after the
+    /// parent element's attributes have been modified, in the event that the
+    /// value was set using SetFromString or posesses a default value, and that
+    /// the final parsed value is dependent on the attributes of the parent
+    /// element. For example, the rotation component of a pose element can
+    /// be parsed as degrees or radians, depending on the attribute @degrees
+    /// of the parent element. If however the value was explicitly set using the
+    /// Set<T> function, reparsing would not change the value.
+    /// \return True if the parameter value has been reparsed successfully.
+    /// \sa bool SetFromString(const std::string &_value)
+    /// \sa bool Set(const T &_value)
+    public: bool Reparse();
+
     /// \brief Get the key value.
     /// \return The key.
     public: const std::string &GetKey() const;
@@ -209,6 +244,12 @@ namespace sdf
     /// \return True if the parameter has been set.
     public: bool GetSet() const;
 
+    /// \brief Return true if the parameter ignores the parent element's
+    /// attributes, or if the parameter has no parent element.
+    /// \return True if the parameter ignores the parent element's attributes,
+    /// or if the parameter has no parent element.
+    public: bool IgnoresParentElementAttribute() const;
+
     /// \brief Clone the parameter.
     /// \return A new parameter that is the clone of this.
     public: ParamPtr Clone() const;
@@ -301,6 +342,9 @@ namespace sdf
     /// \brief Description of the parameter.
     public: std::string description;
 
+    /// \brief Parent element.
+    public: ElementWeakPtr parentElement;
+
     /// \brief Update function pointer.
     public: std::function<std::any ()> updateFunc;
 
@@ -319,6 +363,14 @@ namespace sdf
     /// \brief This parameter's value
     public: ParamVariant value;
 
+    /// \brief True if the value has been parsed while ignoring its parent
+    /// element's attributes, and will continue to ignore them for subsequent
+    /// reparses.
+    public: bool ignoreParentAttributes;
+
+    /// \brief This parameter's value that was provided as a string
+    public: std::optional<std::string> strValue;
+
     /// \brief This parameter's default value
     public: ParamVariant defaultValue;
 
@@ -399,7 +451,7 @@ namespace sdf
     {
       std::stringstream ss;
       ss << _value;
-      return this->SetFromString(ss.str());
+      return this->SetFromString(ss.str(), true);
     }
     catch(...)
     {

sdf/1.9/pose.sdf

@@ -1,11 +1,19 @@
 <!-- Pose -->
-<element name="pose" type="pose" default="0 0 0 0 0 0" required="0">
-  <description>A position(x,y,z) and orientation(roll, pitch yaw) with respect to the frame named in the relative_to attribute.</description>
+<element name="pose" type="pose" default="0 0 0   0 0 0" required="0">
+  <description>
+    A pose (x, y, z, r, p, y) expressed in the frame named by @relative_to. The first three components (x, y, z) represent the position of the element's origin (in the @relative_to frame) and the last three components (roll, pitch, yaw) represent the orientation of the element as a sequence of intrinsic Euler rotations.
+  </description>
 
-  <attribute name="relative_to" type="string" default="" required="*">
+  <attribute name="relative_to" type="string" default="" required="0">
     <description>
       Name of frame relative to which the pose is applied.
     </description>
   </attribute>
 
+  <attribute name="degrees" type="bool" default="false" required="0">
+    <description>
+      Whether or not the euler angles are in degrees, otherwise they will be interpreted as radians by default.
+    </description>
+  </attribute>
+
 </element> <!-- End Pose -->

src/Element.cc

@@ -152,6 +152,7 @@ void Element::AddValue(const std::string &_type,
   this->dataPtr->value =
       std::make_shared<Param>(this->dataPtr->name, _type, _defaultValue,
                               _required, _minValue, _maxValue, _description);
+  this->dataPtr->value->SetParentElement(shared_from_this());
 }
 
 /////////////////////////////////////////////////
@@ -161,8 +162,10 @@ ParamPtr Element::CreateParam(const std::string &_key,
                               bool _required,
                               const std::string &_description)
 {
-  return ParamPtr(
-      new Param(_key, _type, _defaultValue, _required, _description));
+  ParamPtr param = std::make_shared<Param>(
+      _key, _type, _defaultValue, _required, _description);
+  param->SetParentElement(shared_from_this());
+  return param;
 }
 
 /////////////////////////////////////////////////
@@ -195,7 +198,9 @@ ElementPtr Element::Clone() const
   for (aiter = this->dataPtr->attributes.begin();
        aiter != this->dataPtr->attributes.end(); ++aiter)
   {
-    clone->dataPtr->attributes.push_back((*aiter)->Clone());
+    auto clonedAttribute = (*aiter)->Clone();
+    clonedAttribute->SetParentElement(clone);
+    clone->dataPtr->attributes.push_back(clonedAttribute);
   }
 
   ElementPtr_V::const_iterator eiter;
@@ -215,6 +220,7 @@ ElementPtr Element::Clone() const
   if (this->dataPtr->value)
   {
     clone->dataPtr->value = this->dataPtr->value->Clone();
+    clone->dataPtr->value->SetParentElement(clone);
   }
 
   if (this->dataPtr->includeElement)
@@ -248,6 +254,7 @@ void Element::Copy(const ElementPtr _elem)
     }
     ParamPtr param = this->GetAttribute((*iter)->GetKey());
     (*param) = (**iter);
+    param->SetParentElement(shared_from_this());
   }
 
   if (_elem->GetValue())
@@ -260,6 +267,7 @@ void Element::Copy(const ElementPtr _elem)
     {
       *(this->dataPtr->value) = *(_elem->GetValue());
     }
+    this->dataPtr->value->SetParentElement(shared_from_this());
   }
 
   this->dataPtr->elementDescriptions.clear();
@@ -657,6 +665,12 @@ size_t Element::GetAttributeCount() const
   return this->dataPtr->attributes.size();
 }
 
+/////////////////////////////////////////////////
+const Param_V &Element::GetAttributes() const
+{
+  return this->dataPtr->attributes;
+}
+
 /////////////////////////////////////////////////
 ParamPtr Element::GetAttribute(unsigned int _index) const
 {