ros2_controllers icon indicating copy to clipboard operation
ros2_controllers copied to clipboard

Improve Steering Controllers Documentation

Open christophfroehlich opened this issue 1 year ago • 5 comments

In general, I'd appreciate more documentation of the kinematics in the docs for all controllers here. Is there any publicly available reference/book for these mobile robot kinematics we could refer to? I'd happy to help with writing the docs, and maybe writing proper tests for the implementations. But I'm not "fluent" with these type of kinematics, I'd need a textbook for that.

Originally posted by @christophfroehlich in https://github.com/ros-controls/ros2_controllers/issues/878#issuecomment-1837235341

christophfroehlich avatar Dec 14 '23 07:12 christophfroehlich

For example, some simple sketches showing the system inputs of the different steering geometries. Pictures with appropriate licenses could be used and adapted, e.g., from wikipedia. This might also be related with #692

christophfroehlich avatar Dec 14 '23 07:12 christophfroehlich

I'd suggest relying on Wikipedia as much as possible. The core equations are usually well explained but figures may be lacking.

bmagyar avatar Dec 14 '23 08:12 bmagyar

I haven't found anything appropriate to Ackermann steering for example :man_shrugging:

christophfroehlich avatar Dec 14 '23 08:12 christophfroehlich

This is a resource that I found useful: https://msl.cs.uiuc.edu/planning/node657.html

ARK3r avatar Dec 14 '23 20:12 ARK3r

Some literature review

They all handle the kinematics of car-like robots in state-space form, but none is discussing odometry etc. of the different geometries @ARK3r has pointed to here. I guess we have to write that on our own :nerd_face:

christophfroehlich avatar Dec 29 '23 17:12 christophfroehlich