[ENH]: Add long names for markers · Issue #29671 · matplotlib/matplotlib · GitHub
Skip to content

[ENH]: Add long names for markers #29671

Description

@timhoffm

Problem

Suggested in #29646 (comment)

In addition to the single-char (and in rare cases int) marker definitions, we should also support long names "o" -> "circle". These long names should be supported wherever the short mnemonics are, with the exception of the fmt string syntax in plot() - that should still only accept single chars.

This allows more readable code marker="tri_up" instead of marker="2". It also opens a route for deprecating the int markers, which create trouble for parsing/validating.

Proposed solution

The long names should mostly be the ones from the "description" column in https://matplotlib.org/devdocs/api/markers_api.html#module-matplotlib.markers, with some slight adjustments:

  • "filled_plus" instead of "plus (filled)"
  • do not include "nothing" - we already have more than enough no-marker definitions.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions