matplotlib.markers.MarkerStyle#

classmatplotlib.markers.MarkerStyle(marker,fillstyle=None,transform=None,capstyle=None,joinstyle=None)[source]#

Bases:object

A class representing marker types.

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

Attributes:

markersdict

All known markers.

filled_markerstuple

All known filled markers. This is a subset ofmarkers.

fillstylestuple

The supported fillstyles.

Parameters:

markerstr, array-like, Path, MarkerStyle

• Another instance ofMarkerStyle copies the details of thatmarker.

• For other possible marker values, see the module docstringmatplotlib.markers.

fillstylestr, default:rcParams["markers.fillstyle"] (default:'full')

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

transformTransform, optional

Transform that will be combined with the native transform of themarker.

capstyleCapStyle or %(CapStyle)s, optional

Cap style that will override the default cap style of the marker.

joinstyleJoinStyle or %(JoinStyle)s, optional

Join style that will override the default join style of the marker.

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 aPath for the alternate part of the marker.

For unfilled markers, this isNone; for filled markers, this is thearea to be drawn withmarkerfacecoloralt.

get_alt_transform()[source]#

Return the transform to be applied to thePath fromMarkerStyle.get_alt_path().

get_capstyle()[source]#

get_fillstyle()[source]#

get_joinstyle()[source]#

get_marker()[source]#

get_path()[source]#

Return aPath 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 withmarkerfacecolor.

get_snap_threshold()[source]#

get_transform()[source]#

Return the transform to be applied to thePath fromMarkerStyle.get_path().

get_user_transform()[source]#

Return user supplied part of marker transform.

is_filled()[source]#

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

rotated(*,deg=None,rad=None)[source]#

Return a new version of this marker rotated by specified angle.

Parameters:

degfloat, optional

Rotation angle in degrees.

radfloat, optional

Rotation angle in radians.

.. note:: You must specify exactly one of deg or rad.

scaled(sx,sy=None)[source]#

Return new marker scaled by specified scale factors.

Ifsy is not given, the same scale is applied in both thex- andy-directions.

Parameters:

sxfloat

X-direction scaling factor.

syfloat, optional

Y-direction scaling factor.

transformed(transform)[source]#

Return a new version of this marker with the transform applied.

Parameters:

transformAffine2D

Transform will be combined with current user supplied transform.

Examples usingmatplotlib.markers.MarkerStyle#

Marker reference

Marker reference

Mapping marker properties to multivariate data

Mapping marker properties to multivariate data

Ellipse with orientation arrow demo

Ellipse with orientation arrow demo