gazebosim / gazebosim/sdformat
Document //collision/surface/bounce/restitution_coefficient semantics
- Dominant language
- C++
- Stars
- 216
- Forks
- 125
- Avg merge
- 1d 14h
- Merged PRs (30d)
- 14
Description
It is not clear the semantics of `//collision/surface/bounce/restitution_coefficient` . The current docs are:
> Bounciness coefficient of restitution, from [0...1], where 0=no bounciness.
Beside the math definition of `restitution_coefficient`, what is missing is how the `restitution_coefficient` of two collision in contacts get computed.
Related PRs:
* https://github.com/ignitionrobotics/ign-physics/pull/139
* https://github.com/robotology/gym-ignition-models/pull/30
Contributor guide
Research direction
Start by reviewing the existing documentation for `//collision/surface/bounce/restitution_coefficient` and the related PRs #139 and #30. Trace how restitution coefficients from two colliding contacts are combined, then update the documentation to explain both the mathematical definition and the contact-combination semantics.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- cpp
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100