ezmeshc

(Not recommended) Easy-to-use combination mesh/contour plotter

ezmeshc is not recommended. Use fmesh instead. For more information, see Version History.

Syntax

ezmeshc(f)

ezmeshc(f,xyinterval)

ezmeshc(funx,funy,funz)

ezmeshc(funx,funy,funz,uvinterval)

ezmeshc(___,n)

ezmeshc(___,'circ')

ezmeshc(ax,___)

sc = ezmeshc(___)

Description

ezmeshc(f) creates a mesh plot of the function z = f(x,y) using the meshc function. The function plots f over the default interval [-2π 2π] for x and y.

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

ezmeshc(f,xyinterval) plots over the specified interval. To use the same interval for both x and y, specify xyinterval as a two-element vector of the form [min max]. To use different intervals, specify a four-element vector of the form [xmin xmax ymin ymax].

ezmeshc(funx,funy,funz) plots the parametric mesh defined by x = funx(u,v), y = funy(u,v), z = funz(u,v) over the default interval [-2π 2π] for u and v.

ezmeshc(funx,funy,funz,uvinterval) plots the parametric mesh over the specified interval. To use the same interval for both u and v, specify uvinterval as a two-element vector of the form [min max]. To use different intervals, specify a four-element vector of the form [umin umax vmin vmax].

ezmeshc(___,n) plots using an n-by-n grid. Use this option after any of the input argument combinations in the previous syntaxes.

ezmeshc(___,'circ') plots over a disk centered on the interval.

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

sc = ezmeshc(___) returns a graphics array that includes the chart surface object and the contour object. Use sc to modify the mesh and contour plots after they are created. For a list of properties, see Surface Properties and Contour Properties.

Examples

Mesh and Contour Plot of Mathematical Function

Create a mesh/contour plot of the expression $f(x,y)=\sqrt{x^2+y^2}$ over the domain $$-5<x<5$$ and $$-2\pi <y<2\pi$$ with a computational grid size of 35-by-35.

ezmeshc('sqrt(x^2 + y^2)',[-5,5,-2*pi,2*pi],35)

Input Arguments

f — 3-D function to plot

character vector | string scalar | function handle

3-D 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 z = f(x,y). The function must accept two matrix input arguments and return a matrix 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: 'sqrt(x^2 + y^2)'

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: @(x,y) sin(x).*cos(y)

xyinterval — Plotting interval for x and y

[-2π 2π -2π 2π] (default) | vector of form [min max] | vector of form [xmin xmax ymin ymax]

Plotting interval for x and y, specified in one of these forms:

• Vector of form [min max] — Use the interval [min max] for both x and y.

• Vector of form [xmin xmax ymin ymax] — Use the interval [xmin xmax] for x and [ymin ymax] for y.

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,v). The function must accept two matrix input arguments and return a matrix 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: 'u*sin(v)'

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,v) u.*sin(v)

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,v). The function must accept two matrix input arguments and return a matrix 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: '-u*cos(v)'

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,v) -u.*cos(v)

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,v). The function must accept two matrix input arguments and return a matrix 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: '-u*cos(v)'

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,v) v

uvinterval — Plotting interval for u and v

[-2π 2π -2π 2π] (default) | vector of form [min max] | vector of form [umin umax vmin vmax]

Plotting interval for u and v, specified in one of these forms:

• Vector of form [min max] — Use the interval [min max] for both u and v.

• Vector of form [umin umax vmin vmax] — Use the interval [umin umax] for u and [vmin vmax] for v.

n — Size of the grid

60 (default) | positive integer

Size of the grid, specified as a positive integer. The grid has dimensions n-by-n.

ax — Axes object

axes object

Axes object. If you do not specify an axes object, then ezmeshc uses the current axes.

Extended Capabilities

GPU Arrays

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

The ezmeshc 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: ezmeshc is not recommended

ezmeshc is not recommended. Use fmesh instead. There are no plans to remove ezmeshc.

fmesh requires that the input function to plot is a function handle. ezmeshc accepts either a function handle, a character vector, or a string. This table shows some typical usages of ezmeshc and how to update your code to use fmesh instead.

Not Recommended	Recommended
ezmeshc(@(x,y)x.*exp(-x.^2-y.^2),42)	fmesh(@(x,y) x.*exp(-x.^2-y.^2),'MeshDensity',42,'ShowContours','on')
ezmeshc('real(atan(x+i*y))')	fmesh(@(x,y) real(atan(x+i*y)),'ShowContours','on')
ezmeshc(@(x,y) sqrt(x.^2+y.^2))	fmesh(@(x,y) sqrt(x.^2+y.^2),'ShowContours','on')