Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

tutorials: Need to add tutorial for MultibodyPlant #12912

Closed
EricCousineau-TRI opened this issue Mar 20, 2020 · 5 comments
Closed

tutorials: Need to add tutorial for MultibodyPlant #12912

EricCousineau-TRI opened this issue Mar 20, 2020 · 5 comments
Assignees
Labels
component: tutorials Drake's tutorials, examples, and website content priority: low type: documentation

Comments

@EricCousineau-TRI
Copy link
Contributor

EricCousineau-TRI commented Mar 20, 2020

At present, we have tutorials for formulating IK / MP problems and doing rendering with MBP.
However, we don't have any succinct tutorials covering how MBP works.

Some things to do (which could be done in stages):

  • Intro (kinematics, dynamics, topology, etc). Mostly, this should point to Doxygen / Underactuated textbook, and not repeat too much?
  • Parsing models. Should also cover parsing multiple models, and model instances.
  • Querying joints, bodies, etc. Should cover model instances (e.g. errors you get when you have multiple of the same name).
  • Minimal coordinates (positions, velocities). Read/write. Talk about floating-body base coordinates?
  • Maximal coordinates (pose). Read/write. CalcRelativeTransform, etc.
  • Visualization (relates tutorials: Support meshcat running in a jupyter cell (as iframe) on Google Colab #12645, though perhaps we could do 2D projections?), first w/o sim.
  • Dynamics.
  • Basic geometry, collision. (We may want to save complex bits for a separate tutorial?)
  • Simulation. Sensors, force
    • Also cover purely kinematic simulations? (e.g. driving kinematics by input ports to position / velocity).

After reviewing Zhaoyuan's tutorials, I see some minor inaccuracies. Once we have the tutorial in Drake, perhaps we should try to get him to link to ours?

EDIT(2020/04/22): Zero recollection of what the "inaccuracies" might be... mayhaps I just didn't read the tutorial closely enough.

FYI @sherm1 @huihuaTRI @RussTedrake

@RussTedrake
Copy link
Contributor

RussTedrake commented Mar 21, 2020

I've had this on my list for a long time, too. Here was the notes I had jotted down before thinking about what to include (sorry for the duplication with your list):

  • Creating your multibody system from urdf/sdf. Simple geometry inspector interface with jupyter joint sliders and an embedded meshcat visualizer
  • Core design: MBP + SceneGraph
  • Simulation.
    • Visualizers. Playback.
    • Simulator as a ROS node
  • Kinematics and dynamics. Show symbolic.
  • (Inverse) kinematics. Mention global IK
  • Call out to the existence many other advanced algorithms (for motion planning, etc)

@hongkai-dai
Copy link
Contributor

I am modifying IK API as mentioned in #12849 (comment), I will add the IK tutorial after the API is stabilized.

@EricCousineau-TRI
Copy link
Contributor Author

EricCousineau-TRI commented Apr 22, 2020

FYI @IanTheEngineer Relates #13084

@jwnimmer-tri
Copy link
Collaborator

See also #16643, which intends to implement a portion of the topics listed above.

@jwnimmer-tri jwnimmer-tri added component: tutorials Drake's tutorials, examples, and website content and removed unused team: dynamics component: multibody plant MultibodyPlant and supporting code labels May 3, 2022
@jwnimmer-tri
Copy link
Collaborator

Closing as a duplicate of #16643. I've copied all of the ideas above into that issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
component: tutorials Drake's tutorials, examples, and website content priority: low type: documentation
Projects
None yet
Development

No branches or pull requests

5 participants