This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

ezsurf

Plot 3-D surface

ezsurf is not recommended. Use fsurf instead.

Syntax

ezsurf(f)
ezsurf(f,[xmin,xmax])
ezsurf(f,[xmin,xmax,ymin,ymax])
ezsurf(x,y,z)
ezsurf(x,y,z,[smin,smax])
ezsurf(x,y,z,[smin,smax,tmin,tmax])
ezsurf(___,n)
ezsurf(___,'circ')
h = ezsurf(___)

Description

example

ezsurf(f) plots a two-variable symbolic expression or function f(x,y) over the range -2*pi < x < 2*pi, -2*pi < y < 2*pi.

example

ezsurf(f,[xmin,xmax]) plots f(x,y) over the specified range xmin < x < xmax. This is the range along the abscissa (horizontal axis).

example

ezsurf(f,[xmin,xmax,ymin,ymax]) plots f(x,y) over the specified ranges along the abscissa, xmin < x < xmax, and the ordinate, ymin < y < ymax.

When determining the range values, ezsurf sorts variables alphabetically. For example, ezsurf(x^2 - a^3, [0,1,3,6]) plots x^2 - a^3 over 0 < a < 1, 3 < x < 6.

ezsurf(x,y,z) plots the parametric surface x = x(s,t), y = y(s,t), z = z(s,t) over the range -2*pi < s < 2*pi, -2*pi < t < 2*pi.

ezsurf(x,y,z,[smin,smax]) plots the parametric surface x = x(s,t), y = y(s,t), z = z(s,t) over the specified range smin < s < smax.

example

ezsurf(x,y,z,[smin,smax,tmin,tmax]) plots the parametric surface x = x(s,t), y = y(s,t), z = z(s,t) over the specified ranges smin < s < smax and tmin < t < tmax.

example

ezsurf(___,n) specifies the grid. You can specify n after the input arguments in any of the previous syntaxes. By default, n = 60.

example

ezsurf(___,'circ') creates the surface plot over a disk centered on the range. You can specify'circ' after the input arguments in any of the previous syntaxes.

example

h = ezsurf(___) returns a handle h to the surface plot object. You can use the output argument h with any of the previous syntaxes.

Examples

collapse all

Plot the symbolic function f(x,y) = real(atan(x + i*y)) over the default range -2*pi < x < 2*pi, -2*pi < y < 2*pi.

Create the symbolic function.

syms f(x,y)
f(x,y) = real(atan(x + i*y));

Plot this function using ezsurf.

ezsurf(f)

Plot the symbolic expression x^2 + y^2 over the range -1 < x < 1. Because you do not specify the range for the y-axis, ezsurf chooses it automatically.

syms x y
ezsurf(x^2 + y^2, [-1, 1])

Specify the range for both axes.

ezsurf(x^2 + y^2, [-1, 1, -0.5, 1.5])

Define the parametric surface x(s,t), y(s,t), z(s,t) as follows.

syms s t
r = 2 + sin(7*s + 5*t);
x = r*cos(s)*sin(t);
y = r*sin(s)*sin(t);
z = r*cos(t);

Plot the function using ezsurf.

ezsurf(x, y, z, [0, 2*pi, 0, pi])
title('Parametric surface')

To create a smoother plot, increase the number of mesh points.

ezsurf(x, y, z, [0, 2*pi, 0, pi], 120)
title('Parametric surface with grid = 120')

First, plot the expression sin(x^2 + y^2) over the square range -pi/2 < x < pi/2, -pi/2 < y < pi/2.

syms x y
ezsurf(sin(x^2 + y^2), [-pi/2, pi/2, -pi/2, pi/2])

Now, plot the same expression over the disk range.

ezsurf(sin(x^2 + y^2), [-pi/2, pi/2, -pi/2, pi/2],'circ')

Plot the symbolic expression sin(x)cos(x), and assign the result to the handle h.

syms x y
h = ezsurf(sin(x)*cos(y), [-pi, pi])

h = 
  Surface with properties:

       EdgeColor: [0 0 0]
       LineStyle: '-'
       FaceColor: 'flat'
    FaceLighting: 'flat'
       FaceAlpha: 1
           XData: [60x60 double]
           YData: [60x60 double]
           ZData: [60x60 double]
           CData: [60x60 double]

  Show all properties

You can use this handle to change properties of the plot. For example, change the color of the area outline.

h.EdgeColor = 'red'

h = 
  Surface with properties:

       EdgeColor: [1 0 0]
       LineStyle: '-'
       FaceColor: 'flat'
    FaceLighting: 'flat'
       FaceAlpha: 1
           XData: [60x60 double]
           YData: [60x60 double]
           ZData: [60x60 double]
           CData: [60x60 double]

  Show all properties

Input Arguments

collapse all

Function to plot, specified as a symbolic expression or function of two variables.

Example: ezsurf(x^2 + y^2)

Parametric function to plot, specified as three symbolic expressions or functions of two variables.

Example: ezsurf(s*cos(t), s*sin(t), t)

Grid value, specified as an integer. The default grid value is 60.

Output Arguments

collapse all

Surface plot handle, returned as a scalar. It is a unique identifier, which you can use to query and modify properties of the surface plot.

Tips

  • ezsurf chooses the computational grid according to the amount of variation that occurs. If f is singular for some points on the grid, then ezsurf omits these points. The value at these points is set to NaN.

Introduced before R2006a