Document/simply the usage of ergocub models in mujoco

icub-tech-iit / ergocub-software

Main collector of ergoCub specific SW

https://icub-tech-iit.github.io/ergocub-software/

BSD 3-Clause "New" or "Revised" License

14 stars 18 forks source link

Document/simply the usage of ergocub models in mujoco #265

Open traversaro opened 1 month ago

traversaro commented 1 month ago

A bit of spinoff of https://github.com/robotology/icub-models/issues/155, but as most people in AMI now use ergocub we want to focus on ergocub here.

As first step, we may need to to understand how people are currently loading the ergocub models in mujoco, can you share this @diegoferigo @CarlottaSartore @vpunithreddy @Giulero @giotherobot @xela-95 @flferretti @GiulioRomualdi , also via pointers to existing code? With this, info we can understand possible outcomes:

Document how to load existing ergocub-software models using some library in mujoco
Add some automatically generated output models to ergocub-software.

giotherobot commented 1 month ago

This is my library: https://github.com/ami-iit/mujoco-urdf-loader

traversaro commented 1 month ago

xref: https://github.com/google-deepmind/mujoco/issues/1432 .

traversaro commented 1 month ago

This is my library: https://github.com/ami-iit/mujoco-urdf-loader

So probably a good first pointer is to point ergocub users to https://github.com/ami-iit/mujoco-urdf-loader/blob/main/examples/generate_ergoCub_mjcf.py, not sure if this is enough for what @GiulioRomualdi and @giulero had in mind.

diegoferigo commented 1 month ago

Inside ami-iit/jaxsim we have a jaxsim.mujoco Python package for visualizing URDF/SDF models.

Refer to the following PRs showing the main features supported by our visualizer:

In particular, the helper for positioning cameras in both the interactive visualizer and the recorder is pretty useful in practice. Also, the support of uneven terrain is nice to have for many applications.

The Python package has been developed without direct JaxSim dependencies to simplify extracting it to a standalone project in the future -- if neeed.

traversaro commented 1 month ago

@diegoferigo thanks! Do you have some snippet somewhere (tutorial or test) that just loads a model specified via package:// and simulate it?

diegoferigo commented 1 month ago

The combination of a simple simulation with the recorder can be found in this notebook.
For the interactive viewer, instead, a good starting point is the command line script.