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


matplotlib.pyplot.rgrids(*args, **kwargs)[source]

Get or set the radial gridlines on the current polar plot.

Call signatures:

lines, labels = rgrids()
lines, labels = rgrids(radii, labels=None, angle=22.5, fmt=None, **kwargs)

When called with no arguments, rgrids simply returns the tuple (lines, labels). When called with arguments, the labels will appear at the specified radial distances and angle.

radii : tuple with floats

The radii for the radial gridlines

labels : tuple with strings or None

The labels to use at each radial gridline. The matplotlib.ticker.ScalarFormatter will be used if None.

angle : float

The angular position of the radius labels in degrees.

fmt : str or None

Format string used in matplotlib.ticker.FormatStrFormatter. For example '%f'.

lines, labels : list of lines.Line2D, list of text.Text

lines are the radial gridlines and labels are the tick labels.

Other Parameters:

kwargs are optional Text properties for the labels.


# set the locations of the radial gridlines
lines, labels = rgrids( (0.25, 0.5, 1.0) )

# set the locations and labels of the radial gridlines
lines, labels = rgrids( (0.25, 0.5, 1.0), ('Tom', 'Dick', 'Harry' ))