You are reading an old version of the documentation (v3.1.0). For the latest version see
Version 3.1.0
Fork me on GitHub

Table of Contents

mpl_toolkits.axisartist.axis_artist module provides axis-related artists. They are

  • axis line
  • tick lines
  • tick labels
  • axis label
  • grid lines

The main artist classes are AxisArtist and GridlinesCollection. While GridlinesCollection is responsible for drawing grid lines, AxisArtist is responsible for all other artists. AxisArtist has attributes that are associated with each type of artists:

  • line: axis line
  • major_ticks: major tick lines
  • major_ticklabels: major tick labels
  • minor_ticks: minor tick lines
  • minor_ticklabels: minor tick labels
  • label: axis label

Typically, the AxisArtist associated with an axes will be accessed with the axis dictionary of the axes, i.e., the AxisArtist for the bottom axis is


where ax is an instance of mpl_toolkits.axislines.Axes. Thus, ax.axis["bottom"].line is an artist associated with the axis line, and ax.axis["bottom"].major_ticks is an artist associated with the major tick lines.

You can change the colors, fonts, line widths, etc. of these artists by calling suitable set method. For example, to change the color of the major ticks of the bottom axis to red, use


However, things like the locations of ticks, and their ticklabels need to be changed from the side of the grid_helper.


AxisArtist, AxisLabel, TickLabels have an axis_direction attribute, which adjusts the location, angle, etc.,. The axis_direction must be one of "left", "right", "bottom", "top", and follows the Matplotlib convention for rectangular axis.

For example, for the bottom axis (the left and right is relative to the direction of the increasing coordinate),

  • ticklabels and axislabel are on the right
  • ticklabels and axislabel have text angle of 0
  • ticklabels are baseline, center-aligned
  • axislabel is top, center-aligned

The text angles are actually relative to (90 + angle of the direction to the ticklabel), which gives 0 for bottom axis.

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

Ticks are by default direct opposite side of the ticklabels. To make ticks to the same side of the ticklabels,


The following attributes can be customized (use the set_xxx methods):


AttributeCopier(ref_artist[, klass])
AxisArtist(axes, helper[, offset, ...]) An artist which draws axis (a line along which the n-th axes coord is constant) line, ticks, ticklabels, and axis label.
AxisLabel(*args[, axis_direction, axis]) Axis Label.
BezierPath(path, *args, **kwargs)
GridlinesCollection(*args[, which, axis]) which : "major" or "minor" axis : "both", "x" or "y"
LabelBase(*args, **kwargs) A base class for AxisLabel and TickLabels.
TickLabels(*[, axis_direction]) Tick Labels.
Ticks(ticksize[, tick_out, axis]) Ticks are derived from Line2D, and note that ticks themselves are markers.