[Doc]: quiver ‘scale_units’ description is not very not clear

[ahmedshaaban1]

Documentation Link

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

Problem

All,
Some of the matplotlib.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

[hjhzdbssmsbrj]

I personally understand that for the scale=None scene, the library will automatically determine the scaling factor to ensure that the vector has visibility and appropriate size within the drawing area. Automatic scaling takes into account the dynamic range of vector amplitude and drawing dimensions to achieve a balance between clarity and information density. When the ideal visual representation is not immediately clear, this is a convenient feature that allows users to focus on the data without manually adjusting the scale from the beginning.

[Kaustbh]

Hi, can I work on it?

[hjhzdbssmsbrj]

谢谢，已收到

[tacaswell]

We do not assign issues and you do not need permission to work on an issue.

I suspect that a majority of the work here will be to read the code and try out different input to be sure that the docs are correct. There may be enough complexity in this that it is worth writing up an analog to https://matplotlib.org/stable/users/explain/artists/imshow_extent.html for quiver.