Documentation Link

https://matplotlib.org/stable/api/_as_gen/matplotlib.pyplot.quiver.html

Problem

All,
Some of thematplotlib.pyplot.quiver plot arguments are vague ( based on the questions posted on StackOverflow). I think that the description of the ’scale_units’ could be clarified by:

Suggested improvement

1. What scale is used here "If scale_units is 'x' then the vector will be 0.5 x-axis units”, is it 2 ? .
2. Describing in detail the meaning of the "If the scale kwarg is None, the arrow length unit"
3. The concept of the “unit” could be easily misunderstood, especially when dealing with physical parameters that have specific units.

Thanks