polaraxes

Syntax

Description

pax = polaraxes creates
the default polar axes in the current figure and returns the PolarAxes object
created. Use pax to query and set properties of
the PolarAxes object. For a list of properties, see PolarAxes Properties.

pax = polaraxes(Name,Value) specifies
properties for the PolarAxes object using one or
more name-value pair arguments, for example, 'ThetaDir','clockwise'.

pax = polaraxes(parent,___) creates
the polar axes in the figure, uipanel, or uitab specified by parent,
instead of in the current figure. Use this option with any of the
input argument combinations in the previous syntaxes.

Input Arguments

pax_in — Polar axes to make currentPolarAxes object

Polar axes to make current, specified as a PolarAxes object.

Name-Value Pair Arguments

Specify optional
comma-separated pairs of Name,Value arguments. Name is
the argument name and Value is the corresponding value.
Name must appear inside single quotes (' '). You can
specify several name and value pair arguments in any order as
Name1,Value1,...,NameN,ValueN.

Example: 'ThetaZeroLocation','top','ThetaDir','clockwise'

The properties listed here are only a subset. For a complete
list, see PolarAxes Properties.
Some graphics functions reset axes properties when plotting. To avoid
graphics functions from overriding the property values, set axes properties
after plotting.

'degrees' — Label the angles
in degrees, and interpret the ThetaLim, ThetaTick,
and RAxisLocation property values in degrees.
When you switch the units from radians to degrees, MATLAB® converts
the radian values in those three properties to the equivalent degree
values.

'radians' — Label the angles
in radians, and interpret the ThetaLim, ThetaTick,
and RAxisLocation property values in radians.
When you switch the units from degrees to radians, MATLAB converts
the degree values in those three properties to the equivalent radian
values.

Angles at which to display lines extending from the origin,
specified as a vector of increasing values. MATLAB labels the
lines with the appropriate angle values, unless you specify different
labels using the ThetaTickLabel property.

MATLAB interprets the values in units determined by the ThetaAxisUnits property.

Color of grid lines, tick marks, and tick labels for the theta-axis,
specified as an RGB triplet or one of the colors listed in the table.

Note

If you specify the GridColor property, then
the grid lines use the color in the GridColor property
instead. See GridColorMode for more information.

For a custom color, specify an RGB triplet. An RGB triplet is a
three-element row vector whose elements specify the intensities of the red, green, and blue
components of the color. The intensities must be in the range [0,1]; for
example, [0.4 0.6 0.7]. Alternatively, you can specify some common colors by
name. This table lists the long and short color name options and the equivalent RGB triplet
values.

Option

Description

Equivalent RGB Triplet

'red' or 'r'

Red

[1 0 0]

'green' or 'g'

Green

[0 1 0]

'blue' or 'b'

Blue

[0 0 1]

'yellow' or 'y'

Yellow

[1 1 0]

'magenta' or 'm'

Magenta

[1 0 1]

'cyan' or 'c'

Cyan

[0 1 1]

'white' or 'w'

White

[1 1 1]

'black' or 'k'

Black

[0 0 0]

'none'

No color

Not applicable

For example, ax.ThetaColor = 'r' changes
the color to red.

'RAxisLocation' — Location of r-axis80 (default) | scalar angle value

Location of the r-axis, specified a scalar angle value. MATLAB interprets
the values in units determined by the ThetaAxisUnits property.

Minimum and maximum radius limits, specified as a two-element
vector of the form [rmin rmax], where rmax is
a numeric value greater than rmin. You can specify
both limits, or specify one limit and let the axes automatically calculate
the other.

To automatically set the minimum limit to the minimum
data value, specify the first element as -inf,
for example, [-inf 0].

To automatically set the maximum limit to the maximum
data value, specify the second element as inf,
for example, [0 inf].

Radius values at which to display circular lines, specified
as a vector of increasing values. MATLAB labels the lines with
the appropriate radius values unless you specify different labels
using the RTickLabel property.

Color of r-axis grid lines, tick marks, and tick labels, specified as an
RGB triplet or one of the color options listed in the table.

Note

If you specify the GridColor property, then
the grid lines use the color in the GridColor property
instead. See GridColorMode for more information.

For a custom color, specify an RGB triplet. An RGB triplet is a
three-element row vector whose elements specify the intensities of the red, green, and blue
components of the color. The intensities must be in the range [0,1]; for
example, [0.4 0.6 0.7]. Alternatively, you can specify some common colors by
name. This table lists the long and short color name options and the equivalent RGB triplet
values.