haosulab / ManiSkill

SAPIEN Manipulation Skill Framework, a GPU parallelized robotics simulator and benchmark
https://maniskill.ai/
Apache License 2.0
921 stars 166 forks source link

[BugFix] Improve GPU sim speed and new docs on initial pose handling #655

Closed StoneT2000 closed 4 weeks ago

StoneT2000 commented 4 weeks ago

We discovered a few important things that can easily slow down the GPU simulation (and even break it!), primarily around setting initial poses of builders before building robots/actors/articulations. The latest commit and eventually future releases have new details on how to make GPU simulation faster and importantly accurate. Existing envs you make are not affected really but you may get some warnings from our code about not setting initial poses.

In particular, we strongly recommend the following when building your own tasks

For envs specifically with complex articulations and more than 1, these fixes are critical to ensuring less bugs occur and for faster simulation. Docs for these recommendations have been updated on the custom tasks tutorial: https://maniskill.readthedocs.io/en/latest/user_guide/tutorials/custom_tasks/intro.html#loading