ezplot3

(Not recommended) Easy-to-use 3-D parametric curve plotter

ezplot3 is not recommended. Use fplot3 instead. For more information, see Version History.

Syntax

ezplot3(funx,funy,funz)

ezplot3(funx,funy,funz,uinterval)

ezplot3(___,'animate')

ezplot3(ax,___)

h = ezplot3(___)

Description

ezplot3(funx,funy,funz) plots the spatial curve defined by x = funx(u), y = funy(u), and z = funz(u) over the default interval [0,2π] for u.

ezplot3 automatically adds a title and axis labels to the plot.

ezplot3(funx,funy,funz,uinterval) plots over the specified interval. Specify the interval as a two-element vector of the form [umin umax].

ezplot3(___,'animate') produces an animated trace of the spatial curve. Use this option after any of the input argument combinations in the previous syntaxes.

ezplot3(ax,___) plots into the axes specified by ax instead of the current axes. Specify the axes before any of the input argument combinations in any of the previous syntaxes.

h = ezplot3(___) returns the plotted objects. Use h to modify properties of the plot after creating it.

Examples

Plot a Parametric Curve

Plot this parametric curve over the domain $$[0,6\pi ]$$.

$$x=\sin (t),y=\cos (t),z=t$$

ezplot3('sin(t)','cos(t)','t',[0,6*pi])

Input Arguments

funx — Parametric function for x coordinates

character vector | string scalar | function handle

Parametric function for x coordinates, specified as a character vector, string scalar, or function handle to a named or anonymous function.

Specify a function of the form x = funx(u). The function must accept a vector input argument and return a vector output argument of the same size.

When specifying the function as a character vector or string scalar, array multiplication, division, and exponentiation are always implied. For example, x^2 is interpreted as x.^2.

Example: 'sin(2*u)'

When specifying 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: @(u) sin(2.*u)

funy — Parametric function for y coordinates

character vector | string scalar | function handle

Parametric function for y coordinates, specified as a character vector, string scalar, or function handle to a named or anonymous function.

Specify a function of the form y = funy(u). The function must accept a vector input argument and return a vector output argument of the same size.

When specifying the function as a character vector or string scalar, array multiplication, division, and exponentiation are always implied. For example, x^2 is interpreted as x.^2.

Example: 'cos(2*u)'

When specifying 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: @(u) cos(2.*u)

funz — Parametric function for z coordinates

character vector | string scalar | function handle

Parametric function for z coordinates, specified as a character vector, string scalar, or function handle to a named or anonymous function.

Specify a function of the form z = funz(u). The function must accept a vector input argument and return a vector output argument of the same size.

When specifying the function as a character vector or string scalar, array multiplication, division, and exponentiation are always implied. For example, x^2 is interpreted as x.^2.

Example: '2*u'

When specifying 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: @(u) tan(4.*u)

uinterval — Plotting interval for u

[0 2π] (default) | two-element vector of form [umin umax]

Plotting interval for u, specified as a two-element vector of the form [umin umax].

ax — Axes object

axes object

Axes object. If you do not specify an axes object, then ezplot3 uses the current axes (gca).

Extended Capabilities

GPU Arrays

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

The ezplot3 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

R2016a: ezplot3 is not recommended

ezplot3 is not recommended. Use fplot3 instead. There are no plans to remove ezplot3.

fplot3 requires that the input functions to plot are function handles. ezplot3 accepts either function handles, character vectors, or strings. This table shows some typical usages of ezplot3 and how to update your code to use fplot3 instead.

Not Recommended	Recommended
ezplot3('sin','cos','t',[0 10])	fplot3(@sin,@cos,@(t)t,[0 10])
ezplot3('sin(t)','cos(t)','t',[0,6*pi])	fplot3(@(t)sin(t),@(t)cos(t),@(t)t,[0,6*pi])