ruler2num

将数据从特定的标尺转换为数值数据

语法

num = ruler2num(data,ruler)

num = ruler2num(data,ruler) 将 data 中的值转换为数值。ruler 输入表示与 data 关联的标尺，它决定如何将值映射到对应的数值。输出 num 的大小与输入 data 相同。

将日期值转换为等效的数值，以便设置文本对象的 Position 属性。

创建 x 轴为日期值的绘图。为第四个数据点添加文本说明，并返回文本对象。

t = datetime(2015,1,1:10);
y = [.2 .3 .5 .2 .8 .2 .3 .1 .3 .4];
plot(t,y,'-o')
txt = text(t(4),y(4),'My text');

Figure contains an axes object. The axes object contains 2 objects of type line, text.

通过设置文本对象的 Position 属性，将文本的位置更改到第六个数据点。由于 Position 属性只接受数值，因此需要将第六个数据点的日期时间值转换为等效的数值。

ax = gca;
x6 = ruler2num(t(6),ax.XAxis);
txt.Position = [x6 y(6)];

Figure contains an axes object. The axes object contains 2 objects of type line, text.

输入数组，指定为标量、向量或矩阵。如果 data 已经是数值，则输出 num 等于输入 data。

与输入数据相关联的标尺，指定为以下标尺对象类型之一：

DurationRuler 对象 - 将 data 中的持续时间值转换为数值。
DatetimeRuler 对象 - 将 data 中的日期时间值转换为数值。要控制如何将日期时间值转换为 double 值，请将标尺的 ReferenceDate 属性设置为具有所需时区的日期时间值。
NumericRuler 对象 - 大多数情况下不转换。但是，如果输入数据不是数值，则输出是 num = full(double(data))。
CategoricalRuler 对象 - 将 data 中的分类值转换为数值。要控制类别的顺序，请设置标尺的 Categories 属性。
GeographicRuler 对象 - 不转换。输出等于输入。

将标尺对象指定为 Axes 对象的 XAxis、YAxis 或 ZAxis 属性。例如：

ax = gca;
num = ruler2num(data,ax.XAxis)

在 R2016b 中推出