### Navigation

- index
- modules |
- next |
- previous |
- home|
- examples|
- tutorials|
- pyplot|
- docs »
- The Matplotlib API »
- matplotlib.pyplot »

# matplotlib.pyplot.rgrids

`matplotlib.pyplot.``rgrids`(*args, **kwargs)

  Get or set the radial gridlines on a polar plot.

  call signatures:

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

  When called with no arguments, `rgrid()` simply returns the tuple (lines, labels), where lines is an array of radial gridlines (`Line2D` instances) and labels is an array of tick labels (`Text` instances). When called with arguments, the labels will appear at the specified radial distances and angles.

  labels, if not None, is a len(radii) list of strings of the labels to use at each angle.

  If labels is None, the rformatter will be used

  Examples:

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

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