// Copyright 2021 DeepMind Technologies Limited // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. #ifndef MUJOCO_SRC_USER_USER_MODEL_H_ #define MUJOCO_SRC_USER_USER_MODEL_H_ #include #include #include #include #include #include #include #include #include #include #include #include "user/user_api.h" #include "user/user_objects.h" typedef std::map > mjKeyMap; typedef std::array mjListKeyMap; class mjCModel_ : public mjElement { public: // attach namespaces std::string prefix; std::string suffix; protected: bool compiled; // already compiled flag // sizes set from object list lengths int nbody; // number of bodies int njnt; // number of joints int ngeom; // number of geoms int nsite; // number of sites int ncam; // number of cameras int nlight; // number of lights int nflex; // number of flexes int nmesh; // number of meshes int nskin; // number of skins int nhfield; // number of height fields int ntex; // number of textures int nmat; // number of materials int npair; // number of geom pairs in pair array int nexclude; // number of excluded body pairs int neq; // number of equality constraints int ntendon; // number of tendons int nsensor; // number of sensors int nnumeric; // number of numeric fields int ntext; // number of text fields int ntuple; // number of tuple fields int nmocap; // number of mocap bodies int nplugin; // number of plugin instances // sizes computed by Compile int nq; // number of generalized coordinates = dim(qpos) int nv; // number of degrees of freedom = dim(qvel) int nu; // number of actuators/controls int na; // number of activation variables int nbvh; // number of total boundary volume hierarchies int nbvhstatic; // number of static boundary volume hierarchies int nbvhdynamic; // number of dynamic boundary volume hierarchies int nflexvert; // number of vertices in all flexes int nflexedge; // number of edges in all flexes int nflexelem; // number of elements in all flexes int nflexelemdata; // number of element vertex ids in all flexes int nflexshelldata; // number of shell fragment vertex ids in all flexes int nflexevpair; // number of element-vertex pairs in all flexes int nflextexcoord; // number of vertex texture coordinates in all flexes int nmeshvert; // number of vertices in all meshes int nmeshnormal; // number of normals in all meshes int nmeshtexcoord; // number of texture coordinates in all meshes int nmeshface; // number of triangular faces in all meshes int nmeshgraph; // number of shorts in mesh auxiliary data int nskinvert; // number of vertices in all skins int nskintexvert; // number of vertices with texcoord in all skins int nskinface; // number of faces in all skins int nskinbone; // number of bones in all skins int nskinbonevert; // number of vertices in all skins int nhfielddata; // number of data points in all hfields int ntexdata; // number of texture bytes int nwrap; // number of wrap objects in all tendon paths int nsensordata; // number of mjtNums in sensor data vector int nnumericdata; // number of mjtNums in all custom fields int ntextdata; // number of chars in all text fields, including 0 int ntupledata; // number of objects in all tuple fields int npluginattr; // number of chars in all plugin config attributes int nnames; // number of chars in all names int npaths; // number of chars in all paths int nM; // number of non-zeros in sparse inertia matrix int nD; // number of non-zeros in sparse dof-dof matrix int nB; // number of non-zeros in sparse body-dof matrix // statistics, as computed by mj_setConst double meaninertia_auto; // mean diagonal inertia, as computed by mj_setConst double meanmass_auto; // mean body mass, as computed by mj_setConst double meansize_auto; // mean body size, as computed by mj_setConst double extent_auto; // spatial extent, as computed by mj_setConst double center_auto[3]; // center of model, as computed by mj_setConst // save qpos0, to recognize changed key_qpos in write std::vector qpos0; // variable-size attributes std::string comment_; // comment at top of XML std::string modelfiledir_; // path to model file std::string modelname_; std::string meshdir_; std::string texturedir_; std::string spec_comment_; std::string spec_modelfiledir_; std::string spec_modelname_; std::string spec_meshdir_; std::string spec_texturedir_; }; // mjCModel contains everything needed to generate the low-level model. // It can be constructed manually by calling 'Add' functions and setting // the public fields of the various objects. Alternatively it can constructed // by loading an XML file via mjCXML. Once an mjCModel object is // constructed, 'Compile' can be called to generate the corresponding mjModel object // (which is the low-level model). The mjCModel object can then be deleted. class mjCModel : public mjCModel_, private mjSpec { friend class mjCBase; friend class mjCBody; friend class mjCCamera; friend class mjCGeom; friend class mjCFlex; friend class mjCHField; friend class mjCFrame; friend class mjCJoint; friend class mjCEquality; friend class mjCMesh; friend class mjCSkin; friend class mjCSite; friend class mjCTendon; friend class mjCTexture; friend class mjCActuator; friend class mjCSensor; friend class mjCDef; friend class mjXReader; friend class mjXWriter; public: mjCModel(); mjCModel(const mjCModel& other); mjCModel& operator=(const mjCModel& other); mjCModel& operator+=(const mjCModel& other); ~mjCModel(); void CopyFromSpec(); // copy spec to private attributes void PointToLocal(); mjSpec spec; mjModel* Compile(const mjVFS* vfs = nullptr); // construct mjModel bool CopyBack(const mjModel*); // DECOMPILER: copy numeric back void FuseStatic(); // fuse static bodies with parent void FuseReindex(mjCBody* body); // reindex elements during fuse // API for adding model elements mjCFlex* AddFlex(); mjCMesh* AddMesh(mjCDef* def = nullptr); mjCSkin* AddSkin(); mjCHField* AddHField(); mjCTexture* AddTexture(); mjCMaterial* AddMaterial(mjCDef* def = nullptr); mjCPair* AddPair(mjCDef* def = nullptr); // geom pair for inclusion mjCBodyPair* AddExclude(); // body pair for exclusion mjCEquality* AddEquality(mjCDef* def = nullptr); // equality constraint mjCTendon* AddTendon(mjCDef* def = nullptr); mjCActuator* AddActuator(mjCDef* def = nullptr); mjCSensor* AddSensor(); mjCNumeric* AddNumeric(); mjCText* AddText(); mjCTuple* AddTuple(); mjCKey* AddKey(); mjCPlugin* AddPlugin(); // copy vector of elements to this model template void CopyList(std::vector& dest, const std::vector& source, std::map& def_map, const std::vector& defaults); // delete elements marked as discard=true template void Delete(std::vector& elements, const std::vector& discard); // delete all elements template void DeleteAll(std::vector& elements); // API for access to model elements (outside tree) int NumObjects(mjtObj type); // number of objects in specified list mjCBase* GetObject(mjtObj type, int id); // pointer to specified object // API for access to other variables bool IsCompiled() const; // is model already compiled const mjCError& GetError(void) const; // get reference of error object mjCBody* GetWorld() const; // pointer to world body mjCDef* FindDef(std::string name) const; // find default class name mjCDef* AddDef(std::string name, int parentid); // add default class to array mjCBase* FindObject(mjtObj type, std::string name) const; // find object given type and name mjCBody* FindBody(mjCBody* body, std::string name) const; // find body given name mjCFrame* FindFrame(mjCBody* body, std::string name) const; // find frame given name bool IsNullPose(const mjtNum* pos, const mjtNum* quat) const; // detect null pose // accessors std::string get_meshdir(void) const { return meshdir_; } std::string get_texturedir(void) const { return texturedir_; } // resolve plugin instance, create a new one if needed void ResolvePlugin(mjCBase* obj, const std::string& plugin_name, const std::string& plugin_instance_name, mjCPlugin** plugin_instance); // settings for each defaults class std::vector defaults; // list of active plugins std::vector> active_plugins; private: void TryCompile(mjModel*& m, mjData*& d, const mjVFS* vfs); mjModel* _Compile(const mjVFS* vfs); // clear objects allocated by Compile void Clear(void); // add object of any type template T* AddObject(std::vector& list, std::string type); // add object of any type, with def parameter template T* AddObjectDef(std::vector& list, std::string type, mjCDef* def); // if asset name is missing, set to filename template void SetDefaultNames(std::vector& assets); // delete material from object template void DeleteMaterial(std::vector& list, std::string_view name = ""); // compile phases void MakeLists(mjCBody* body); // make lists of bodies, geoms, joints, sites void SetNuser(); // set nuser fields void IndexAssets(bool discard); // convert asset names into indices void CheckEmptyNames(); // check empty names void SetSizes(); // compute sizes void AutoSpringDamper(mjModel*); // automatic stiffness and damping computation void LengthRange(mjModel*, mjData*); // compute actuator lengthrange void CopyNames(mjModel*); // copy names, compute name addresses void CopyPaths(mjModel*); // copy paths, compute path addresses void CopyObjects(mjModel*); // copy objects outside kinematic tree void CopyTree(mjModel*); // copy objects inside kinematic tree // objects created here std::vector flexes; // list of flexes std::vector meshes; // list of meshes std::vector skins; // list of skins std::vector hfields; // list of height fields std::vector textures; // list of textures std::vector materials; // list of materials std::vector pairs; // list of geom pairs to include std::vector excludes; // list of body pairs to exclude std::vector equalities; // list of equality constraints std::vector tendons; // list of tendons std::vector actuators; // list of actuators std::vector sensors; // list of sensors std::vector numerics; // list of numeric fields std::vector texts; // list of text fields std::vector tuples; // list of tuple fields std::vector keys; // list of keyframe fields std::vector plugins; // list of plugin instances // pointers to objects created inside kinematic tree std::vector bodies; // list of bodies std::vector joints; // list of joints allowing motion relative to parent std::vector geoms; // list of geoms attached to this body std::vector sites; // list of sites attached to this body std::vector cameras; // list of cameras std::vector lights; // list of lights std::vector frames; // list of frames // array of pointers to each object list (enumerated by type) std::array*, mjNOBJECT> object_lists; // create mjCBase lists from children lists void CreateObjectLists(); // populate objects ids void ProcessLists(); mjListKeyMap ids; // map from object names to ids mjCError errInfo; // last error info bool plugin_owner; // this class allocated the plugins }; #endif // MUJOCO_SRC_USER_USER_MODEL_H_