帮助中心帮助中心

冲浪

曲面图

在页面中全部折叠

语法

冲浪(X, Y, Z)

冲浪(X, Y, Z, C)

冲浪(Z)

冲浪(Z, C)

冲浪(ax,___）

冲浪(___、名称、值)

s =冲浪(___）

描述

冲浪(X，Y，Z）创建三维曲面图，这是一个具有纯边颜色和纯面颜色的三维曲面。函数在矩阵中绘制值Z在网格之上的高度x-y平面定义为X而且Y．表面的颜色根据所指定的高度而变化Z．

冲浪(X，Y，Z，C）另外指定表面颜色。

冲浪(Z）中元素的列和行索引Z随着x- - -y坐标。

冲浪(Z，C）另外指定表面颜色。

冲浪(斧头，___）所指定的坐标轴斧头而不是现在的坐标轴。指定坐标轴作为第一个输入参数。

冲浪(___，名称,值）使用一个或多个名称-值对参数指定表面属性。例如,“FaceAlpha”,0.5创建一个半透明的表面。

s =冲浪(___）返回图表表面对象。使用年代在创建后修改表面。有关属性列表，请参见表面性质．

例子

创建曲面图

打开生活的脚本

创建三个相同大小的矩阵。然后把它们画成曲面。表面图使用Z身高和颜色。

(X, Y) = meshgrid (1:0.5:10 1:20);Z = sin(X) + cos(Y)冲浪(X, Y, Z)

图中包含一个axes对象。axis对象包含一个类型为surface的对象。

为曲面图指定颜色图

打开生活的脚本

通过包含第四个矩阵输入来指定曲面图的颜色，C．表面图使用Z的高度和C的颜色。指定颜色colormap后者用单个数字代表光谱上的颜色。当你使用色度图时，C是一样的尺寸吗Z．在图表中添加一个颜色条来显示数据值C与色度图中的颜色对应。

(X, Y) = meshgrid (1:0.5:10 1:20);Z = sin(X) + cos(Y)C = x * Y;冲浪(X, Y, Z, C) colorbar

图中包含一个axes对象。axis对象包含一个类型为surface的对象。

为表面绘图指定真颜色

打开生活的脚本

通过包含第四个矩阵输入来指定曲面图的颜色，有限公司．表面图使用Z的高度和有限公司的颜色。使用以下命令指定颜色真彩它用三组数字代表所有可能的颜色。当你使用真彩色时，如果Z是米——- - - - - -n,然后有限公司是米——- - - - - -n3。数组的第一页表示每种颜色的红色成分，第二页表示绿色成分，第三页表示蓝色成分。

[X, Y, Z] =山峰(25);公司(::1)= 0 (25);%的红色公司(::2)=(25)。* linspace (0.5, 0.6, 25);%绿色公司(::3)=(25)。* linspace (0, 1,25);%的蓝色冲浪(X, Y, Z,有限公司)

图中包含一个axes对象。axis对象包含一个类型为surface的对象。

修改表面图外观

打开生活的脚本

创建一个半透明的表面FaceAlpha名称-值对的0．5的价值。要允许进一步修改，请将曲面对象分配给变量年代．

(X, Y) = meshgrid (5: .5:5);Z = Y *sin(X) - X *cos(Y);s =冲浪(X, Y, Z,“FaceAlpha”, 0.5)

图中包含一个axes对象。axis对象包含一个类型为surface的对象。

s = Surface with properties: EdgeColor: [0 00] LineStyle: '-' FaceColor: 'flat' FaceLighting: 'flat' FaceAlpha: 0.5000 XData: [21x21 double] YData: [21x21 double] ZData: [21x21 double] CData: [21x21 double]显示所有属性

使用年代访问和修改创建后的表面对象的属性。例如，通过设置隐藏边缘EdgeColor财产。

s.EdgeColor =“没有”；

图中包含一个axes对象。axis对象包含一个类型为surface的对象。

输入参数

`X`- - - - - -x坐标
矩阵|向量

x-coordinates，指定为与。大小相同的矩阵Z，或作为具有长度的向量n,在那里[m, n] =大小(Z)．如果不指定的值X而且Y，冲浪使用向量(1: n)而且(1: m)．

您可以使用meshgrid函数来创建X而且Y矩阵。

的XData财产的表面对象存储x坐标。

例子:X = 1:10

例子:X = [1 2 3;1 2 3;1 2 3)

例子:(X, Y) = meshgrid (5:0.5:5)

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

`Y`- - - - - -y坐标
矩阵|向量

y-coordinates，指定为与。大小相同的矩阵Z或者作为一个有长度的向量米,在那里[m, n] =大小(Z)．如果不指定的值X而且Y，冲浪使用向量(1: n)而且(1: m)．

您可以使用meshgrid函数来创建X而且Y矩阵。

的YData属性的y坐标。

例子:Y = 1:10

例子:Y = [1 1 1;2 2 2;3 3 3]

例子:(X, Y) = meshgrid (5:0.5:5)

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

`Z`- - - - - -z坐标
矩阵

z-coordinates，指定为一个矩阵。Z必须至少有两行两列。

Z指定每个点的曲面图形的高度x-y坐标。如果不指定颜色，那么Z还指定了表面颜色。

的ZData属性的z坐标。

例子:Z = [1 2 3;4 5 6)

例子:Z = sin(x) + cosy

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

`C`- - - - - -颜色数组
矩阵|`米`——- - - - - -`n`——- - - - - -`3.`RGB三联数组

颜色数组，指定为米——- - - - - -n矩阵的彩色地图索引或作为一个米——- - - - - -n——- - - - - -3.数组的RGB三联，其中Z是米——- - - - - -n．

要使用colormap颜色，请指定C作为一个矩阵。对于曲面上的每个网格点，C表示颜色图中的一种颜色。的CDataMapping属性控制中的值如何C与色度图中的颜色对应。
要使用真彩色，请指定C作为RGB三联数组。

有关更多信息，请参见彩色地图和真彩色的区别．

的CData属性存储颜色数组。如需对表面着色进行其他控制，请使用FaceColor而且EdgeColor属性。

`斧头`- - - - - -绘制的坐标轴
坐标轴对象

要绘制的坐标轴，指定为轴对象。如果不指定坐标轴，则冲浪绘制到当前坐标轴。

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名-值参数必须出现在其他参数之后，但对的顺序并不重要。

在R2021a之前，名称和值之间用逗号隔开，并括起来的名字在报价。

例子:冲浪(X, Y, Z, FaceAlpha, 0.5,“EdgeColor”,“没有一个”)创建一个没有绘制边缘的半透明表面。

请注意

这里列出的属性只是一个子集。有关完整列表，请参见表面性质．

`EdgeColor`- - - - - -边缘线的颜色
`(0 0 0)`(默认)|`“没有”`|`“平”`|`的插值函数`|RGB值|十六进制颜色代码|`“r”`|`‘g’`|`“b”`|……

边线颜色，指定为此处列出的值之一。的默认颜色。(0 0 0)对应于黑边。

价值	描述
`“没有”`	不要画边缘。
`“平”`	控件中的值为每条边使用不同的颜色`CData`财产。首先，您必须指定`CData`属性作为大小相同的矩阵`ZData`．每个面(正)的第一个顶点的颜色值x而且y方向)决定相邻边的颜色。时不能使用此值`EdgeAlpha`属性设置为`的插值函数`．
`的插值函数`	中的值为每条边使用插值着色`CData`财产。首先，您必须指定`CData`属性作为大小相同的矩阵`ZData`．通过在顶点处线性插值颜色值，颜色在每条边缘上变化。时不能使用此值`EdgeAlpha`属性设置为`“平”`．
RGB三元组、十六进制颜色编码或颜色名称	为所有的边使用指定的颜色。控件中的颜色值`CData`财产。

RGB三联色和十六进制色码用于指定自定义颜色。

RGB三元组是一个三元素行向量，其元素指定颜色的红、绿、蓝成分的强度。强度必须在这个范围内[0, 1]；例如,(0.4 0.6 0.7)．
十六进制颜色码是字符向量或以散列符号(＃)之后是三个或六个十六进制数字，取值范围从0来F．这些值不区分大小写。因此，颜色编码“# FF8800”，“# ff8800”，“# F80”,“# f80”是等价的。

或者，您也可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三组和十六进制颜色编码。

颜色名称	短名称	RGB值	十六进制颜色代码	外观
`“红色”`	`“r”`	`(1 0 0)`	`“# FF0000”`
`“绿色”`	`“g”`	`(0 1 0)`	`“# 00 ff00”`
`“蓝色”`	`“b”`	`(0 0 1)`	`“# 0000 ff”`
`“青色”`	`“c”`	`(0 1 1)`	`“# 00飞行符”`
`“红色”`	`“m”`	`(1 0 1)`	`“#”就`
`“黄色”`	`“y”`	`(1 1 0)`	`“# FFFF00”`
`“黑色”`	`“k”`	`(0 0 0)`	`“000000 #”`
`“白色”`	`“w”`	`(1 1 1)`	`“# FFFFFF”`

这里是RGB三组和十六进制颜色编码的默认颜色MATLAB^®在许多类型的情节中使用。

RGB值	十六进制颜色代码	外观
`[0 0.4470 - 0.7410)`	`“# 0072 bd”`
`(0.8500 0.3250 0.0980)`	`“# D95319”`
`(0.9290 0.6940 0.1250)`	`“# EDB120”`
`(0.4940 0.1840 0.5560)`	`“# 7 e2f8e”`
`(0.4660 0.6740 0.1880)`	`“# 77 ac30”`
`(0.3010 0.7450 0.9330)`	`“# 4 dbeee”`
`(0.6350 0.0780 0.1840)`	`“# A2142F”`

`线型`- - - - - -线条样式
`“-”`(默认)|`”——“`|`”:“`|`“-”。`|`“没有”`

线条样式，指定为该表中列出的选项之一。

线条样式	描述	产生的线
`“-”`	实线
`”——“`	虚线
`”:“`	虚线
`“-”。`	Dash-dotted线
`“没有”`	没有线	没有线

`FaceColor`- - - - - -脸上的颜色
`“平”`(默认)|`的插值函数`|`“没有”`|`“texturemap”`|RGB值|十六进制颜色代码|`“r”`|`‘g’`|`“b”`|……

面部颜色，指定为该表中的值之一。

价值	描述
`“平”`	的值为每个面使用不同的颜色`CData`财产。首先，您必须指定`CData`属性作为大小相同的矩阵`ZData`．每个面(正)的第一个顶点的颜色值x而且y方向)决定了整个脸的颜色。时不能使用此值`FaceAlpha`属性设置为`的插值函数`．
`的插值函数`	中的值为每个面使用插值着色`CData`财产。首先，您必须指定`CData`属性作为大小相同的矩阵`ZData`．通过在顶点处插入颜色值，每个面的颜色都不同。时不能使用此值`FaceAlpha`属性设置为`“平”`．
RGB三元组、十六进制颜色编码或颜色名称	为所有的面使用指定的颜色。控件中的颜色值`CData`财产。
`“texturemap”`	转换颜色数据`CData`使它与表面一致。
`“没有”`	不要画脸。

RGB三联色和十六进制色码用于指定自定义颜色。

RGB三元组是一个三元素行向量，其元素指定颜色的红、绿、蓝成分的强度。强度必须在这个范围内[0, 1]；例如,(0.4 0.6 0.7)．
十六进制颜色码是字符向量或以散列符号(＃)之后是三个或六个十六进制数字，取值范围从0来F．这些值不区分大小写。因此，颜色编码“# FF8800”，“# ff8800”，“# F80”,“# f80”是等价的。

或者，您也可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三组和十六进制颜色编码。

颜色名称	短名称	RGB值	十六进制颜色代码	外观
`“红色”`	`“r”`	`(1 0 0)`	`“# FF0000”`
`“绿色”`	`“g”`	`(0 1 0)`	`“# 00 ff00”`
`“蓝色”`	`“b”`	`(0 0 1)`	`“# 0000 ff”`
`“青色”`	`“c”`	`(0 1 1)`	`“# 00飞行符”`
`“红色”`	`“m”`	`(1 0 1)`	`“#”就`
`“黄色”`	`“y”`	`(1 1 0)`	`“# FFFF00”`
`“黑色”`	`“k”`	`(0 0 0)`	`“000000 #”`
`“白色”`	`“w”`	`(1 1 1)`	`“# FFFFFF”`

下面是MATLAB在许多类型的图中使用的默认颜色的RGB三组和十六进制颜色代码。

RGB值	十六进制颜色代码	外观
`[0 0.4470 - 0.7410)`	`“# 0072 bd”`
`(0.8500 0.3250 0.0980)`	`“# D95319”`
`(0.9290 0.6940 0.1250)`	`“# EDB120”`
`(0.4940 0.1840 0.5560)`	`“# 7 e2f8e”`
`(0.4660 0.6740 0.1880)`	`“# 77 ac30”`
`(0.3010 0.7450 0.9330)`	`“# 4 dbeee”`
`(0.6350 0.0780 0.1840)`	`“# A2142F”`

`FaceAlpha`- - - - - -面对透明度
1(默认)|标量范围内`[0, 1]`|`“平”`|`的插值函数`|`“texturemap”`

脸部透明度，指定为以下值之一:

标量范围内[0, 1]-使用统一的透明度在所有的脸。的值1完全不透明0是完全透明的。之间的值0而且1是半透明的。的透明度值AlphaData财产。
“平”的值为每个面使用不同的透明度AlphaData财产。第一个顶点的透明度值决定了整个面的透明度。首先，您必须指定AlphaData属性作为与ZData财产。的FaceColor属性也必须设置为“平”．
的插值函数-使用插值的透明度为每个面基于的值AlphaData财产。通过在顶点处插入值，每个面的透明度都不同。首先，您必须指定AlphaData属性作为与ZData财产。的FaceColor属性也必须设置为的插值函数．
“texturemap”—转换数据AlphaData使它与表面一致。

`FaceLighting`- - - - - -轻物体在脸上的效果
`“平”`(默认)|`“古尔戈”`|`“没有”`

光物体在表面上的效果，指定为以下值之一:

“平”-将光线均匀地涂在每一张脸上。使用此值查看多面对象。
“古尔戈”-改变脸部的光线。计算在顶点处的光，然后线性插值光穿过面。使用此值查看曲面。
“没有”-不要将轻物体的光线照射到脸上。

要向坐标轴添加轻对象，请使用光函数。

请注意

的“冯氏”值已被删除。使用“古尔戈”代替。

扩展功能

GPU数组
通过使用并行计算工具箱™在图形处理单元(GPU)上运行来加速代码。

使用注意事项和限制:

该函数接受GPU阵列，但不运行在GPU上。

有关更多信息，请参见在图形处理器上运行MATLAB函数(并行计算工具箱)．

分布式阵列
使用并行计算工具箱™跨集群的组合内存分区大型数组。

使用注意事项和限制:

这个函数操作在分布式数组上，但是在客户端MATLAB中执行。

有关更多信息，请参见运行MATLAB函数与分布式数组(并行计算工具箱)．

版本历史

之前介绍过的R2006a

另请参阅

功能

colormap|pcolor|meshgrid|显示亮度图像|阴影|视图|网

属性

表面性质

主题