matplotlib.markers.MarkerStyle

class matplotlib.markers.MarkerStyle(marker=None, fillstyle=None)[source]

Bases: object

A class representing marker types.

Instances are immutable. If you need to change anything, create a new instance.

Attributes:
markerslist

All known markers.

filled_markerslist

All known filled markers. This is a subset of markers.

fillstyleslist

The supported fillstyles.

Parameters:
markerstr, array-like, Path, MarkerStyle, or None, default: None
  • Another instance of MarkerStyle copies the details of that marker.
  • None means no marker.
  • For other possible marker values see the module docstring matplotlib.markers.
fillstylestr, default: 'full'

One of 'full', 'left', 'right', 'bottom', 'top', 'none'.

__bool__()[source]
__dict__ = mappingproxy({'__module__': 'matplotlib.markers', '__doc__': '\n    A class representing marker types.\n\n    Instances are immutable. If you need to change anything, create a new\n    instance.\n\n    Attributes\n    ----------\n    markers : list\n        All known markers.\n    filled_markers : list\n        All known filled markers. This is a subset of *markers*.\n    fillstyles : list\n        The supported fillstyles.\n    ', 'markers': {'.': 'point', ',': 'pixel', 'o': 'circle', 'v': 'triangle_down', '^': 'triangle_up', '<': 'triangle_left', '>': 'triangle_right', '1': 'tri_down', '2': 'tri_up', '3': 'tri_left', '4': 'tri_right', '8': 'octagon', 's': 'square', 'p': 'pentagon', '*': 'star', 'h': 'hexagon1', 'H': 'hexagon2', '+': 'plus', 'x': 'x', 'D': 'diamond', 'd': 'thin_diamond', '|': 'vline', '_': 'hline', 'P': 'plus_filled', 'X': 'x_filled', 0: 'tickleft', 1: 'tickright', 2: 'tickup', 3: 'tickdown', 4: 'caretleft', 5: 'caretright', 6: 'caretup', 7: 'caretdown', 8: 'caretleftbase', 9: 'caretrightbase', 10: 'caretupbase', 11: 'caretdownbase', 'None': 'nothing', None: 'nothing', ' ': 'nothing', '': 'nothing'}, 'filled_markers': ('o', 'v', '^', '<', '>', '8', 's', 'p', '*', 'h', 'H', 'D', 'd', 'P', 'X'), 'fillstyles': ('full', 'left', 'right', 'bottom', 'top', 'none'), '_half_fillstyles': ('left', 'right', 'bottom', 'top'), '_point_size_reduction': 0.5, '__init__': <function MarkerStyle.__init__>, '_recache': <function MarkerStyle._recache>, '__bool__': <function MarkerStyle.__bool__>, 'is_filled': <function MarkerStyle.is_filled>, 'get_fillstyle': <function MarkerStyle.get_fillstyle>, 'set_fillstyle': <function MarkerStyle.set_fillstyle>, '_set_fillstyle': <function MarkerStyle._set_fillstyle>, 'get_joinstyle': <function MarkerStyle.get_joinstyle>, 'get_capstyle': <function MarkerStyle.get_capstyle>, 'get_marker': <function MarkerStyle.get_marker>, 'set_marker': <function MarkerStyle.set_marker>, '_set_marker': <function MarkerStyle._set_marker>, 'get_path': <function MarkerStyle.get_path>, 'get_transform': <function MarkerStyle.get_transform>, 'get_alt_path': <function MarkerStyle.get_alt_path>, 'get_alt_transform': <function MarkerStyle.get_alt_transform>, 'get_snap_threshold': <function MarkerStyle.get_snap_threshold>, '_set_nothing': <function MarkerStyle._set_nothing>, '_set_custom_marker': <function MarkerStyle._set_custom_marker>, '_set_path_marker': <function MarkerStyle._set_path_marker>, '_set_vertices': <function MarkerStyle._set_vertices>, '_set_tuple_marker': <function MarkerStyle._set_tuple_marker>, '_set_mathtext_path': <function MarkerStyle._set_mathtext_path>, '_half_fill': <function MarkerStyle._half_fill>, '_set_circle': <function MarkerStyle._set_circle>, '_set_pixel': <function MarkerStyle._set_pixel>, '_set_point': <function MarkerStyle._set_point>, '_triangle_path': Path(array([[ 0.,  1.],        [-1., -1.],        [ 1., -1.],        [ 0.,  1.]]), array([ 1,  2,  2, 79], dtype=uint8)), '_triangle_path_u': Path(array([[ 0. ,  1. ],        [-0.6, -0.2],        [ 0.6, -0.2],        [ 0. ,  1. ]]), array([ 1,  2,  2, 79], dtype=uint8)), '_triangle_path_d': Path(array([[-0.6, -0.2],        [ 0.6, -0.2],        [ 1. , -1. ],        [-1. , -1. ],        [-0.6, -0.2]]), array([ 1,  2,  2,  2, 79], dtype=uint8)), '_triangle_path_l': Path(array([[ 0.,  1.],        [ 0., -1.],        [-1., -1.],        [ 0.,  1.]]), array([ 1,  2,  2, 79], dtype=uint8)), '_triangle_path_r': Path(array([[ 0.,  1.],        [ 0., -1.],        [ 1., -1.],        [ 0.,  1.]]), array([ 1,  2,  2, 79], dtype=uint8)), '_set_triangle': <function MarkerStyle._set_triangle>, '_set_triangle_up': <function MarkerStyle._set_triangle_up>, '_set_triangle_down': <function MarkerStyle._set_triangle_down>, '_set_triangle_left': <function MarkerStyle._set_triangle_left>, '_set_triangle_right': <function MarkerStyle._set_triangle_right>, '_set_square': <function MarkerStyle._set_square>, '_set_diamond': <function MarkerStyle._set_diamond>, '_set_thin_diamond': <function MarkerStyle._set_thin_diamond>, '_set_pentagon': <function MarkerStyle._set_pentagon>, '_set_star': <function MarkerStyle._set_star>, '_set_hexagon1': <function MarkerStyle._set_hexagon1>, '_set_hexagon2': <function MarkerStyle._set_hexagon2>, '_set_octagon': <function MarkerStyle._set_octagon>, '_line_marker_path': Path(array([[ 0., -1.],        [ 0.,  1.]]), None), '_set_vline': <function MarkerStyle._set_vline>, '_set_hline': <function MarkerStyle._set_hline>, '_tickhoriz_path': Path(array([[0., 0.],        [1., 0.]]), None), '_set_tickleft': <function MarkerStyle._set_tickleft>, '_set_tickright': <function MarkerStyle._set_tickright>, '_tickvert_path': Path(array([[-0.,  0.],        [-0.,  1.]]), None), '_set_tickup': <function MarkerStyle._set_tickup>, '_set_tickdown': <function MarkerStyle._set_tickdown>, '_tri_path': Path(array([[ 0. ,  0. ],        [ 0. , -1. ],        [ 0. ,  0. ],        [ 0.8,  0.5],        [ 0. ,  0. ],        [-0.8,  0.5]]), array([1, 2, 1, 2, 1, 2], dtype=uint8)), '_set_tri_down': <function MarkerStyle._set_tri_down>, '_set_tri_up': <function MarkerStyle._set_tri_up>, '_set_tri_left': <function MarkerStyle._set_tri_left>, '_set_tri_right': <function MarkerStyle._set_tri_right>, '_caret_path': Path(array([[-1. ,  1.5],        [ 0. ,  0. ],        [ 1. ,  1.5]]), None), '_set_caretdown': <function MarkerStyle._set_caretdown>, '_set_caretup': <function MarkerStyle._set_caretup>, '_set_caretleft': <function MarkerStyle._set_caretleft>, '_set_caretright': <function MarkerStyle._set_caretright>, '_caret_path_base': Path(array([[-1. ,  0. ],        [ 0. , -1.5],        [ 1. ,  0. ]]), None), '_set_caretdownbase': <function MarkerStyle._set_caretdownbase>, '_set_caretupbase': <function MarkerStyle._set_caretupbase>, '_set_caretleftbase': <function MarkerStyle._set_caretleftbase>, '_set_caretrightbase': <function MarkerStyle._set_caretrightbase>, '_plus_path': Path(array([[-1.,  0.],        [ 1.,  0.],        [ 0., -1.],        [ 0.,  1.]]), array([1, 2, 1, 2], dtype=uint8)), '_set_plus': <function MarkerStyle._set_plus>, '_x_path': Path(array([[-1., -1.],        [ 1.,  1.],        [-1.,  1.],        [ 1., -1.]]), array([1, 2, 1, 2], dtype=uint8)), '_set_x': <function MarkerStyle._set_x>, '_plus_filled_path': Path(array([[-0.16666667, -0.5       ],        [ 0.16666667, -0.5       ],        [ 0.16666667, -0.16666667],        [ 0.5       , -0.16666667],        [ 0.5       ,  0.16666667],        [ 0.16666667,  0.16666667],        [ 0.16666667,  0.5       ],        [-0.16666667,  0.5       ],        [-0.16666667,  0.16666667],        [-0.5       ,  0.16666667],        [-0.5       , -0.16666667],        [-0.16666667, -0.16666667],        [-0.16666667, -0.5       ]]), array([ 1,  2,  2,  2,  2,  2,  2,  2,  2,  2,  2,  2, 79], dtype=uint8)), '_plus_filled_path_t': Path(array([[ 0.5       ,  0.        ],        [ 0.5       ,  0.16666667],        [ 0.16666667,  0.16666667],        [ 0.16666667,  0.5       ],        [-0.16666667,  0.5       ],        [-0.16666667,  0.16666667],        [-0.5       ,  0.16666667],        [-0.5       ,  0.        ],        [ 0.5       ,  0.        ]]), array([ 1,  2,  2,  2,  2,  2,  2,  2, 79], dtype=uint8)), '_set_plus_filled': <function MarkerStyle._set_plus_filled>, '_x_filled_path': Path(array([[-0.25, -0.5 ],        [ 0.  , -0.25],        [ 0.25, -0.5 ],        [ 0.5 , -0.25],        [ 0.25,  0.  ],        [ 0.5 ,  0.25],        [ 0.25,  0.5 ],        [ 0.  ,  0.25],        [-0.25,  0.5 ],        [-0.5 ,  0.25],        [-0.25,  0.  ],        [-0.5 , -0.25],        [-0.25, -0.5 ]]), array([ 1,  2,  2,  2,  2,  2,  2,  2,  2,  2,  2,  2, 79], dtype=uint8)), '_x_filled_path_t': Path(array([[ 0.25,  0.  ],        [ 0.5 ,  0.25],        [ 0.25,  0.5 ],        [ 0.  ,  0.25],        [-0.25,  0.5 ],        [-0.5 ,  0.25],        [-0.25,  0.  ],        [ 0.25,  0.  ]]), array([ 1,  2,  2,  2,  2,  2,  2, 79], dtype=uint8)), '_set_x_filled': <function MarkerStyle._set_x_filled>, '__dict__': <attribute '__dict__' of 'MarkerStyle' objects>, '__weakref__': <attribute '__weakref__' of 'MarkerStyle' objects>, '__annotations__': {}})
__init__(marker=None, fillstyle=None)[source]
Parameters:
markerstr, array-like, Path, MarkerStyle, or None, default: None
  • Another instance of MarkerStyle copies the details of that marker.
  • None means no marker.
  • For other possible marker values see the module docstring matplotlib.markers.
fillstylestr, default: 'full'

One of 'full', 'left', 'right', 'bottom', 'top', 'none'.

__module__ = 'matplotlib.markers'
__weakref__

list of weak references to the object (if defined)

filled_markers = ('o', 'v', '^', '<', '>', '8', 's', 'p', '*', 'h', 'H', 'D', 'd', 'P', 'X')
fillstyles = ('full', 'left', 'right', 'bottom', 'top', 'none')
get_alt_path()[source]

Return a Path for the alternate part of the marker.

For unfilled markers, this is None; for filled markers, this is the area to be drawn with markerfacecoloralt.

get_alt_transform()[source]

Return the transform to be applied to the Path from MarkerStyle.get_alt_path().

get_capstyle()[source]
get_fillstyle()[source]
get_joinstyle()[source]
get_marker()[source]
get_path()[source]

Return a Path for the primary part of the marker.

For unfilled markers this is the whole marker, for filled markers, this is the area to be drawn with markerfacecolor.

get_snap_threshold()[source]
get_transform()[source]

Return the transform to be applied to the Path from MarkerStyle.get_path().

is_filled()[source]
markers = {'.': 'point', ',': 'pixel', 'o': 'circle', 'v': 'triangle_down', '^': 'triangle_up', '<': 'triangle_left', '>': 'triangle_right', '1': 'tri_down', '2': 'tri_up', '3': 'tri_left', '4': 'tri_right', '8': 'octagon', 's': 'square', 'p': 'pentagon', '*': 'star', 'h': 'hexagon1', 'H': 'hexagon2', '+': 'plus', 'x': 'x', 'D': 'diamond', 'd': 'thin_diamond', '|': 'vline', '_': 'hline', 'P': 'plus_filled', 'X': 'x_filled', 0: 'tickleft', 1: 'tickright', 2: 'tickup', 3: 'tickdown', 4: 'caretleft', 5: 'caretright', 6: 'caretup', 7: 'caretdown', 8: 'caretleftbase', 9: 'caretrightbase', 10: 'caretupbase', 11: 'caretdownbase', 'None': 'nothing', None: 'nothing', ' ': 'nothing', '': 'nothing'}
set_fillstyle(fillstyle)[source]

[Deprecated]

Notes

Deprecated since version 3.4:

set_marker(marker)[source]

[Deprecated]

Notes

Deprecated since version 3.4: