Section Navigation

API Reference
matplotlib.markers

`matplotlib.markers`#

Functions to handle markers; used by the marker functionality of plot, scatter, and errorbar.

All possible markers are defined here:

marker	symbol	description
`"."`	[m00]	point
`","`	[m01]	pixel
`"o"`	[m02]	circle
`"v"`	[m03]	triangle_down
`"^"`	[m04]	triangle_up
`"<"`	[m05]	triangle_left
`">"`	[m06]	triangle_right
`"1"`	[m07]	tri_down
`"2"`	[m08]	tri_up
`"3"`	[m09]	tri_left
`"4"`	[m10]	tri_right
`"8"`	[m11]	octagon
`"s"`	[m12]	square
`"p"`	[m13]	pentagon
`"P"`	[m23]	plus (filled)
`"*"`	[m14]	star
`"h"`	[m15]	hexagon1
`"H"`	[m16]	hexagon2
`"+"`	[m17]	plus
`"x"`	[m18]	x
`"X"`	[m24]	x (filled)
`"D"`	[m19]	diamond
`"d"`	[m20]	thin_diamond
`"\|"`	[m21]	vline
`"_"`	[m22]	hline
`0` (`TICKLEFT`)	[m25]	tickleft
`1` (`TICKRIGHT`)	[m26]	tickright
`2` (`TICKUP`)	[m27]	tickup
`3` (`TICKDOWN`)	[m28]	tickdown
`4` (`CARETLEFT`)	[m29]	caretleft
`5` (`CARETRIGHT`)	[m30]	caretright
`6` (`CARETUP`)	[m31]	caretup
`7` (`CARETDOWN`)	[m32]	caretdown
`8` (`CARETLEFTBASE`)	[m33]	caretleft (centered at base)
`9` (`CARETRIGHTBASE`)	[m34]	caretright (centered at base)
`10` (`CARETUPBASE`)	[m35]	caretup (centered at base)
`11` (`CARETDOWNBASE`)	[m36]	caretdown (centered at base)
`"none"` or `"None"`		nothing
`" "` or `""`		nothing
`"$...$"`	[m37]	Render the string using mathtext. E.g `"$f$"` for marker showing the letter `f`.
`verts`		A list of (x, y) pairs used for Path vertices. The center of the marker is located at (0, 0) and the size is normalized, such that the created path is encapsulated inside the unit cell.
`path`		A `Path` instance.
`(numsides, 0, angle)`		A regular polygon with `numsides` sides, rotated by `angle`.
`(numsides, 1, angle)`		A star-like symbol with `numsides` sides, rotated by `angle`.
`(numsides, 2, angle)`		An asterisk with `numsides` sides, rotated by `angle`.

Note that special symbols can be defined via the STIX math font, e.g. "$\u266B$". For an overview over the STIX font symbols refer to the STIX font table. Also see the STIX Fonts.

Integer numbers from 0 to 11 create lines and triangles. Those are equally accessible via capitalized variables, like CARETDOWNBASE. Hence the following are equivalent:

plt.plot([1, 2, 3], marker=11)
plt.plot([1, 2, 3], marker=matplotlib.markers.CARETDOWNBASE)

Markers join and cap styles can be customized by creating a new instance of MarkerStyle. A MarkerStyle can also have a custom Transform allowing it to be arbitrarily rotated or offset.

Examples showing the use of markers:

Classes#

MarkerStyle(marker[,fillstyle,transform,...])

A class representing marker types.

matplotlib.markers#

Classes#

`matplotlib.markers`#