matplotlib.pyplot.thetagrids

matplotlib.pyplot.thetagrids(angles=None, labels=None, fmt=None, **kwargs)[source]

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

Call signatures:

lines, labels = thetagrids()
lines, labels = thetagrids(angles, labels=None, fmt=None, **kwargs)

When called with no arguments, thetagrids simply returns the tuple (lines, labels). When called with arguments, the labels will appear at the specified angles.

Parameters:

anglestuple with floats, degrees

The angles of the theta gridlines.

labelstuple with strings or None

The labels to use at each radial gridline. The projections.polar.ThetaFormatter will be used if None.

fmtstr or None

Format string used in matplotlib.ticker.FormatStrFormatter. For example '%f'. Note that the angle in radians will be used.

Returns:

lineslist of lines.Line2D

The theta gridlines.

labelslist of text.Text

The tick labels.

Other Parameters:

**kwargs

kwargs are optional Text properties for the labels.

See also

pyplot.rgrids

projections.polar.PolarAxes.set_thetagrids

Axis.get_gridlines

Axis.get_ticklabels

Examples

# set the locations of the angular gridlines
lines, labels = thetagrids(range(45, 360, 90))

# set the locations and labels of the angular gridlines
lines, labels = thetagrids(range(45, 360, 90), ('NE', 'NW', 'SW', 'SE'))