Main Content

rticklabels

设置或查询 r 轴刻度标签

说明

示例

rticklabels(labels) 设置当前坐标区的 r 轴刻度标签。可将 labels 指定为字符串数组或字符向量元胞数组,例如 {'January','February','March'}。如果您指定标签,则 r 轴刻度值和刻度标签不会再根据对坐标区所做的更改而自动更新。

rl = rticklabels 返回当前坐标区的 r 轴刻度标签。

示例

rticklabels('auto') 设置自动模式,从而允许坐标区确定 r 轴刻度标签。如果您设置了标签,然后又想将它们设置回默认值,则可以使用此选项。

rticklabels('manual') 设置手动模式,从而将 r 轴刻度标签冻结在当前值。

m = rticklabels('mode') 返回 r 轴刻度标签模式的当前值,即 'auto''manual'。默认情况下,该模式为自动,除非您指定刻度标签或将模式设置为手动。

示例

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

示例

全部折叠

创建一个极坐标图。在 r 轴上的值 0.1、0.3 和 0.5 处显示刻度线和网格线。然后为每个刻度线指定一个标签。

theta = linspace(0,2*pi);
rho = theta/10;
polarplot(theta,rho)
rticks([0.1 0.25 0.5])
rticklabels({'r = .1','r = .3','r = .5'})

Figure contains an axes object. The axes object contains an object of type line.

创建一个极坐标图,并将极坐标区对象赋给变量 pax。通过指定 pax 作为 rticksrticklabels 函数的第一个输入参数,确保这两个函数作用于您刚创建的极坐标区。

theta = 0:0.01:2*pi;
rho = 50*sin(2*theta);
polarplot(theta,rho)
pax = gca;

rticks(pax,[10 25 50])
rticklabels(pax,{'r = 10','r = 25','r = 50'})

Figure contains an axes object. The axes object contains an object of type line.

创建一个极坐标图并指定 r 轴刻度值和对应的标签。然后,将 r 轴刻度值和标签设置回默认值。

theta = linspace(0,2*pi);
rho = theta/10;
polarplot(theta,rho)
rticks([0.1 0.25 0.5])
rticklabels({'r = .1','r = .3','r = .5'})

Figure contains an axes object. The axes object contains an object of type line.

rticks('auto')
rticklabels('auto')

Figure contains an axes object. The axes object contains an object of type line.

通过指定刻度标签为空数组,删除 r 轴上的刻度标签。

theta = 0:0.01:2*pi;
rho = 50*sin(2*theta);
polarplot(theta,rho)
rticklabels({})

Figure contains an axes object. The axes object contains an object of type line.

输入参数

全部折叠

刻度标签,指定为字符向量元胞数组、字符串数组或分类数组。如果您不希望显示刻度标签,请指定空元胞数组 {}。刻度标签支持 TeX 和 LaTeX 标记。有关详细信息,请参阅坐标区对象的 TickLabelInterpreter 属性。

示例: rticklabels({'0','\pi','2\pi'})

示例: rticklabels({'January','Febrary','March'})

示例: rticklabels({})

注意

  • 要指定刻度值,请使用 rticks 函数。

  • 如果没有为所有刻度值指定足够的标签,则 MATLAB® 会为其余的刻度使用空字符向量标签。

  • 如果将刻度标签指定为分类数组,MATLAB 将使用数组中的值,而不是类别。

极坐标区或极坐标区数组。如果不指定此参数,则 rticklabels 会修改当前坐标区(前提是当前坐标区是极坐标区对象)。

输出参数

全部折叠

当前刻度标签,以字符向量元胞数组或字符数组形式返回。

当前刻度标签模式,返回为下列值之一:

  • 'auto' - 坐标区自动确定 r 轴刻度标签。

  • 'manual' - 坐标区使用手动指定的 r 轴刻度标签。

详细信息

全部折叠

刻度标签

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

算法

rticklabels 函数可设置和查询与 r 轴刻度标签相关的多个极坐标区属性。

  • RTickLabel - 存储 r 轴刻度标签文本的属性。

  • RTickLabelMode - 存储 r 轴刻度标签模式的属性。当您使用 rticklabels 设置 r 轴刻度标签时,此属性将更改为 'manual'

  • RTickMode - 存储 r 轴刻度值模式的属性。当您使用 rticklabels 设置 r 轴刻度标签时,此属性将更改为 'manual'

版本历史记录

在 R2016b 中推出