mpl_toolkits.axisartist.axis_artist.AxisArtist

class mpl_toolkits.axisartist.axis_artist.AxisArtist(axes, helper, offset=None, axis_direction='bottom', **kw) [source]

Bases: matplotlib.artist.Artist

An artist which draws axis (a line along which the n-th axes coord is constant) line, ticks, ticklabels, and axis label.

axes : axes helper : an AxisArtistHelper instance.

LABELPAD

ZORDER = 2.5

draw(renderer) [source]

Draw the axis lines, tick lines and labels

get_axisline_style() [source]

return the current axisline style.

get_helper() [source]

Return axis artist helper instance.

get_tightbbox(renderer) [source]

Like Artist.get_window_extent, but includes any clipping.

Parameters:	renderer : RendererBase instance renderer that will be used to draw the figures (i.e. fig.canvas.get_renderer())
Returns:	bbox : BboxBase containing the bounding box (in figure pixel co-ordinates).

get_transform() [source]

Return the Transform instance used by this artist.

invert_ticklabel_direction() [source]

set_axis_direction(axis_direction) [source]

Adjust the direction, text angle, text alignment of ticklabels, labels following the matplotlib convention for the rectangle axes.

The axis_direction must be one of [left, right, bottom, top].

property	left	bottom	right	top
ticklabels location	"-"	"+"	"+"	"-"
axislabel location	"-"	"+"	"+"	"-"
ticklabels angle	90	0	-90	180
ticklabel va	center	baseline	center	baseline
ticklabel ha	right	center	right	center
axislabel angle	180	0	0	180
axislabel va	center	top	center	bottom
axislabel ha	right	center	right	center

Note that the direction "+" and "-" are relative to the direction of the increasing coordinate. Also, the text angles are actually relative to (90 + angle of the direction to the ticklabel), which gives 0 for bottom axis.

set_axislabel_direction(label_direction) [source]

Adjust the direction of the axislabel.

Note that the label_directions '+' and '-' are relative to the direction of the increasing coordinate.

Parameters:	tick_direction : {"+", "-"}

set_axisline_style(axisline_style=None, **kw) [source]

Set the axisline style.

axisline_style can be a string with axisline style name with optional

comma-separated attributes. Alternatively, the attrs can be provided as keywords.

set_arrowstyle("->,size=1.5") set_arrowstyle("->", size=1.5)

Old attrs simply are forgotten.

Without argument (or with arrowstyle=None), return available styles as a list of strings.

set_label(s) [source]

Set the label to s for auto legend.

Parameters:	s : object s will be converted to a string by calling str.

set_ticklabel_direction(tick_direction) [source]

Adjust the direction of the ticklabel.

Note that the label_directions '+' and '-' are relative to the direction of the increasing coordinate.

Parameters:	tick_direction : {"+", "-"}

toggle(all=None, ticks=None, ticklabels=None, label=None) [source]

Toggle visibility of ticks, ticklabels, and (axis) label. To turn all off,

axis.toggle(all=False)

To turn all off but ticks on

axis.toggle(all=False, ticks=True)

To turn all on but (axis) label off

axis.toggle(all=True, label=False))