matplotlib.projections.polar — Matplotlib 3.10.3 documentation (original) (raw)

class matplotlib.projections.polar.InvertedPolarTransform(axis=None, use_rmin=True, *, apply_theta_transforms=True)[source]#

Bases: Transform

The inverse of the polar transform, mapping Cartesian coordinate space x and y back to theta and r.

Parameters:

axisAxis, optional

Axis associated with this transform. This is used to get the minimum radial limit.

use_rminbool, optional

If True, add the minimum radial axis limit after transforming from Cartesian coordinates. axis must also be specified for this to take effect.

has_inverse = True#

True if this transform has a corresponding inverse transform.

input_dims = 2#

The number of input dimensions of this transform. Must be overridden (with integers) in the subclass.

inverted()[source]#

Return the corresponding inverse transformation.

It holds x == self.inverted().transform(self.transform(x)).

The return value of this method should be treated as temporary. An update to self does not cause a corresponding update to its inverted copy.

output_dims = 2#

The number of output dimensions of this transform. Must be overridden (with integers) in the subclass.

transform_non_affine(values)[source]#

Apply only the non-affine part of this transformation.

transform(values) is always equivalent totransform_affine(transform_non_affine(values)).

In non-affine transformations, this is generally equivalent totransform(values). In affine transformations, this is always a no-op.

Parameters:

valuesarray

The input values as an array of length input_dims or shape (N, input_dims).

Returns:

array

The output values as an array of length output_dims or shape (N, output_dims), depending on the input.

class matplotlib.projections.polar.PolarAffine(scale_transform, limits)[source]#

Bases: Affine2DBase

The affine part of the polar projection.

Scales the output so that maximum radius rests on the edge of the Axes circle and the origin is mapped to (0.5, 0.5). The transform applied is the same to x and y components and given by:

\[x_{1} = 0.5 \left [ \frac{x_{0}}{(r_{\max} - r_{\min})} + 1 \right ]\]

\(r_{\min}, r_{\max}\) are the minimum and maximum radial limits after any scaling (e.g. log scaling) has been removed.

Parameters:

scale_transformTransform

Scaling transform for the data. This is used to remove any scaling from the radial view limits.

limitsBboxBase

View limits of the data. The only part of its bounds that is used is the y limits (for the radius limits).

get_matrix()[source]#

Get the matrix for the affine part of this transform.

class matplotlib.projections.polar.PolarAxes(*args, theta_offset=0, theta_direction=1, rlabel_position=22.5, **kwargs)[source]#

Bases: Axes

A polar graph projection, where the input dimensions are theta, r.

Theta starts pointing east and goes anti-clockwise.

Build an Axes in a figure.

Parameters:

figFigure

The Axes is built in the Figure fig.

*args

*args can be a single (left, bottom, width, height)rectangle or a single Bbox. This specifies the rectangle (in figure coordinates) where the Axes is positioned.

*args can also consist of three numbers or a single three-digit number; in the latter case, the digits are considered as independent numbers. The numbers are interpreted as (nrows, ncols, index): (nrows, ncols) specifies the size of an array of subplots, and index is the 1-based index of the subplot being created. Finally, *args can also directly be aSubplotSpec instance.

sharex, shareyAxes, optional

The x- or y-axis is shared with the x- or y-axis in the input Axes. Note that it is not possible to unshare axes.

frameonbool, default: True

Whether the Axes frame is visible.

box_aspectfloat, optional

Set a fixed aspect for the Axes box, i.e. the ratio of height to width. See set_box_aspect for details.

forward_navigation_eventsbool or "auto", default: "auto"

Control whether pan/zoom events are passed through to Axes below this one. "auto" is True for axes with an invisible patch and_False_ otherwise.

**kwargs

Other optional keyword arguments:

Returns:

Axes

The new Axes object.

class InvertedPolarTransform(axis=None, use_rmin=True, *, apply_theta_transforms=True)[source]#

Bases: Transform

The inverse of the polar transform, mapping Cartesian coordinate space x and y back to theta and r.

Parameters:

axisAxis, optional

Axis associated with this transform. This is used to get the minimum radial limit.

use_rminbool, optional

If True, add the minimum radial axis limit after transforming from Cartesian coordinates. axis must also be specified for this to take effect.

has_inverse = True#

True if this transform has a corresponding inverse transform.

input_dims = 2#

The number of input dimensions of this transform. Must be overridden (with integers) in the subclass.

inverted()[source]#

Return the corresponding inverse transformation.

It holds x == self.inverted().transform(self.transform(x)).

The return value of this method should be treated as temporary. An update to self does not cause a corresponding update to its inverted copy.

output_dims = 2#

The number of output dimensions of this transform. Must be overridden (with integers) in the subclass.

transform_non_affine(values)[source]#

Apply only the non-affine part of this transformation.

transform(values) is always equivalent totransform_affine(transform_non_affine(values)).

In non-affine transformations, this is generally equivalent totransform(values). In affine transformations, this is always a no-op.

Parameters:

valuesarray

The input values as an array of length input_dims or shape (N, input_dims).

Returns:

array

The output values as an array of length output_dims or shape (N, output_dims), depending on the input.

class PolarAffine(scale_transform, limits)[source]#

Bases: Affine2DBase

The affine part of the polar projection.

Scales the output so that maximum radius rests on the edge of the Axes circle and the origin is mapped to (0.5, 0.5). The transform applied is the same to x and y components and given by:

\[x_{1} = 0.5 \left [ \frac{x_{0}}{(r_{\max} - r_{\min})} + 1 \right ]\]

\(r_{\min}, r_{\max}\) are the minimum and maximum radial limits after any scaling (e.g. log scaling) has been removed.

Parameters:

scale_transformTransform

Scaling transform for the data. This is used to remove any scaling from the radial view limits.

limitsBboxBase

View limits of the data. The only part of its bounds that is used is the y limits (for the radius limits).

get_matrix()[source]#

Get the matrix for the affine part of this transform.

class PolarTransform(axis=None, use_rmin=True, *, apply_theta_transforms=True, scale_transform=None)[source]#

Bases: Transform

The base polar transform.

This transform maps polar coordinates \(\theta, r\) into Cartesian coordinates \(x, y = r \cos(\theta), r \sin(\theta)\)(but does not fully transform into Axes coordinates or handle positioning in screen space).

This transformation is designed to be applied to data after any scaling along the radial axis (e.g. log-scaling) has been applied to the input data.

Path segments at a fixed radius are automatically transformed to circular arcs as long as path._interpolation_steps > 1.

Parameters:

axisAxis, optional

Axis associated with this transform. This is used to get the minimum radial limit.

use_rminbool, optional

If True, subtract the minimum radial axis limit before transforming to Cartesian coordinates. axis must also be specified for this to take effect.

has_inverse = True#

True if this transform has a corresponding inverse transform.

input_dims = 2#

The number of input dimensions of this transform. Must be overridden (with integers) in the subclass.

inverted()[source]#

Return the corresponding inverse transformation.

It holds x == self.inverted().transform(self.transform(x)).

The return value of this method should be treated as temporary. An update to self does not cause a corresponding update to its inverted copy.

output_dims = 2#

The number of output dimensions of this transform. Must be overridden (with integers) in the subclass.

transform_non_affine(values)[source]#

Apply only the non-affine part of this transformation.

transform(values) is always equivalent totransform_affine(transform_non_affine(values)).

In non-affine transformations, this is generally equivalent totransform(values). In affine transformations, this is always a no-op.

Parameters:

valuesarray

The input values as an array of length input_dims or shape (N, input_dims).

Returns:

array

The output values as an array of length output_dims or shape (N, output_dims), depending on the input.

transform_path_non_affine(path)[source]#

Apply the non-affine part of this transform to Path path, returning a new Path.

transform_path(path) is equivalent totransform_path_affine(transform_path_non_affine(values)).

class RadialLocator(base, axes=None)[source]#

Bases: Locator

Used to locate radius ticks.

Ensures that all ticks are strictly positive. For all other tasks, it delegates to the base Locator (which may be different depending on the scale of the _r_-axis).

nonsingular(vmin, vmax)[source]#

Adjust a range as needed to avoid singularities.

This method gets called during autoscaling, with (v0, v1) set to the data limits on the Axes if the Axes contains any data, or(-inf, +inf) if not.

set_axis(axis)[source]#

view_limits(vmin, vmax)[source]#

Select a scale for the range from vmin to vmax.

Subclasses should override this method to change locator behaviour.

class ThetaFormatter[source]#

Bases: Formatter

Used to format the theta tick labels. Converts the native unit of radians into degrees and adds a degree symbol.

class ThetaLocator(base)[source]#

Bases: Locator

Used to locate theta ticks.

This will work the same as the base locator except in the case that the view spans the entire circle. In such cases, the previously used default locations of every 45 degrees are returned.

set_axis(axis)[source]#

view_limits(vmin, vmax)[source]#

Select a scale for the range from vmin to vmax.

Subclasses should override this method to change locator behaviour.

can_pan()[source]#

Return whether this Axes supports the pan/zoom button functionality.

For a polar Axes, this is slightly misleading. Both panning and zooming are performed by the same button. Panning is performed in azimuth while zooming is done along the radial.

can_zoom()[source]#

Return whether this Axes supports the zoom box button functionality.

A polar Axes does not support zoom boxes.

clear()[source]#

Clear the Axes.

drag_pan(button, key, x, y)[source]#

Called when the mouse moves during a pan operation.

Parameters:

buttonMouseButton

The pressed mouse button.

keystr or None

The pressed key, if any.

x, yfloat

The mouse coordinates in display coords.

Notes

This is intended to be overridden by new projection types.

draw(renderer)[source]#

Draw the Artist (and its children) using the given renderer.

This has no effect if the artist is not visible (Artist.get_visiblereturns False).

Parameters:

rendererRendererBase subclass.

Notes

This method is overridden in the Artist subclasses.

end_pan()[source]#

Called when a pan operation completes (when the mouse button is up.)

Notes

This is intended to be overridden by new projection types.

format_coord(theta, r)[source]#

Return a format string formatting the x, y coordinates.

get_data_ratio()[source]#

Return the aspect ratio of the data itself. For a polar plot, this should always be 1.0

get_rlabel_position()[source]#

Returns:

float

The theta position of the radius labels in degrees.

get_rmax()[source]#

Returns:

float

Outer radial limit.

get_rmin()[source]#

Returns:

float

The inner radial limit.

get_rorigin()[source]#

Returns:

float

get_rsign()[source]#

get_theta_direction()[source]#

Get the direction in which theta increases.

-1:

Theta increases in the clockwise direction

1:

Theta increases in the counterclockwise direction

get_theta_offset()[source]#

Get the offset for the location of 0 in radians.

get_thetamax()[source]#

Return the maximum theta limit in degrees.

get_thetamin()[source]#

Get the minimum theta limit in degrees.

get_xaxis_text1_transform(pad)[source]#

Returns:

transformTransform

The transform used for drawing x-axis labels, which will add_pad_points_ of padding (in points) between the axis and the label. The x-direction is in data coordinates and the y-direction is in axis coordinates

valign{'center', 'top', 'bottom', 'baseline', 'center_baseline'}

The text vertical alignment.

halign{'center', 'left', 'right'}

The text horizontal alignment.

Notes

This transformation is primarily used by the Axisclass, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations.

get_xaxis_text2_transform(pad)[source]#

Returns:

transformTransform

The transform used for drawing secondary x-axis labels, which will add pad_points of padding (in points) between the axis and the label. The x-direction is in data coordinates and the y-direction is in axis coordinates

valign{'center', 'top', 'bottom', 'baseline', 'center_baseline'}

The text vertical alignment.

halign{'center', 'left', 'right'}

The text horizontal alignment.

Notes

This transformation is primarily used by the Axisclass, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations.

get_xaxis_transform(which='grid')[source]#

Get the transformation used for drawing x-axis labels, ticks and gridlines. The x-direction is in data coordinates and the y-direction is in axis coordinates.

Note

This transformation is primarily used by theAxis class, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations.

Parameters:

which{'grid', 'tick1', 'tick2'}

get_yaxis_text1_transform(pad)[source]#

Returns:

transformTransform

The transform used for drawing y-axis labels, which will add_pad_points_ of padding (in points) between the axis and the label. The x-direction is in axis coordinates and the y-direction is in data coordinates

valign{'center', 'top', 'bottom', 'baseline', 'center_baseline'}

The text vertical alignment.

halign{'center', 'left', 'right'}

The text horizontal alignment.

Notes

This transformation is primarily used by the Axisclass, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations.

get_yaxis_text2_transform(pad)[source]#

Returns:

transformTransform

The transform used for drawing secondart y-axis labels, which will add pad_points of padding (in points) between the axis and the label. The x-direction is in axis coordinates and the y-direction is in data coordinates

valign{'center', 'top', 'bottom', 'baseline', 'center_baseline'}

The text vertical alignment.

halign{'center', 'left', 'right'}

The text horizontal alignment.

Notes

This transformation is primarily used by the Axisclass, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations.

get_yaxis_transform(which='grid')[source]#

Get the transformation used for drawing y-axis labels, ticks and gridlines. The x-direction is in axis coordinates and the y-direction is in data coordinates.

Note

This transformation is primarily used by theAxis class, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations.

Parameters:

which{'grid', 'tick1', 'tick2'}

name = 'polar'#

set(*, adjustable=, agg_filter=, alpha=, anchor=, animated=, aspect=, autoscale_on=, autoscalex_on=, autoscaley_on=, axes_locator=, axisbelow=, box_aspect=, clip_box=, clip_on=, clip_path=, facecolor=, forward_navigation_events=, frame_on=, gid=, in_layout=, label=, mouseover=, navigate=, path_effects=, picker=, position=, prop_cycle=, rasterization_zorder=, rasterized=, rgrids=, rlabel_position=, rlim=, rmax=, rmin=, rorigin=, rscale=, rticks=, sketch_params=, snap=, subplotspec=, theta_direction=, theta_offset=, theta_zero_location=, thetagrids=, thetalim=, thetamax=, thetamin=, title=, transform=, url=, visible=, xbound=, xlabel=, xlim=, xmargin=, xscale=, xticklabels=, xticks=, ybound=, ylabel=, ylim=, ymargin=, yscale=, yticklabels=, yticks=, zorder=)[source]#

Set multiple properties at once.

Supported properties are

set_rgrids(radii, labels=None, angle=None, fmt=None, **kwargs)[source]#

Set the radial gridlines on a polar plot.

Parameters:

radiituple with floats

The radii for the radial gridlines

labelstuple with strings or None

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

anglefloat

The angular position of the radius labels in degrees.

fmtstr or None

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

Returns:

lineslist of lines.Line2D

The radial gridlines.

labelslist of text.Text

The tick labels.

Other Parameters:

**kwargs

kwargs are optional Text properties for the labels.

Warning

This only sets the properties of the current ticks. Ticks are not guaranteed to be persistent. Various operations can create, delete and modify the Tick instances. There is an imminent risk that these settings can get lost if you work on the figure further (including also panning/zooming on a displayed figure).

Use set_tick_params instead if possible.

set_rlabel_position(value)[source]#

Update the theta position of the radius labels.

Parameters:

valuenumber

The angular position of the radius labels in degrees.

set_rlim(bottom=None, top=None, *, emit=True, auto=False, **kwargs)[source]#

Set the radial axis view limits.

This function behaves like Axes.set_ylim, but additionally supports_rmin_ and rmax as aliases for bottom and top.

set_rmax(rmax)[source]#

Set the outer radial limit.

Parameters:

rmaxfloat

set_rmin(rmin)[source]#

Set the inner radial limit.

Parameters:

rminfloat

set_rorigin(rorigin)[source]#

Update the radial origin.

Parameters:

roriginfloat

set_rscale(*args, **kwargs)[source]#

set_rticks(*args, **kwargs)[source]#

set_theta_direction(direction)[source]#

Set the direction in which theta increases.

clockwise, -1:

Theta increases in the clockwise direction

counterclockwise, anticlockwise, 1:

Theta increases in the counterclockwise direction

set_theta_offset(offset)[source]#

Set the offset for the location of 0 in radians.

set_theta_zero_location(loc, offset=0.0)[source]#

Set the location of theta's zero.

This simply calls set_theta_offset with the correct value in radians.

Parameters:

locstr

May be one of "N", "NW", "W", "SW", "S", "SE", "E", or "NE".

offsetfloat, default: 0

An offset in degrees to apply from the specified loc. **Note:**this offset is always applied counter-clockwise regardless of the direction setting.

set_thetagrids(angles, labels=None, fmt=None, **kwargs)[source]#

Set the theta gridlines in a polar plot.

Parameters:

anglestuple with floats, degrees

The angles of the theta gridlines.

labelstuple with strings or None

The labels to use at each theta gridline. Theprojections.polar.ThetaFormatter will be used if None.

fmtstr or None

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

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.

Warning

This only sets the properties of the current ticks. Ticks are not guaranteed to be persistent. Various operations can create, delete and modify the Tick instances. There is an imminent risk that these settings can get lost if you work on the figure further (including also panning/zooming on a displayed figure).

Use set_tick_params instead if possible.

set_thetalim(*args, **kwargs)[source]#

Set the minimum and maximum theta values.

Can take the following signatures:

where minval and maxval are the minimum and maximum limits. Values are wrapped in to the range \([0, 2\pi]\) (in radians), so for example it is possible to do set_thetalim(-np.pi / 2, np.pi / 2) to have an axis symmetric around 0. A ValueError is raised if the absolute angle difference is larger than a full circle.

set_thetamax(thetamax)[source]#

Set the maximum theta limit in degrees.

set_thetamin(thetamin)[source]#

Set the minimum theta limit in degrees.

set_yscale(*args, **kwargs)[source]#

Set the yaxis' scale.

Parameters:

valuestr or ScaleBase

The axis scale type to apply. Valid string values are the names of scale classes ("linear", "log", "function",...). These may be the names of any of the built-in scales or of any custom scales registered using matplotlib.scale.register_scale.

**kwargs

If value is a string, keywords are passed to the instantiation method of the respective class.

start_pan(x, y, button)[source]#

Called when a pan operation has started.

Parameters:

x, yfloat

The mouse coordinates in display coords.

buttonMouseButton

The pressed mouse button.

Notes

This is intended to be overridden by new projection types.

class matplotlib.projections.polar.PolarTransform(axis=None, use_rmin=True, *, apply_theta_transforms=True, scale_transform=None)[source]#

Bases: Transform

The base polar transform.

This transform maps polar coordinates \(\theta, r\) into Cartesian coordinates \(x, y = r \cos(\theta), r \sin(\theta)\)(but does not fully transform into Axes coordinates or handle positioning in screen space).

This transformation is designed to be applied to data after any scaling along the radial axis (e.g. log-scaling) has been applied to the input data.

Path segments at a fixed radius are automatically transformed to circular arcs as long as path._interpolation_steps > 1.

Parameters:

axisAxis, optional

Axis associated with this transform. This is used to get the minimum radial limit.

use_rminbool, optional

If True, subtract the minimum radial axis limit before transforming to Cartesian coordinates. axis must also be specified for this to take effect.

has_inverse = True#

True if this transform has a corresponding inverse transform.

input_dims = 2#

The number of input dimensions of this transform. Must be overridden (with integers) in the subclass.

inverted()[source]#

Return the corresponding inverse transformation.

It holds x == self.inverted().transform(self.transform(x)).

The return value of this method should be treated as temporary. An update to self does not cause a corresponding update to its inverted copy.

output_dims = 2#

The number of output dimensions of this transform. Must be overridden (with integers) in the subclass.

transform_non_affine(values)[source]#

Apply only the non-affine part of this transformation.

transform(values) is always equivalent totransform_affine(transform_non_affine(values)).

In non-affine transformations, this is generally equivalent totransform(values). In affine transformations, this is always a no-op.

Parameters:

valuesarray

The input values as an array of length input_dims or shape (N, input_dims).

Returns:

array

The output values as an array of length output_dims or shape (N, output_dims), depending on the input.

transform_path_non_affine(path)[source]#

Apply the non-affine part of this transform to Path path, returning a new Path.

transform_path(path) is equivalent totransform_path_affine(transform_path_non_affine(values)).

class matplotlib.projections.polar.RadialAxis(*args, **kwargs)[source]#

Bases: YAxis

A radial Axis.

This overrides certain properties of a YAxis to provide special-casing for a radial axis.

Parameters:

axesAxes

The Axes to which the created Axis belongs.

pickradiusfloat

The acceptance radius for containment tests. See alsoAxis.contains.

clearbool, default: True

Whether to clear the Axis on creation. This is not required, e.g., when creating an Axis as part of an Axes, as Axes.clear will callAxis.clear. .. versionadded:: 3.8

axis_name = 'radius'#

Read-only name identifying the axis.

clear()[source]#

Clear the axis.

This resets axis properties to their default values:

set(*, agg_filter=, alpha=, animated=, clip_box=, clip_on=, clip_path=, converter=, data_interval=, gid=, in_layout=, inverted=, label=, label_coords=, label_position=, label_text=, major_formatter=, major_locator=, minor_formatter=, minor_locator=, mouseover=, offset_position=, path_effects=, picker=, pickradius=, rasterized=, remove_overlapping_locs=, sketch_params=, snap=, tick_params=, ticklabels=, ticks=, ticks_position=, transform=, units=, url=, view_interval=, visible=, zorder=)[source]#

Set multiple properties at once.

Supported properties are

class matplotlib.projections.polar.RadialLocator(base, axes=None)[source]#

Bases: Locator

Used to locate radius ticks.

Ensures that all ticks are strictly positive. For all other tasks, it delegates to the base Locator (which may be different depending on the scale of the _r_-axis).

nonsingular(vmin, vmax)[source]#

Adjust a range as needed to avoid singularities.

This method gets called during autoscaling, with (v0, v1) set to the data limits on the Axes if the Axes contains any data, or(-inf, +inf) if not.

set_axis(axis)[source]#

view_limits(vmin, vmax)[source]#

Select a scale for the range from vmin to vmax.

Subclasses should override this method to change locator behaviour.

class matplotlib.projections.polar.RadialTick(*args, **kwargs)[source]#

Bases: YTick

A radial-axis tick.

This subclass of YTick provides radial ticks with some small modification to their re-positioning such that ticks are rotated based on axes limits. This results in ticks that are correctly perpendicular to the spine. Labels are also rotated to be perpendicular to the spine, when 'auto' rotation is enabled.

bbox is the Bound2D bounding box in display coords of the Axes loc is the tick location in data coords size is the tick size in points

set(*, agg_filter=, alpha=, animated=, clip_box=, clip_on=, clip_path=, gid=, in_layout=, label=, mouseover=, pad=, path_effects=, picker=, rasterized=, sketch_params=, snap=, transform=, url=, visible=, zorder=)[source]#

Set multiple properties at once.

Supported properties are

update_position(loc)[source]#

Set the location of tick in data coords with scalar loc.

class matplotlib.projections.polar.ThetaAxis(*args, **kwargs)[source]#

Bases: XAxis

A theta Axis.

This overrides certain properties of an XAxis to provide special-casing for an angular axis.

Parameters:

axesAxes

The Axes to which the created Axis belongs.

pickradiusfloat

The acceptance radius for containment tests. See alsoAxis.contains.

clearbool, default: True

Whether to clear the Axis on creation. This is not required, e.g., when creating an Axis as part of an Axes, as Axes.clear will callAxis.clear. .. versionadded:: 3.8

axis_name = 'theta'#

Read-only name identifying the axis.

clear()[source]#

Clear the axis.

This resets axis properties to their default values:

set(*, agg_filter=, alpha=, animated=, clip_box=, clip_on=, clip_path=, converter=, data_interval=, gid=, in_layout=, inverted=, label=, label_coords=, label_position=, label_text=, major_formatter=, major_locator=, minor_formatter=, minor_locator=, mouseover=, path_effects=, picker=, pickradius=, rasterized=, remove_overlapping_locs=, sketch_params=, snap=, tick_params=, ticklabels=, ticks=, ticks_position=, transform=, units=, url=, view_interval=, visible=, zorder=)[source]#

Set multiple properties at once.

Supported properties are

class matplotlib.projections.polar.ThetaFormatter[source]#

Bases: Formatter

Used to format the theta tick labels. Converts the native unit of radians into degrees and adds a degree symbol.

class matplotlib.projections.polar.ThetaLocator(base)[source]#

Bases: Locator

Used to locate theta ticks.

This will work the same as the base locator except in the case that the view spans the entire circle. In such cases, the previously used default locations of every 45 degrees are returned.

set_axis(axis)[source]#

view_limits(vmin, vmax)[source]#

Select a scale for the range from vmin to vmax.

Subclasses should override this method to change locator behaviour.

class matplotlib.projections.polar.ThetaTick(axes, *args, **kwargs)[source]#

Bases: XTick

A theta-axis tick.

This subclass of XTick provides angular ticks with some small modification to their re-positioning such that ticks are rotated based on tick location. This results in ticks that are correctly perpendicular to the arc spine.

When 'auto' rotation is enabled, labels are also rotated to be parallel to the spine. The label padding is also applied here since it's not possible to use a generic axes transform to produce tick-specific padding.

bbox is the Bound2D bounding box in display coords of the Axes loc is the tick location in data coords size is the tick size in points

set(*, agg_filter=, alpha=, animated=, clip_box=, clip_on=, clip_path=, gid=, in_layout=, label=, mouseover=, pad=, path_effects=, picker=, rasterized=, sketch_params=, snap=, transform=, url=, visible=, zorder=)[source]#

Set multiple properties at once.

Supported properties are

update_position(loc)[source]#

Set the location of tick in data coords with scalar loc.