matplotlib icon indicating copy to clipboard operation
matplotlib copied to clipboard

[MNT]: Terminology: artist property

Open timhoffm opened this issue 3 years ago • 2 comments

Summary

Matplotlib uses "property" as a technical term for aspects of an Artist that can be queried using a get_<prop-name>() method. This is confusing because property has a dedicated meaning within python. Examples:

https://matplotlib.org/devdocs/api/_as_gen/matplotlib.artist.Artist.properties.html

Return a dictionary of all the properties of the artist.

https://matplotlib.org/devdocs/api/_as_gen/matplotlib.artist.Artist.set.html:

Set multiple properties at once. Supported properties are

Proposed fix

I think our properties are older than python's, but we can't make them change :stuck_out_tongue_winking_eye:. I therefore propose that we use a different term in our documentation. Suggestion: artist property.

Inspired by #22451.

timhoffm avatar Feb 12 '22 20:02 timhoffm

This issue has been marked "inactive" because it has been 365 days since the last comment. If this issue is still present in recent Matplotlib releases, or the feature request is still wanted, please leave a comment and this label will be removed. If there are no updates in another 30 days, this issue will be automatically closed, but you are free to re-open or create a new issue if needed. We value issue reports, and this procedure is meant to help us resurface and prioritize issues that have not been addressed yet, not make them disappear. Thanks for your help!

github-actions[bot] avatar Nov 24 '25 02:11 github-actions[bot]

Also a candidate for a revived glossary #28889.

timhoffm avatar Nov 24 '25 06:11 timhoffm