clabel

为等高线图添加高程标签

全页折叠

语法

clabel(C,h)

clabel(C,h,v)

clabel(C,h,'manual')

t = clabel(C,h,'manual')

clabel(C)

clabel(C,v)

clabel(C,'manual')

tl = clabel(___)

clabel(___,Name,Value)

说明

clabel(C,h) 为当前等高线图添加标签，将旋转文本插入每条等高线。等高线必须足够长以容纳标签，否则 clabel 无法插入标签。如果没有等高线矩阵 C，则将 C 替换为 []。

示例

clabel(C,h,v) 为由向量 v 指定的等高线层级添加标签。

示例

clabel(C,h,'manual') 为您用鼠标选择的位置添加标签。点击鼠标或按空格键可标记最接近十字准线中心的等高线。当光标位于图窗窗口中时，按 Return 键以终止标记。

t = clabel(C,h,'manual') 返回创建的文本对象。

clabel(C) 使用 '+' 符号和垂直向上的文本为等高线添加标签。

示例

clabel(C,v) 将垂直向上的标签添加到由向量 v 指定的等高线层级。

clabel(C,'manual') 在您使用鼠标选择的位置添加垂直向上的标签。点击鼠标或按空格键可标记最接近十字准线中心的等高线。当光标位于图窗窗口中时，按 Return 键以终止标记。

tl = clabel(___) 返回创建的文本和线条对象。使用上述语法中不包含等高线对象 h 的任意输入参量组合。

clabel(___,Name,Value) 使用一个或多个 Name,Value 对组参量修改标签外观。使用上述语法中的任何输入参量组合。例如，'FontSize',14 将字体大小设置为 14 磅。

示例

全部折叠

为等高线图添加层级标签

打开实时脚本

创建一个等高线图并获取等高线矩阵 C 和等高线对象 h。然后，为等高线图添加标签。

[x,y,z] = peaks;
[C,h] = contour(x,y,z);   
clabel(C,h)

为特定的等高线层级添加标签

打开实时脚本

仅为等高线层级为 2 或 6 的等高线添加标签。

[x,y,z] = peaks;
[C,h] = contour(x,y,z);
v = [2,6];
clabel(C,h,v)

设置等高线标签属性

打开实时脚本

使用 Name,Value 对组参量，将标签的字体大小设置为 15 磅并将颜色设置为红色。

[x,y,z] = peaks;
[C,h] = contour(x,y,z);
clabel(C,h,'FontSize',15,'Color','red')

通过重新发出 clabel 命令设置其他属性。例如，将字体粗细设置为粗体并将颜色更改为蓝色。

clabel(C,h,'FontWeight','bold','Color','blue')

使用 'default' 关键字将字体大小重新设置为默认大小。

clabel(C,h,'FontSize','default')

使用垂直文本为等高线图添加标签

打开实时脚本

创建一个等高线图并返回等高线矩阵 C。然后，为等高线添加标签。

[x,y,z] = peaks;
C = contour(x,y,z);  
clabel(C)

输入参数

全部折叠

`C` — 等高线矩阵
二行矩阵

contour、contour3 或 contourf 函数返回的等高线矩阵。C 包含用于定义等高线的数据。有关等高线矩阵的详细信息，请参阅 ContourMatrix。

注意

如果您将等高线对象 h 传递到 clabel 函数，则可以将 C 替换为 []。例如，使用 clabel([],h)。

`h` — 等高线对象
等高线对象

contour、contour3 或 contourf 函数返回的等高线对象。

`v` — 等高线层级值
向量

等高线层级值，指定为由单个值组成的一个行或列向量。

示例: [0 10 20]

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但参量对组的顺序无关紧要。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: clabel(C,h,'Color','red','FontSize',12) 指定红色的 12 磅标签。

clabel 支持 LabelSpacing 属性以及一部分文本属性。

`LabelSpacing` — 标签间距
标量

各标签之间的间距，指定为以磅为单位的标量值。

注意

将此选项与 clabel(C,h) 或 clabel(C,h,v) 语法结合使用。其他语法不支持此选项。

示例: clabel(C,h,'LabelSpacing',100)

`Color` — 文本颜色
`[0 0 0]` (默认) | RGB 三元组 | 十六进制颜色代码 | `'r'` | `'g'` | `'b'` | ...

文本颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认值 [0 0 0] 对应于黑色。

对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。

RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4 0.6 0.7]。
十六进制颜色代码是字符串标量或字符向量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。这些值不区分大小写。因此，颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。

此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称	短名称	RGB 三元组	十六进制颜色代码	外观
`"red"`	`"r"`	`[1 0 0]`	`"#FF0000"`
`"green"`	`"g"`	`[0 1 0]`	`"#00FF00"`
`"blue"`	`"b"`	`[0 0 1]`	`"#0000FF"`
`"cyan"`	`"c"`	`[0 1 1]`	`"#00FFFF"`
`"magenta"`	`"m"`	`[1 0 1]`	`"#FF00FF"`
`"yellow"`	`"y"`	`[1 1 0]`	`"#FFFF00"`
`"black"`	`"k"`	`[0 0 0]`	`"#000000"`
`"white"`	`"w"`	`[1 1 1]`	`"#FFFFFF"`
`"none"`	不适用	不适用	不适用	无颜色

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

RGB 三元组	十六进制颜色代码	外观
`[0 0.4470 0.7410]`	`"#0072BD"`
`[0.8500 0.3250 0.0980]`	`"#D95319"`
`[0.9290 0.6940 0.1250]`	`"#EDB120"`
`[0.4940 0.1840 0.5560]`	`"#7E2F8E"`
`[0.4660 0.6740 0.1880]`	`"#77AC30"`
`[0.3010 0.7450 0.9330]`	`"#4DBEEE"`
`[0.6350 0.0780 0.1840]`	`"#A2142F"`

示例: 'blue'

示例: [0 0 1]

示例: '#0000FF'

`EdgeColor` — 文本框轮廓的颜色
`'none'` (默认) | RGB 三元组 | 十六进制颜色代码 | `'r'` | `'g'` | `'b'` | ...

文本框轮廓的颜色，指定为 'none'、RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。

RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4 0.6 0.7]。
十六进制颜色代码是字符串标量或字符向量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。这些值不区分大小写。因此，颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。

此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称	短名称	RGB 三元组	十六进制颜色代码	外观
`"red"`	`"r"`	`[1 0 0]`	`"#FF0000"`
`"green"`	`"g"`	`[0 1 0]`	`"#00FF00"`
`"blue"`	`"b"`	`[0 0 1]`	`"#0000FF"`
`"cyan"`	`"c"`	`[0 1 1]`	`"#00FFFF"`
`"magenta"`	`"m"`	`[1 0 1]`	`"#FF00FF"`
`"yellow"`	`"y"`	`[1 1 0]`	`"#FFFF00"`
`"black"`	`"k"`	`[0 0 0]`	`"#000000"`
`"white"`	`"w"`	`[1 1 1]`	`"#FFFFFF"`
`"none"`	不适用	不适用	不适用	无颜色

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

RGB 三元组	十六进制颜色代码	外观
`[0 0.4470 0.7410]`	`"#0072BD"`
`[0.8500 0.3250 0.0980]`	`"#D95319"`
`[0.9290 0.6940 0.1250]`	`"#EDB120"`
`[0.4940 0.1840 0.5560]`	`"#7E2F8E"`
`[0.4660 0.6740 0.1880]`	`"#77AC30"`
`[0.3010 0.7450 0.9330]`	`"#4DBEEE"`
`[0.6350 0.0780 0.1840]`	`"#A2142F"`

示例: clabel(C,h,'EdgeColor','k')

`BackgroundColor` — 背景色
`'none'` (默认) | RGB 三元组 | 十六进制颜色代码 | `'r'` | `'g'` | `'b'` | ...

文本框背景色，指定为 'none'、RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。

RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4 0.6 0.7]。
十六进制颜色代码是字符串标量或字符向量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。这些值不区分大小写。因此，颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。

此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称	短名称	RGB 三元组	十六进制颜色代码	外观
`"red"`	`"r"`	`[1 0 0]`	`"#FF0000"`
`"green"`	`"g"`	`[0 1 0]`	`"#00FF00"`
`"blue"`	`"b"`	`[0 0 1]`	`"#0000FF"`
`"cyan"`	`"c"`	`[0 1 1]`	`"#00FFFF"`
`"magenta"`	`"m"`	`[1 0 1]`	`"#FF00FF"`
`"yellow"`	`"y"`	`[1 1 0]`	`"#FFFF00"`
`"black"`	`"k"`	`[0 0 0]`	`"#000000"`
`"white"`	`"w"`	`[1 1 1]`	`"#FFFFFF"`
`"none"`	不适用	不适用	不适用	无颜色

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

RGB 三元组	十六进制颜色代码	外观
`[0 0.4470 0.7410]`	`"#0072BD"`
`[0.8500 0.3250 0.0980]`	`"#D95319"`
`[0.9290 0.6940 0.1250]`	`"#EDB120"`
`[0.4940 0.1840 0.5560]`	`"#7E2F8E"`
`[0.4660 0.6740 0.1880]`	`"#77AC30"`
`[0.3010 0.7450 0.9330]`	`"#4DBEEE"`
`[0.6350 0.0780 0.1840]`	`"#A2142F"`

示例: clabel(C,h,'BackgroundColor','g')

`FontSize` — 字体大小
`10` (默认) | 大于 0 的标量值

字体大小，指定为大于 0 的标量值。默认情况下，字体大小使用磅为单位。一磅等于 1/72 英寸。但是，某些语法允许您使用 FontUnits 属性更改字体单位。

示例: clabel(C,h,'FontSize',15)

`FontName` — 字体名称
支持的字体名称 | `"FixedWidth"`

字体名称，指定为支持的字体名称或 "FixedWidth"。要正确显示和打印文本，您必须选择系统支持的字体。默认字体取决于您的操作系统和区域设置。

要使用在任何区域设置中都有较好显示效果的等宽字体，请使用 "FixedWidth"。等宽字体依赖于根 FixedWidthFontName 属性。设置根 FixedWidthFontName 属性会导致立即更新显示方式以使用新字体。

`FontAngle` — 字符倾斜
`'normal'` (默认) | `'italic'`

字符倾斜，指定为 'normal' 或 'italic'。

并非所有字体都有两种字体样式。因此，斜体可能看上去和常规字体一样。

`FontWeight` — 字符粗细
`'normal'` (默认) | `'bold'`

字符粗细，指定为 'normal' 或 'bold'。

MATLAB 使用 FontWeight 属性从系统提供的字体中选择一种字体。并非所有字体都有加粗字体。因此，指定加粗字体仍可能得到普通字体。

`FontSmoothing` — 字体平滑处理
`'on'` (默认) | on/off 逻辑值

字体平滑处理，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

'on' - 应用字体平滑处理。减少文本字符中出现参差不齐，使文本更易于读取。
'off' - 不应用字体平滑处理。

示例: clabel(C,h,'FontSmoothing','on')

注意

FontSmoothing 名称-值参量在以后的版本中将不起作用。无论值是多少，都将启用字体平滑处理。

`FontUnits` — 字体大小单位
`'points'` (默认) | `'inches'` | `'centimeters'` | `'characters'` | `'normalized'` | `'pixels'`

字体大小单位，指定为此表中的一个值。

`Units`	描述
`'points'`	磅。一磅等于 1/72 英寸。
`'inches'`	英寸。
`'centimeters'`	厘米。
`'characters'`	基于默认系统字体的字符大小。字符宽度 = 字母 `x` 的宽度。字符高度 = 两个文本行的基线之间的距离。
`'normalized'`	按坐标区高度的一定比例来解释字体大小。如果您调整坐标区的大小，则字体大小也会相应地修改。例如，如果 `FontSize` 为 `0.1`（归一化单位），则文本为坐标区高度的 1/10。
`'pixels'`	像素。从 R2015b 开始，以像素为单位的距离不再依赖 Windows^® 和 Macintosh 系统上的系统分辨率：在 Windows 系统上，一个像素是 1/96 英寸。在 Macintosh 系统上，一个像素是 1/72 英寸。在 Linux^® 系统上，一个像素的大小由系统分辨率确定。

如果在一次函数调用中同时设置字体大小和字体单位，必须先设置 FontUnits 属性以使坐标区能正确解释指定的字体大小。

注意

clabel(C,h) 和 clabel(C,h,v) 语法不支持此选项。它们始终使用默认磅值。

示例: clabel(C,'FontUnits','normalized')

`Rotation` — 文本方向
`0` (默认) | 标量

文本方向，指定为以度为单位的标量值。默认的 0 度旋转可使文本处于水平。对于垂直文本，请将此属性设置为 90 或 -90。设置为正值可逆时针旋转文本。设置为负值可顺时针旋转文本。

注意

clabel(C,h) 和 clabel(C,h,v) 语法不支持此选项。它们是将旋转文本插入等高线，每个标签都旋转以匹配相应线条局部的走向。

示例: clabel(C,'Rotation',90)

`Interpreter` — 文本字符的解释
`'tex'` (默认) | `'latex'` | `'none'`

文本字符的解释，指定为下列值之一：

'tex' - 使用 TeX 标记显示文本。
'latex' - 使用 LaTeX 标记显示文本。
'none' - 显示字面字符。

由于标签是数值文本，此属性的效果仅限于字体样式和粗细的细微更改。

示例: clabel(C,h,'Interpreter','latex')

`LineStyle` — 文本框轮廓的线型
`'-'` (默认) | `'--'` | `':'` | `'-.'` | `'none'`

文本框轮廓的线型，指定为此表中的线型之一。

线型	描述	表示的线条
`"-"`	实线
`"--"`	虚线
`":"`	点线
`"-."`	点划线
`"none"`	无线条	无线条

示例: clabel(C,h,'LineStyle','--')

`LineWidth` — 文本框轮廓的宽度
`0.5` (默认) | 标量

文本框轮廓的宽度，指定为标量值（以磅为单位）。一磅等于 1/72 英寸。

示例: clabel(C,h,'LineWidth',1)

`Margin` — 文本框中文本周围的空间
`3` (默认) | 标量

文本框中文本周围的空间，指定为标量值（以磅为单位）。

MATLAB 使用 Extent 属性值以及 Margin 属性值来确定文本框的大小。

示例: clabel(C,h,'Margin',4)

输出参量

全部折叠

`t` — 文本对象
向量

文本对象，以向量形式返回。文本对象的 String 属性包含所显示的等高线值。

`tl` — 文本和线条对象
向量

文本和线条对象，以向量形式返回。文本对象的 String 属性包含所显示的等高线值。线条对象对应于 '+' 符号。

扩展功能

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

用法说明和限制：

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

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

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

用法说明和限制：

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

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

版本历史记录

在 R2006a 之前推出

全部展开

R2023b: 设置 `Color` 名称-值参量还会设置 `Contour` 对象的 `LabelColor`

如果在调用 clabel 函数时设置 Color 名称-值参量，则 Contour 对象的 LabelColor 属性将更新为指定的颜色值。

R2022a: `FontSmoothing` 在以后的版本中将不起作用

FontSmoothing 名称-值参量在以后的版本中将不起作用。无论该参量的值如何，对所有等高线标签都将启用字体平滑处理。

clabel

语法

说明

示例

为等高线图添加层级标签

为特定的等高线层级添加标签

设置等高线标签属性

使用垂直文本为等高线图添加标签

输入参数

C — 等高线矩阵 二行矩阵

h — 等高线对象 等高线对象

v — 等高线层级值 向量

名称-值参数

LabelSpacing — 标签间距 标量

Color — 文本颜色 [0 0 0] (默认) | RGB 三元组 | 十六进制颜色代码 | 'r' | 'g' | 'b' | ...

EdgeColor — 文本框轮廓的颜色 'none' (默认) | RGB 三元组 | 十六进制颜色代码 | 'r' | 'g' | 'b' | ...

BackgroundColor — 背景色 'none' (默认) | RGB 三元组 | 十六进制颜色代码 | 'r' | 'g' | 'b' | ...

FontSize — 字体大小 10 (默认) | 大于 0 的标量值

FontName — 字体名称 支持的字体名称 | "FixedWidth"

FontAngle — 字符倾斜 'normal' (默认) | 'italic'

FontWeight — 字符粗细 'normal' (默认) | 'bold'

FontSmoothing — 字体平滑处理 'on' (默认) | on/off 逻辑值

FontUnits — 字体大小单位 'points' (默认) | 'inches' | 'centimeters' | 'characters' | 'normalized' | 'pixels'

Rotation — 文本方向 0 (默认) | 标量

Interpreter — 文本字符的解释 'tex' (默认) | 'latex' | 'none'

LineStyle — 文本框轮廓的线型 '-' (默认) | '--' | ':' | '-.' | 'none'

LineWidth — 文本框轮廓的宽度 0.5 (默认) | 标量

Margin — 文本框中文本周围的空间 3 (默认) | 标量

输出参量

t — 文本对象 向量

tl — 文本和线条对象 向量

扩展功能

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

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

版本历史记录

R2023b: 设置 Color 名称-值参量还会设置 Contour 对象的 LabelColor

R2022a: FontSmoothing 在以后的版本中将不起作用

另请参阅

函数

属性

WeChat

`C` — 等高线矩阵
二行矩阵

`h` — 等高线对象
等高线对象

`v` — 等高线层级值
向量

`LabelSpacing` — 标签间距
标量

`Color` — 文本颜色
`[0 0 0]` (默认) | RGB 三元组 | 十六进制颜色代码 | `'r'` | `'g'` | `'b'` | ...

`EdgeColor` — 文本框轮廓的颜色
`'none'` (默认) | RGB 三元组 | 十六进制颜色代码 | `'r'` | `'g'` | `'b'` | ...

`BackgroundColor` — 背景色
`'none'` (默认) | RGB 三元组 | 十六进制颜色代码 | `'r'` | `'g'` | `'b'` | ...

`FontSize` — 字体大小
`10` (默认) | 大于 0 的标量值

`FontName` — 字体名称
支持的字体名称 | `"FixedWidth"`

`FontAngle` — 字符倾斜
`'normal'` (默认) | `'italic'`

`FontWeight` — 字符粗细
`'normal'` (默认) | `'bold'`

`FontSmoothing` — 字体平滑处理
`'on'` (默认) | on/off 逻辑值

`FontUnits` — 字体大小单位
`'points'` (默认) | `'inches'` | `'centimeters'` | `'characters'` | `'normalized'` | `'pixels'`

`Rotation` — 文本方向
`0` (默认) | 标量

`Interpreter` — 文本字符的解释
`'tex'` (默认) | `'latex'` | `'none'`

`LineStyle` — 文本框轮廓的线型
`'-'` (默认) | `'--'` | `':'` | `'-.'` | `'none'`

`LineWidth` — 文本框轮廓的宽度
`0.5` (默认) | 标量

`Margin` — 文本框中文本周围的空间
`3` (默认) | 标量

`t` — 文本对象
向量

`tl` — 文本和线条对象
向量

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

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

R2023b: 设置 `Color` 名称-值参量还会设置 `Contour` 对象的 `LabelColor`

R2022a: `FontSmoothing` 在以后的版本中将不起作用