ezpolar

(Not recommended) Easy-to-use polar coordinate plotter

• 

ezpolar is not recommended. Use fpolarplot instead. (since R2024a) For more information on updating your code, see Version History.

Syntax

ezpolar(f)

ezpolar(f,thetainterval)

ezpolar(ax,___)

h = ezpolar(___)

Description

ezpolar(f) plots the curve defined by the function rho = f(theta) over the default interval [0, 2π] for theta.

ezpolar automatically adds a title to the bottom of the plot.

ezpolar(f,thetainterval) plots over the specified interval. Specify the interval as a two-element vector of the form [thetamin thetamax].

ezpolar(ax,___) plots into the axes specified by ax. Specify the axes as the first input argument in any of the previous syntaxes.

h = ezpolar(___) returns a Line object. Use h to modify properties of the plot after creating it. For a list of properties, see Line Properties.

Examples

Plot Polar Function

Plot the function 1+cos(θ) over the interval [0, 2π].

ezpolar("1+cos(theta)")

Input Arguments

f — Function to plot

character vector | string scalar | function handle

Function to plot, specified as a character vector, string scalar, or function handle to a named or anonymous function.

Specify a function of the form rho = f(theta). The function must accept at least one vector input argument and return a vector output argument of the same size.

If you specify the function as a character vector or string scalar, then multiplication, division, and exponentiation are performed as element-wise operations. For example, theta^2 is interpreted as theta.^2.

Example: ezpolar("sin(theta^2)")

If you specify the function as a function handle, use array operators instead of matrix operators for the best performance. For example, use .* (times) instead of * (mtimes).

Example: ezpolar(@(theta) sin(theta).*cos(theta))

If you specify a function that accepts more than one input argument, specify the function as an anonymous function.

Example: ezpolar(@(theta,arg2,arg3) myfun(theta,arg2,arg3))

thetainterval — Interval for theta

[0, 2π] (default) | two-element vector of form [thetamin thetamax]

Interval for theta, specified as a two-element vector of the form [thetamin thetamax].

ax — Axes object

Axes object

Axes object. If you do not specify this argument, then ezpolar uses the current axes (gca).

Extended Capabilities

GPU Arrays

Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

The ezpolar function supports GPU array input with these usage notes and limitations:

• This function accepts GPU arrays, but does not run on a GPU.

For more information, see Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Distributed Arrays

Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

Usage notes and limitations:

• This function operates on distributed arrays, but executes in the client MATLAB^®.

For more information, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Version History

Introduced before R2006a

R2024a: Not recommended

ezpolar is not recommended. To plot a mathematical expression in polar coordinates, use the fpolarplot function instead.

The benefits of using the fpolarplot function include:

• A more accurate visual representation of your function. Unlike ezpolar, fpolarplot adds more function evaluation points as needed.

• An input argument for customizing the line style, marker symbol, and color.

• A PolarAxes object, which you can customize by setting PolarAxes properties. For example, you can change the range of angle values or whether to display angles in radians or degrees.

This table shows some typical usages of ezpolar and how to update your code to use fpolarplot instead. To display the plotted expression as ezpolar does, use the title function.

Not Recommended	Recommended
ezpolar(@(t) cos(t)) or ezpolar('cos(t)')	fpolarplot(@(t) cos(t))
ezpolar(@(t) cos(t),[0 pi/4]) or ezpolar('cos(t)',[0 pi/4])	fpolarplot(@(t) cos(t),[0 pi/4])