RobotLocomotion / drake

Model-based design and verification for robotics.
https://drake.mit.edu
Other
3.35k stars 1.27k forks source link

supported and custom tags for SDF proximity properties are undiscoverable #16178

Closed RussTedrake closed 2 years ago

RussTedrake commented 2 years ago

I just got a perfectly reasonable question: "How do I set the friction coefficient in an SDF". It was surprisingly hard to find the answer!

My answer was: For controlling the friction properties, you can add additional tags to the sdf: https://github.com/RobotLocomotion/drake/blob/master/multibody/parsing/detail_scene_graph.h#L159 as seen in https://github.com/RobotLocomotion/drake/blob/62750b830658b2013113ce26e9f9b56327e945c4/bindings/pydrake/multibody/test/hydroelastic.sdf#L26

But all that beautiful documentation in detail_scene_graph.h is under an internal scope, and does not appear in any user documentation. Unless I'm missing something?

SeanCurtis-TRI commented 2 years ago

Closing as redundant of #13314.

RussTedrake commented 2 years ago

Fair. #13314 suggests that it is only hydroelastic parameters that are hidden. But this is a problem for all proximity parameters (including point contact); and really all parsing documentation.

SeanCurtis-TRI commented 2 years ago

Surely #13314 refers to many things that have nothing to do with hydroelastic:

Other than the fact that two of the examples refer to hydroelastic, there is literally no language that refers to it. Still, if you're dying for this issue to remain open. I won't stand in the way.

rpoyner-tri commented 2 years ago

I will claim this need was largely satisfied by #16444. Of course there is more work to do, but not enough to justify keeping this issue.