ezsurf

（不推荐）易用的三维彩色曲面绘图函数

全页折叠

不推荐使用 ezsurf。请改用 fsurf。有关详细信息，请参阅版本历史记录。

语法

ezsurf(f)

ezsurf(f,xyinterval)

ezsurf(funx,funy,funz)

ezsurf(funx,funy,funz,uvinterval)

ezsurf(___,n)

ezsurf(___,'circ')

ezsurf(ax,___)

s = ezsurf(___)

说明

ezsurf(f) 使用 surf 函数创建函数 f(x,y) 的曲面图。该函数在默认区间 [-2π 2π]（对于 x 和 y）上绘制 f。

ezsurf 自动将标题和轴标签添加到绘图中。

示例

ezsurf(f,xyinterval) 将在指定区间绘图。

ezsurf(funx,funy,funz) 在默认区间 [-2π 2π]（对于 u 和 v）上绘制参数化曲面 funx(u,v)、funy(u,v) 和 funz(u,v)。

ezsurf(funx,funy,funz,uvinterval) 使用指定区间绘制参数化曲面图。

ezsurf(___,n) 使用一个 n×n 网格进行绘图。在上述语法中的任何输入参量组合后使用此选项。

ezsurf(___,'circ') 在以该区间为中心的圆上绘制。

ezsurf(ax,___) 将图形绘制到 ax 指定的坐标区中，而不是当前坐标区中。在上述任一语法中的任何输入参量组合之前指定坐标区。

s = ezsurf(___) 将返回一个图曲面对象。在创建曲面之后可使用 s 对其进行修改。有关属性列表，请参阅 Surface 属性。

示例

全部折叠

数学函数的曲面图

打开实时脚本

在域 $- 2 π < x < 2 π$ 和 $- 2 π < y < 2 π$ 上绘制函数 $f (x, y) = real (atan (x + iy))$ 。对于未定义数学函数的点，ezsurf 函数不会绘制它们。这些点设置为 NaN，因此不绘制它们。

figure
ezsurf('real(atan(x+i*y))')

Figure contains an axes object. The axes object with title real ( atan ( x + i blank y )), xlabel x, ylabel y contains an object of type surface.

使用 surf 绘制相同数据，不滤除不连续的点。

figure
[x,y] = meshgrid(linspace(-2*pi,2*pi,60));
z = real(atan(x+1i.*y));
surf(x,y,z)

Figure contains an axes object. The axes object contains an object of type surface.

输入参数

全部折叠

`f` — 要绘制的三维函数
字符向量 | 字符串标量 | 函数句柄

要绘制的三维函数，指定为字符向量、字符串标量或命名或匿名函数的函数句柄。

指定 z = f(x,y) 形式的函数。该函数必须接受两个矩阵输入参量，并返回大小相同的矩阵输出参量。

当将函数指定为字符向量或字符串标量时，始终默认执行数组乘法、除法和乘方。例如，x^2 解释为 x.^2。

示例: 'sqrt(x^2 + y^2)'

将函数指定为函数句柄时，为了获得最优性能，请使用数组运算符而不是矩阵运算符。例如，使用 .* (times) 而不是 * (mtimes)。

示例: @(x,y) sin(x).*cos(y)

`xyinterval` — `x` 和 `y` 的绘图区间
`[-2π 2π -2π 2π]` (默认) | `[min max]` 形式的向量 | `[xmin xmax ymin ymax]` 形式的向量

x 和 y 的绘图区间，指定为下列形式之一：

[min max] 形式的向量 - 对 x 和 y 都使用区间 [min max]。
[xmin xmax ymin ymax] 形式的向量 - 对 x 使用区间 [xmin xmax]，对 y 使用区间 [ymin ymax]。

`funx` — x 坐标的参数化函数
字符向量 | 字符串标量 | 函数句柄

x 坐标的参数化函数，指定为字符向量、字符串标量或者命名或匿名函数的函数句柄。

指定 x = funx(u,v) 形式的函数。该函数必须接受两个矩阵输入参量，并返回大小相同的矩阵输出参量。

当将函数指定为字符向量或字符串标量时，始终默认执行数组乘法、除法和乘方。例如，x^2 解释为 x.^2。

示例: 'u*sin(v)'

将函数指定为函数句柄时，为了获得最优性能，请使用数组运算符而不是矩阵运算符。例如，使用 .* (times) 而不是 * (mtimes)。

示例: @(u,v) u.*sin(v)

`funy` — y 坐标的参数化函数
字符向量 | 字符串标量 | 函数句柄

y 坐标的参数化函数，指定为字符向量、字符串标量或者命名或匿名函数的函数句柄。

指定 y = funy(u,v) 形式的函数。该函数必须接受两个矩阵输入参量，并返回大小相同的矩阵输出参量。

当将函数指定为字符向量或字符串标量时，始终默认执行数组乘法、除法和乘方。例如，x^2 解释为 x.^2。

示例: '-u*cos(v)'

将函数指定为函数句柄时，为了获得最优性能，请使用数组运算符而不是矩阵运算符。例如，使用 .* (times) 而不是 * (mtimes)。

示例: @(u,v) -u.*cos(v)

`funz` — z 坐标的参数化函数
字符向量 | 字符串标量 | 函数句柄

z 坐标的参数化函数，指定为字符向量、字符串标量或者命名或匿名函数的函数句柄。

指定 z = funz(u,v) 形式的函数。该函数必须接受两个矩阵输入参量，并返回大小相同的矩阵输出参量。

当将函数指定为字符向量或字符串标量时，始终默认执行数组乘法、除法和乘方。例如，x^2 解释为 x.^2。

示例: '-u*cos(v)'

将函数指定为函数句柄时，为了获得最优性能，请使用数组运算符而不是矩阵运算符。例如，使用 .* (times) 而不是 * (mtimes)。

示例: @(u,v) v

`uvinterval` — `u` 和 `v` 的绘图区间
`[-2π 2π -2π 2π]` (默认) | `[min max]` 形式的向量 | `[umin umax vmin vmax]` 形式的向量

u 和 v 的绘图区间，指定为下列形式之一：

[min max] 形式的向量 - 对 u 和 v 都使用区间 [min max]。
[umin umax vmin vmax] 形式的向量 - 对 u 使用区间 [umin umax]，对 v 使用区间 [vmin vmax]。

`n` — 网格的大小
60 (默认) | 正整数

网格的大小，指定为正整数。网格的维度是 n×n。

`ax` — 坐标区对象
坐标区对象

坐标区对象。如果您不指定坐标区对象，则 ezsurf 使用当前坐标区。

扩展功能

全部展开

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

ezsurf 函数支持 GPU 数组输入，但有以下用法说明和限制：

此函数接受 GPU 数组，但不在 GPU 上运行。

有关详细信息，请参阅在 GPU 上运行 MATLAB 函数 (Parallel Computing Toolbox)。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

用法说明和限制：

此函数在分布式数组上运行，但在客户端 MATLAB^® 中执行。

有关详细信息，请参阅使用分布式数组运行 MATLAB 函数 (Parallel Computing Toolbox)。

版本历史记录

在 R2006a 之前推出

全部折叠

R2016a: 不推荐使用 `ezsurf`

不推荐使用 ezsurf。请改用 fsurf。目前没有删除 ezsurf 的计划。

fsurf 要求要绘制的输入函数是函数句柄。ezsurf 接受函数句柄、字符向量或字符串。下表显示了 ezsurf 的一些典型用法，以及如何更新代码以改用 fsurf。

不推荐	推荐
`ezsurf('real(atan(x+i*y))')`	`fsurf(@(x,y) real(atan(x+i*y)))`
`ezsurf('sin(x)+cos(y)')`	`fsurf(@(x,y) sin(x)+cos(y))`
`ezsurf(@(x,y) sqrt(x.^2+y.^2))`	`fsurf(@(x,y) sqrt(x.^2+y.^2))`

另请参阅

主题

匿名函数

ezsurf

语法

说明

示例

数学函数的曲面图

输入参数

f — 要绘制的三维函数 字符向量 | 字符串标量 | 函数句柄

xyinterval — x 和 y 的绘图区间 [-2π 2π -2π 2π] (默认) | [min max] 形式的向量 | [xmin xmax ymin ymax] 形式的向量

funx — x 坐标的参数化函数 字符向量 | 字符串标量 | 函数句柄

funy — y 坐标的参数化函数 字符向量 | 字符串标量 | 函数句柄

funz — z 坐标的参数化函数 字符向量 | 字符串标量 | 函数句柄

uvinterval — u 和 v 的绘图区间 [-2π 2π -2π 2π] (默认) | [min max] 形式的向量 | [umin umax vmin vmax] 形式的向量

n — 网格的大小 60 (默认) | 正整数

ax — 坐标区对象 坐标区对象

扩展功能

GPU 数组 通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组 使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

版本历史记录

R2016a: 不推荐使用 ezsurf

另请参阅

主题

`f` — 要绘制的三维函数
字符向量 | 字符串标量 | 函数句柄

`xyinterval` — `x` 和 `y` 的绘图区间
`[-2π 2π -2π 2π]` (默认) | `[min max]` 形式的向量 | `[xmin xmax ymin ymax]` 形式的向量

`funx` — x 坐标的参数化函数
字符向量 | 字符串标量 | 函数句柄

`funy` — y 坐标的参数化函数
字符向量 | 字符串标量 | 函数句柄

`funz` — z 坐标的参数化函数
字符向量 | 字符串标量 | 函数句柄

`uvinterval` — `u` 和 `v` 的绘图区间
`[-2π 2π -2π 2π]` (默认) | `[min max]` 形式的向量 | `[umin umax vmin vmax]` 形式的向量

`n` — 网格的大小
60 (默认) | 正整数

`ax` — 坐标区对象
坐标区对象

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

R2016a: 不推荐使用 `ezsurf`