René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[MNT]: ListedColormap inconsistencies","articleBody":"### Summary\r\n\r\nThe documentation to `ListedColormap` states that the input should be a list or array\r\nhttps://github.com/matplotlib/matplotlib/blob/b01462c9ac7b0d3875892d6f40c9213c56f0864f/lib/matplotlib/colors.py#L1175-L1177\r\n\r\nHowever, when specifying *N*, `str` and `float` are also supported (if one use the source code)\r\nhttps://github.com/matplotlib/matplotlib/blob/b01462c9ac7b0d3875892d6f40c9213c56f0864f/lib/matplotlib/colors.py#L1199-L1214\r\n\r\nThis means that, e.g., `ListedColormap(\"#aabbcc\", N=1)` works, but `ListedColormap(\"#aabbcc\")` does not (there will be weird errors later, like `N=7` for the latter). Given that there is `monochrome` attribute and the documentation of *N*, one may expect the latter to work as well (if the earlier works). Also, `ListedColormap([\"#aabbcc\"])` will not set the `monochrome` attribute correctly.\r\n\r\n### Proposed fix\r\n\r\nI think there are three(?) possible solutions:\r\n* Support scalars/strings when *N* is not provided (and ideally documents that)\r\n* Document that if *N* is not None, the first argument can be a scalar or string (it is maybe easier to do `ListedColormap(0.3, N=7)` than `ListedColormap([0.3]*7)` or at least require slightly less Python knowledge)\r\n* Deprecate scalar/string argument\r\n\r\nBonus: document the `color` and `monochrome` attributes","author":{"url":"https://github.com/oscargus","@type":"Person","name":"oscargus"},"datePublished":"2024-08-29T09:04:27.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":5},"url":"https://github.com/28763/matplotlib/issues/28763"}