Title: [Doc]: Information about deprecated colormaps missing from recent versions of the documentation · Issue #30796 · matplotlib/matplotlib · GitHub
Open Graph Title: [Doc]: Information about deprecated colormaps missing from recent versions of the documentation · Issue #30796 · matplotlib/matplotlib
X Title: [Doc]: Information about deprecated colormaps missing from recent versions of the documentation · Issue #30796 · matplotlib/matplotlib
Description: Documentation Link https://matplotlib.org/devdocs/users/explain/colors/colormaps.html https://matplotlib.org/devdocs/gallery/color/colormap_reference.html Problem Previous versions of the pyplot documentation (pre-3.5) included a list of...
Open Graph Description: Documentation Link https://matplotlib.org/devdocs/users/explain/colors/colormaps.html https://matplotlib.org/devdocs/gallery/color/colormap_reference.html Problem Previous versions of the pyplot do...
X Description: Documentation Link https://matplotlib.org/devdocs/users/explain/colors/colormaps.html https://matplotlib.org/devdocs/gallery/color/colormap_reference.html Problem Previous versions of the pyplot do...
Opengraph URL: https://github.com/matplotlib/matplotlib/issues/30796
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Doc]: Information about deprecated colormaps missing from recent versions of the documentation","articleBody":"### Documentation Link\n\nhttps://matplotlib.org/devdocs/users/explain/colors/colormaps.html\nhttps://matplotlib.org/devdocs/gallery/color/colormap_reference.html\n\n### Problem\n\nPrevious versions of the pyplot documentation (pre-3.5) [included a list of all the available colormaps, with descriptions](https://matplotlib.org/3.4.3/api/pyplot_summary.html?highlight=colormaps#matplotlib.pyplot.colormaps), and notably included the information that `gist_gray`, `gist_yarg` and `binary` are deprecated, and are identical to `gray` or `gray_r`.\n\nThis information was generated from a docstring that was removed in [this pull request](https://github.com/matplotlib/matplotlib/pull/20935), where it was [concluded that it was unnecessary to keep it because the same information is covered elsewhere](https://github.com/matplotlib/matplotlib/pull/20935#discussion_r704124264). However, as far as I can see, the information about the deprecation / redundancy of these colormaps is nowhere to be found in the modern documentation.\n\nI ran into this issue because I work on scientific software that provides colormaps and uses matplotlib's selection as a reference -- we probably don't want to include colormaps that are just duplicates. I was sure that I saw the information about these three colormaps *somewhere*, and fell down a rabbithole trying to figure out when and why it was removed and whether it was still accurate.\n\n### Suggested improvement\n\nRestore the information about the deprecated colormaps somewhere in the docs, either in the [tutorial](https://matplotlib.org/devdocs/users/explain/colors/colormaps.html) or in the [reference](https://matplotlib.org/devdocs/gallery/color/colormap_reference.html).","author":{"url":"https://github.com/confluence","@type":"Person","name":"confluence"},"datePublished":"2025-11-28T14:26:39.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/30796/matplotlib/issues/30796"}
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:573e4b89-bc31-8020-c6d4-b843e819e253 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | E574:121C80:3F664:554BE:6A5250E0 |
| html-safe-nonce | 59d9604386b3c148cfdef0e87d8f2d464fbdb8a0a4ac7bc5f30edf61a6e44f35 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFNTc0OjEyMUM4MDozRjY2NDo1NTRCRTo2QTUyNTBFMCIsInZpc2l0b3JfaWQiOiI4MDE1MTc3OTIxMjk0NjUxNjE2IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | e52521bef40ed1a8f538ceb1d3aae8a65794483b15610339b068c90065860de9 |
| hovercard-subject-tag | issue:3675102333 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/matplotlib/matplotlib/30796/issue_layout |
| twitter:image | https://opengraph.githubassets.com/a855a00903919b71e628fd632b534ba423c76685eb83b138305b5c8c7236c355/matplotlib/matplotlib/issues/30796 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/a855a00903919b71e628fd632b534ba423c76685eb83b138305b5c8c7236c355/matplotlib/matplotlib/issues/30796 |
| og:image:alt | Documentation Link https://matplotlib.org/devdocs/users/explain/colors/colormaps.html https://matplotlib.org/devdocs/gallery/color/colormap_reference.html Problem Previous versions of the pyplot do... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | confluence |
| hostname | github.com |
| expected-hostname | github.com |
| None | b9a586c06a05a7a86fc7e3f4dbd03e42f6869085879aa184aa6369456dbd50fb |
| turbo-cache-control | no-preview |
| go-import | github.com/matplotlib/matplotlib git https://github.com/matplotlib/matplotlib.git |
| octolytics-dimension-user_id | 215947 |
| octolytics-dimension-user_login | matplotlib |
| octolytics-dimension-repository_id | 1385122 |
| octolytics-dimension-repository_nwo | matplotlib/matplotlib |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1385122 |
| octolytics-dimension-repository_network_root_nwo | matplotlib/matplotlib |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 7aed05249554b889eb33d002851a973eebcc7e91 |
| ui-target | canary-1 |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width