目录

语法

说明

示例

指定 z 轴刻度值和标签

指定非均匀 z 轴刻度值

以 2 为增量递增 z 轴刻度值

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

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

删除 z 轴刻度线

---

        zticks函数的功能是设置或查询 z 轴刻度值。

语法

zticks(ticks)
zt = zticks
zticks('auto')
zticks('manual')
m = zticks('mode')
___ = zticks(ax,___)

说明

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

        zt = zticks 以向量形式返回当前 z 轴刻度值。

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

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

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

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

示例

指定 z 轴刻度值和标签

        创建一个曲面图。在 z 轴的值 -8、0 和 8 处显示刻度线。然后为每个刻度线指定一个标签。

[x,y,z] = peaks;
surf(x,y,z)
zticks([-8 0 8])
zticklabels({'z = -8','z = 0','z = 8'})

如图所示：

指定非均匀 z 轴刻度值

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

[x,y,z] = peaks;
surf(peaks)
zticks([-10 -2.5 0 2.5 10])

如图所示：

以 2 为增量递增 z 轴刻度值

        沿 z 轴以 2 为增量显示刻度线，从 -10 开始，在 10 结束。

[x,y,z] = peaks;
surf(peaks)
zticks([-10:2:10])

如图所示：

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

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

t = 0:pi/50:10*pi;
st = sin(t);
ct = cos(t);
plot3(st,ct,t)
zticks(0:8:40)

如图所示：

zticks('auto')

如图所示：

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

        从 R2019b 开始，可以使用 tiledlayout 和 nexttile 函数显示分块图。调用 tiledlayout 函数以创建一个 2×1 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1 和 ax2。创建两个三维针状图，并通过将 ax1 作为 zticks 函数的第一个输入参数进行传递，设置上部图的 z 轴刻度值。

tiledlayout(2,1)
ax1 = nexttile;
stem3(ax1,4*rand(5))
zticks(ax1,[0 1.5 3.25])

ax2 = nexttile;
stem3(ax2,4*rand(5))

如图所示：

删除 z 轴刻度线

        通过将刻度值指定为空数组来删除沿 z 轴的刻度线。删除刻度线还会删除 z 方向上的任何网格线。

[x,y,z] = peaks;
mesh(x,y,z)
zticks([])

如图所示：

参数说明

ticks — 刻度值

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

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

注意

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

ax — 目标坐标区

        目标坐标区，指定为 Axes 对象或 Axes 对象数组。如果不指定此参数，则 zticks 会修改当前坐标区。

zt — 当前刻度值

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

m — 当前模式

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

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

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

刻度值

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

如图所示：

算法

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

• ZTick - 用于存储 z 轴刻度值的属性。

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