mjcf-graph.hpp

Go to the documentation of this file.

//
// Copyright (c) 2015-2024 CNRS INRIA
//
 
#ifndef __pinocchio_parsers_mjcf_graph_hpp__
#define __pinocchio_parsers_mjcf_graph_hpp__
 
#include "pinocchio/parsers/urdf.hpp"
#include "pinocchio/multibody/model.hpp"
#include "pinocchio/multibody/joint/joints.hpp"
#include "pinocchio/algorithm/contact-info.hpp"
#include <boost/property_tree/xml_parser.hpp>
#include <boost/property_tree/ptree.hpp>
#include <boost/foreach.hpp>
#include <boost/math/constants/constants.hpp>
#include <boost/filesystem.hpp>
#include <boost/logic/tribool.hpp>
#include <boost/lexical_cast.hpp>
 
#include <sstream>
#include <limits>
#include <iostream>
#include <unordered_map>
#include <map>
 
namespace pinocchio
{
  namespace mjcf
  {
    namespace details
    {
      struct MjcfGraph;
      struct MjcfJoint;
      struct MjcfGeom;
      struct MjcfSite;
 
      struct PINOCCHIO_PARSERS_DLLAPI MjcfCompiler
      {
      public:
        // Global attribute to use limit that are in the model or not
        bool autolimits = true;
 
        // Attribute to keep or not the full path of files specified in the model
        bool strippath = false;
        // Directory where all the meshes are (can be relative or absolute)
        std::string meshdir;
        // Directory where all the textures are (can be relative or absolute)
        std::string texturedir;
 
        // Value for angle conversion (Mujoco default - degrees)
        double angle_converter = boost::math::constants::pi<double>() / 180.0;
        // Euler Axis to use to convert angles representation to quaternion
        Eigen::Matrix3d mapEulerAngles;
 
        // Value to crop the mass (if mass < boundMass, mass = boundMass)
        double boundMass = 0;
        // Value to crop the diagonal of the inertia matrix (if mass < boundMass, mass = boundMass)
        double boundInertia = 0;
 
        // True, false or auto - auto = indeterminate
        boost::logic::tribool inertiafromgeom = boost::logic::indeterminate;
 
        double convertAngle(const double & angle_) const;
 
        Eigen::Matrix3d convertEuler(const Eigen::Vector3d & angles) const;
      };
 
      struct MjcfClass
      {
      public:
        typedef boost::property_tree::ptree ptree;
 
        // name of the default class
        std::string className;
        // Ptree associated with the class name
        ptree classElement;
      };
 
      struct MjcfBody
      {
      public:
        // Name of the body
        std::string bodyName;
        // Name of the parent
        std::string bodyParent;
        // Name of the default class used by this body (optional)
        std::string bodyClassName;
        // Special default class, that is common to all bodies and children if not specified
        // otherwise
        std::string childClass;
 
        // Position of the body wrt to the previous body
        SE3 bodyPlacement = SE3::Identity();
        // Body inertia
        Inertia bodyInertia = Inertia::Identity();
 
        // Vector of joints associated with the body
        std::vector<MjcfJoint> jointChildren;
        // Vector of geometries associated with the body
        std::vector<MjcfGeom> geomChildren;
        // Vector of sites
        std::vector<MjcfSite> siteChildren;
      };
 
      struct PINOCCHIO_PARSERS_DLLAPI RangeJoint
      {
        // Max effort
        Eigen::VectorXd maxEffort;
        // Max velocity
        Eigen::VectorXd maxVel;
        // Max position
        Eigen::VectorXd maxConfig;
        // Min position
        Eigen::VectorXd minConfig;
 
        // Join Stiffness
        Eigen::VectorXd springStiffness;
        //  joint position or angle in which the joint spring (if any) achieves equilibrium
        Eigen::VectorXd springReference;
 
        // friction applied in this joint
        Eigen::VectorXd friction;
        // Damping applied by this joint.
        Eigen::VectorXd damping;
 
        // Armature inertia created by this joint
        Eigen::VectorXd armature;
        // Dry friction.
        double frictionLoss = 0.;
 
        RangeJoint() = default;
        explicit RangeJoint(double v)
        {
          const double infty = std::numeric_limits<double>::infinity();
          maxVel = Eigen::VectorXd::Constant(1, infty);
          maxEffort = Eigen::VectorXd::Constant(1, infty);
          minConfig = Eigen::VectorXd::Constant(1, -infty);
          maxConfig = Eigen::VectorXd::Constant(1, infty);
          springStiffness = Eigen::VectorXd::Constant(1, v);
          springReference = Eigen::VectorXd::Constant(1, v);
          friction = Eigen::VectorXd::Constant(1, 0.);
          damping = Eigen::VectorXd::Constant(1, 0.);
          armature = Eigen::VectorXd::Constant(1, 0.);
        }
 
        template<int Nq, int Nv>
        RangeJoint setDimension() const;
 
        template<int Nq, int Nv>
        RangeJoint concatenate(const RangeJoint & range) const;
      };
 
      struct PINOCCHIO_PARSERS_DLLAPI MjcfJoint
      {
      public:
        typedef boost::property_tree::ptree ptree;
 
        // Name of the joint
        std::string jointName = "free";
        // Placement of the joint wrt to its body - default Identity
        SE3 jointPlacement = SE3::Identity();
 
        // axis of the joint - default "0 0 1"
        Eigen::Vector3d axis = Eigen::Vector3d::UnitZ();
        // Limits that applie to this joint
        RangeJoint range{1};
 
        // type of the joint (hinge, ball, slide, free) - default "hinge"
        std::string jointType = "hinge";
 
        double posRef = 0.; // only possible for hinge and slides
 
        void fill(const ptree & el, const MjcfBody & currentBody, const MjcfGraph & currentGraph);
 
        void
        goThroughElement(const ptree & el, bool use_limits, const MjcfCompiler & currentCompiler);
      };
      struct MjcfMesh
      {
        // Scale of the mesh
        Eigen::Vector3d scale = Eigen::Vector3d::Constant(1);
        // Path to the mesh file
        std::string filePath;
      };
 
      struct MjcfTexture
      {
        // [2d, cube, skybox], “cube”
        std::string textType = "cube";
        // Path to the texture file
        std::string filePath;
        // Size of the grid if needed
        Eigen::Vector2d gridsize = Eigen::Vector2d::Constant(1);
      };
 
      struct PINOCCHIO_PARSERS_DLLAPI MjcfMaterial
      {
        typedef boost::property_tree::ptree ptree;
        // Color of the material
        Eigen::Vector4d rgba = Eigen::Vector4d::Constant(1);
 
        float reflectance = 0;
 
        float shininess = 0.5;
 
        float specular = 0.5;
 
        float emission = 0;
        // name of the texture to apply on the material
        std::string texture;
 
        void goThroughElement(const ptree & el);
      };
 
      struct PINOCCHIO_PARSERS_DLLAPI MjcfGeom
      {
      public:
        typedef boost::property_tree::ptree ptree;
 
        // Kind of possible geometry
        enum TYPE
        {
          VISUAL,
          COLLISION,
          BOTH
        };
        // name of the geometry object
        std::string geomName;
 
        // [plane, hfield, sphere, capsule, ellipsoid, cylinder, box, mesh, sdf], “sphere”
        std::string geomType = "sphere";
 
        // Kind of the geometry object
        TYPE geomKind = BOTH;
 
        // Contact filtering and dynamic pair (used here to determine geometry kind)
        int contype = 1;
        int conaffinity = 1;
        // Geometry group (used to determine geometry kind)
        int group = 0;
 
        // String that hold size parameter
        std::string sizeS;
        // Optional in case fromto tag is used
        boost::optional<std::string> fromtoS;
        // Size parameter
        Eigen::VectorXd size;
 
        // Color of the geometry
        Eigen::Vector4d rgba = Eigen::Vector4d::Constant(1);
 
        // Name of the material applied on the geometry
        std::string materialName;
        // Name of the mesh (optional)
        std::string meshName;
 
        // Density for computing the mass
        double density = 1000;
        // If mass is only on the outer layer of the geometry
        bool shellinertia = false;
 
        // Geometry Placement in parent body. Center of the frame of geometry is the center of mass.
        SE3 geomPlacement = SE3::Identity();
        // Inertia of the geometry obj
        Inertia geomInertia = Inertia::Identity();
        // optional mass (if not defined, will use density)
        boost::optional<double> massGeom;
 
        void findKind();
 
        void computeSize();
 
        void computeInertia();
 
        void fill(const ptree & el, const MjcfBody & currentBody, const MjcfGraph & currentGraph);
 
        void goThroughElement(const ptree & el, const MjcfGraph & currentGraph);
      };
 
      struct PINOCCHIO_PARSERS_DLLAPI MjcfSite
      {
        typedef boost::property_tree::ptree ptree;
 
        SE3 sitePlacement = SE3::Identity();
 
        std::string siteName;
 
        void fill(const ptree & el, const MjcfBody & currentBody, const MjcfGraph & currentGraph);
        void goThroughElement(const ptree & el, const MjcfGraph & currentGraph);
      };
 
      /*
      typedef struct mjsEquality_ {      // equality specification
        mjsElement* element;             // element type
        mjString* name;                  // name
        mjtEq type;                      // constraint type
        double data[mjNEQDATA];          // type-dependent data
        mjtByte active;                  // is equality initially active
        mjString* name1;                 // name of object 1
        mjString* name2;                 // name of object 2
        mjtNum solref[mjNREF];           // solver reference
        mjtNum solimp[mjNIMP];           // solver impedance
        mjString* info;                  // message appended to errors
      } mjsEquality;
      */
      struct PINOCCHIO_PARSERS_DLLAPI MjcfEquality
      {
        typedef boost::property_tree::ptree ptree;
 
        // Optional name of the equality constraint
        std::string name;
 
        // Type of the constraint: (connect for now)
        std::string type;
 
        // // Optional class for setting unspecified attributes
        // std::string class;
 
        // active: 'true' or 'false' (default: 'true')
        // solref and solimp
 
        // Name of the first body participating in the constraint
        std::string body1;
        // Name of the second body participating in the constraint (optional, default: world)
        std::string body2;
 
        // Coordinates of the 3D anchor point where the two bodies are connected.
        // Specified relative to the local coordinate frame of the first body.
        Eigen::Vector3d anchor = Eigen::Vector3d::Zero();
 
        // TODO: implement when weld is introduced
        // This attribute specifies the relative pose (3D position followed by 4D quaternion
        // orientation) of body2 relative to body1. If the quaternion part (i.e., last 4 components
        // of the vector) are all zeros, as in the default setting, this attribute is ignored and
        // the relative pose is the one corresponding to the model reference pose in qpos0. The
        // unusual default is because all equality constraint types share the same default for their
        // numeric parameters.
        // Eigen::VectorXd relativePose = Eigen::VectorXd::Zero(7);
      };
 
      struct PINOCCHIO_PARSERS_DLLAPI MjcfGraph
      {
      public:
        typedef boost::property_tree::ptree ptree;
        typedef std::vector<std::string> VectorOfStrings;
        typedef std::unordered_map<std::string, MjcfBody> BodyMap_t;
        typedef std::unordered_map<std::string, MjcfClass> ClassMap_t;
        typedef std::unordered_map<std::string, MjcfMaterial> MaterialMap_t;
        typedef std::unordered_map<std::string, MjcfMesh> MeshMap_t;
        typedef std::unordered_map<std::string, MjcfTexture> TextureMap_t;
        typedef std::unordered_map<std::string, Eigen::VectorXd> ConfigMap_t;
        typedef std::map<std::string, MjcfEquality> EqualityMap_t;
 
        // Compiler Info needed to properly parse the rest of file
        MjcfCompiler compilerInfo;
        // Map of default classes
        ClassMap_t mapOfClasses;
        // Map of bodies
        BodyMap_t mapOfBodies;
        // Map of Materials
        MaterialMap_t mapOfMaterials;
        // Map of Meshes
        MeshMap_t mapOfMeshes;
        // Map of textures
        TextureMap_t mapOfTextures;
        // Map of model configurations
        ConfigMap_t mapOfConfigs;
        // Map of equality constraints
        EqualityMap_t mapOfEqualities;
 
        // reference configuration
        Eigen::VectorXd referenceConfig;
 
        // property tree where xml file is stored
        ptree pt;
 
        // Ordered list of bodies
        VectorOfStrings bodiesList;
 
        // Name of the model
        std::string modelName;
        std::string modelPath;
 
        // Urdf Visitor to add joint and body
        typedef pinocchio::urdf::details::
          UrdfVisitor<double, 0, ::pinocchio::JointCollectionDefaultTpl>
            UrdfVisitor;
        UrdfVisitor & urdfVisitor;
 
        MjcfGraph(UrdfVisitor & urdfVisitor, const std::string & modelPath)
        : modelPath(modelPath)
        , urdfVisitor(urdfVisitor)
        {
        }
 
        SE3 convertPosition(const ptree & el) const;
 
        Inertia convertInertiaFromMjcf(const ptree & el) const;
 
        void parseDefault(ptree & el, const ptree & parent, const std::string & parentTag);
 
        void parseJointAndBody(
          const ptree & el,
          const boost::optional<std::string> & childClass,
          const std::string & parentName = "");
 
        void parseCompiler(const ptree & el);
 
        void parseTexture(const ptree & el);
 
        void parseMaterial(const ptree & el);
 
        void parseMesh(const ptree & el);
 
        void parseAsset(const ptree & el);
 
        void parseKeyFrame(const ptree & el);
 
        void parseEquality(const ptree & el);
 
        void parseGraph();
 
        void parseGraphFromXML(const std::string & xmlStr);
 
        template<typename TypeX, typename TypeY, typename TypeZ, typename TypeUnaligned>
        JointModel createJoint(const Eigen::Vector3d & axis);
 
        void
        addSoloJoint(const MjcfJoint & jointInfo, const MjcfBody & currentBody, SE3 & bodyInJoint);
 
        void fillModel(const std::string & nameOfBody);
 
        void parseRootTree();
 
        void fillReferenceConfig(const MjcfBody & currentBody);
 
        void addKeyFrame(const Eigen::VectorXd & keyframe, const std::string & keyName);
 
        void parseContactInformation(
          const Model & model,
          PINOCCHIO_STD_VECTOR_WITH_EIGEN_ALLOCATOR(RigidConstraintModel) & contact_models);
 
        void parseGeomTree(
          const GeometryType & type,
          GeometryModel & geomModel,
          ::hpp::fcl::MeshLoaderPtr & meshLoader);
      };
      namespace internal
      {
        inline std::istringstream getConfiguredStringStream(const std::string & str)
        {
          std::istringstream posStream(str);
          posStream.exceptions(std::ios::failbit);
          return posStream;
        }
 
        template<int N>
        inline Eigen::Matrix<double, N, 1> getVectorFromStream(const std::string & str)
        {
          std::istringstream stream = getConfiguredStringStream(str);
          Eigen::Matrix<double, N, 1> vector;
          for (int i = 0; i < N; i++)
            stream >> vector(i);
 
          return vector;
        }
 
        inline Eigen::VectorXd getUnknownSizeVectorFromStream(const std::string & str)
        {
          std::istringstream stream = getConfiguredStringStream(str);
          std::vector<double> vector;
          double elem;
          while (!stream.eof())
          {
            stream >> elem;
            vector.push_back(elem);
          }
 
          Eigen::VectorXd returnVector(vector.size());
          for (std::size_t i = 0; i < vector.size(); i++)
            returnVector(static_cast<Eigen::Index>(i)) = vector[i];
 
          return returnVector;
        }
      } // namespace internal
    } // namespace details
  } // namespace mjcf
} // namespace pinocchio
 
#endif // __pinocchio_parsers_mjcf_graph_hpp__