jaxsim icon indicating copy to clipboard operation
jaxsim copied to clipboard

Consider extending the documentation with a textbook-like introduction

Open markusheimerl opened this issue 1 year ago • 4 comments

see https://mujoco.readthedocs.io/en/stable/computation/index.html for reference.

markusheimerl avatar Jun 13 '24 11:06 markusheimerl

Hi @markusheimerl, thanks for the suggestion. We are aware that the documentation is currently lacking, so far we focused mainly on functionality. Many things have changed in the past few months, but now we reached APIs that are much more stable.

We are considering both to extend the documentation and provide a paper / technical report. Timing is not yet clear though.

diegoferigo avatar Jun 13 '24 12:06 diegoferigo

Hello @diegoferigo, thanks for the prompt update. Looking forward to developments of jaxsim 👍🏻

markusheimerl avatar Jun 13 '24 12:06 markusheimerl

Waiting for more details that go beyond the docstrings of our code, for the time being I would probably redirect interested readers to Chapter 2 (Robot modelling), Chapter 7 (Contact-aware multibody dynamics) and Chapter 8 (Scaling rigid-body simulations) of my Ph.D. thesis[^1]. It describes the considered dynamics, the soft contact model, and provides the pseudocode of the rigid body dynamics algorithms implemented in JaxSim.

Many software-engineering things have changed since, but the modelling is pretty much the same, and at least readers can find a good reference of notation and considered dynamics.

[^1]: Simulation Architectures for Reinforcement Learning applied to Robotics, 2022, URL.

diegoferigo avatar Jun 28 '24 08:06 diegoferigo

We just merged in #265 and #261 new notebooks with few interesting use-cases. They might be worth a look for a primer on the considered use-cases.

diegoferigo avatar Oct 17 '24 14:10 diegoferigo