yticks

设置或查询 y 轴刻度值

语法

yticks(ticks)

yt = yticks

yticks('auto')

yticks('manual')

m = yticks('mode')

___ = yticks(ax,___)

说明

yticks(ticks) 设置 y 轴刻度值，这些值是 y 轴上显示刻度线的位置。指定 ticks 为递增值向量；例如 [0 2 4 6]。此命令作用于当前坐标区。

yt = yticks 以向量形式返回当前 y 轴刻度值。

yticks('auto') 设置自动模式，使坐标区确定 y 轴刻度值。如果您更改了刻度值，然后又想将它们设置回默认值，则可以使用此选项。

yticks('manual') 设置手动模式，将 y 轴刻度值冻结在当前值。如果您希望在调整坐标区大小或者向坐标区添加新数据时保留当前刻度值，则可以使用此选项。

m = yticks('mode') 返回当前 y 轴刻度值模式：'auto' 或 'manual'。默认情况下，模式为自动，除非您指定刻度值或将模式更改为手动。

___ = yticks(ax,___) 使用 ax 指定的坐标区，而不是使用当前坐标区。指定 ax 作为上述任何语法的第一个输入参量。

示例

指定 y 轴刻度值和标签

创建一个线图。在 y 轴的值 0、50 和 100 处显示刻度线。然后为每个刻度线指定一个标签。

x = linspace(0,10);
y = x.^2;
plot(x,y)
yticks([0 50 100])
yticklabels({'y = 0','y = 50','y = 100'})

指定非均匀 y 轴刻度值

沿 y 轴以介于 0 和 25 之间的非均匀值显示刻度线。MATLAB® 用数值标注刻度线。

x = linspace(-5,5);
y = x.^2;
plot(x,y)
yticks([0 2 4 6 8 10 15 25])

以 25 为增量递增 y 轴刻度值

沿 y 轴以 25 为增量显示刻度线，从 0 开始，在 100 结束。

x = linspace(0,10);
y = x.^2;
plot(x,y)
yticks(0:25:100)

将 y 轴刻度值设置回默认值

创建一个针状图并指定 y 轴刻度值。然后，将 y 轴刻度值设置回默认值。

stem(1:10)
yticks([0 5 10])

yticks('auto')

指定特定坐标区的 y 轴刻度值

从 R2019b 开始，您可以使用 tiledlayout 和 nexttile 函数显示分块图。调用 tiledlayout 函数以创建一个 2×1 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1 和 ax2。在每个坐标区中绘制数据。通过将 ax2 作为 yticks 函数的第一个输入参量进行传递，设置下部图的 y 轴刻度。

tiledlayout(2,1)
ax1 = nexttile;
plot(rand(3))

ax2 = nexttile;
plot(rand(3))
yticks(ax2,0:.2:1)

删除 y 轴刻度线

通过将刻度值指定为空数组来删除沿 y 轴的刻度线。

x = linspace(0,10);
y = sin(x);
plot(x,y)
yticks([])

输入参数

ticks — 刻度值

由递增值组成的向量

刻度值，指定为由递增值组成的向量。如果您不需要沿 y 轴的刻度线，请指定空向量 []。

您可以指定数值、分类、日期时间或持续时间值形式的刻度值。但是，您指定的值的类型必须匹配 y 轴的值的类型。

示例: yticks([pi 2*pi 3*pi 4*pi])

示例: yticks(0:10:100)

示例: yticks([])

注意

要指定刻度标签，请使用 yticklabels 函数。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

ax — 目标坐标区

Axes 对象 | Axes 对象数组

目标坐标区，指定为 Axes 对象或 Axes 对象数组。

如果不指定此参量，则 yticks 会修改当前坐标区。

输出参量

yt — 当前刻度值

向量

当前刻度值，以向量的形式返回。

m — 当前模式

'auto' | 'manual'

当前模式，返回为下列值之一：

• 'auto' - 自动确定 y 轴刻度值。

• 'manual' - 使用手动指定的 y 轴刻度值。

详细信息

刻度值

刻度值是 y 轴上显示刻度线的位置。刻度标签是您在每个刻度线旁边看到的标签。使用 yticks 函数设置刻度值。使用 yticklabels 函数设置对应的刻度标签。

算法

yticks 函数设置并查询与 y 轴刻度值有关的多个坐标区属性。

• YTick - 用于存储 y 轴刻度值的属性。

• YTickMode - 用于存储 y 轴刻度值模式的属性。设置 y 轴刻度值时，此属性将更改为 'manual'。

版本历史记录

在 R2016b 中推出

另请参阅

函数

• xticks | zticks | ytickformat | yticklabels | ytickangle | ylim

属性

• Axes 属性

主题

• 指定坐标轴刻度值和标签