2026a

# xlabel

为 x 轴添加标签

函数库: TyPlot

# 语法

xlabel(txt)
xlabel(target,txt)

xlabel(___,Key=Value)
t = xlabel(___)

# 说明

xlabel(txt)对当前坐标区或独立可视化的x轴加标签。重新发出xlabel命令会将旧标签替换为新标签。示例

xlabel(target，txt)为指定的目标对象添加标签。示例

xlabel(___,Key=Value)使用一个或多个名称-值对组参数修改标签外观。有关属性和说明的列表，请参阅 text 属性。例如，fontsize=12将字体大小设置为12磅。在所有其他输入参数之后指定名称-值对组参数。并非所有图形类型均支持修改标签外观。示例

t=xlabel(___)返回用作x轴标签的文本对象。使用t可在创建标签后对其进行修改。示例。有关属性和说明的列表，请参阅 text 属性。

# 示例

为 x 轴添加标签

将 Population 显示在 x 轴下

using TyPlot
plot((1:10).^2)
xlabel("Population")

创建多行 x 轴标签

使用"\n"创建多行标签。

using TyPlot
plot((1:10).^2)
xlabel("Population\n(in thousands)")

将希腊字母包括在 x 轴标签中

使用 TeX 标记将希腊字母和其他特殊字符包括在标签中。

using TyPlot
x = LinRange(-2 * pi, 2 * pi, 100);
y = sin.(x);
plot(x, y)
xlabel(raw"$-2\pi \leq x \leq 2\pi$")

在 x 轴标签中包括变量值

添加带有文本和变量值的标签。使用 string 函数在标签中包含变量值。

using TyPlot
plot((1:10).^2)
year = 2014;
xlabel("Population for Year "*string(year))

在轴标签中包括上标和下标

使用 "^" 和 "_" 字符在轴标签中包含上标和下标。使用花括号 {} 修改多个字符。

using TyPlot
t = LinRange(0, 1, 100);
y = exp.(t);
plot(t, y)
xlabel(raw"$t_{seconds}$")
ylabel(raw"$e^t$")

更改 x 轴标签字体大小和颜色

使用 Key=Value 对组参数设置 x 轴标签的字体大小、字体粗细和文本颜色属性。

using TyPlot
plot((1:10).^2)
xlabel("Population",fontsize=12,fontweight="bold",color="r")

为特定绘图的 x 轴添加标签

调用 subplot 函数以创建一个 2×1 分块图布局和一个坐标区对象，创建坐标区对象 ax1 和 ax2。将数据绘制到每个坐标区中，并为顶部图创建 x 轴标签。

using TyPlot
ax1 = subplot(2,1,1)
plot(ax1, (1:10).^2)
xlabel(ax1, "Population")

ax2 = subplot(2,1,2)
plot(ax2, (1:10).^3)

在创建后修改 x 轴标签

为 x 轴添加标签并返回用作标签的文本对象。

using TyPlot
plot((1:10).^2)
t = xlabel("Population");

使用 t 可在创建标签后设置标签的文本属性。例如，将标签的颜色设置为红色。使用圆点表示法设置属性。

t.set_color("red")
gca().stale=true
plt_update()

# 输入参数

txt - 轴标签

字符串标量 | 数值

轴标签，指定为字符串标量、数值。

示例： "my label"

示例： 123

要将数值变量和文本包括在标签中，请使用 string 函数。例如：

x = 42;
str = string("The value is " , string(x));

要包括特殊字符（例如希腊字母或数学符号），请使用 TeX 标记。

要创建多行标签：

使用字符串，其中以"\n"表示换行，例如 "first line\nsecond line"。

使用 @sprintf("%g",value) 将数值型标签转换为文本。例如，12345678 显示为 1.23457e+07。

target - 标签的目标

Axes 对象

标签的目标，指定为 Axes 对象。

如果不指定目标，则 xlabel 函数会 gca 命令返回的图形对象添加标签。

# 名称-值对组参数

指定可选的、以逗号分隔的 Key=Value 对组参数。Key 为参数名称，Value 为对应的值。您可采用任意顺序指定多个名称-值对组参数，如 Key1=Value1,...,KeyN=ValueN 所示。

示例： color="red",fontsize=12 指定红色的 12 磅字体。

除了以下属性之外，还可以使用 Key=Value 对组参数指定其他文本对象属性。请参见 text 属性。

fontsize - 字体大小

11 （默认） | 大于 0 的标量值

字体大小，指定为大于 0 的标量值（以磅为单位）。一磅等于 1/72 英寸。

fontweight - 字符粗细

"normal" （默认） | "bold"

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

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

fontname - 字体名称

微软雅黑（默认）

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

color - 文本颜色

[0.15,0.15,0.15] （默认） | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

文本颜色，指定为 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"	不适用	[0, 0.5019607843137255, 0]	"#008000"
不适用	"g"	[0, 0.5, 0]	"#007F00"
不适用	不适用	[0, 1, 0]	"#00FF00"
"blue"	"b"	[0, 0, 1]	"#0000FF"
"cyan"	不适用	[0, 1, 1]	"#00FFFF"
不适用	"c"	[0, 0.75, 0.75]	"#00BFBF"
"magenta"	不适用	[1, 0, 1]	"#FF00FF"
不适用	"m"	[0.75, 0, 0.75]	"#BF00BF"
"yellow"	不适用	[1, 1, 0]	"#FFFF00"
不适用	"y"	[0.75, 0.75, 0]	"#BFBF00"
"black"	"k"	[0, 0, 0]	"#000000"
"white"	"w"	[1, 1, 1]	"#FFFFFF"
"none"	不适用	不适用	不适用	无颜色

以下是 Syslab 在许多类型的绘图中使用的默认颜色的 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"