Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

ruler2num

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

说明

示例

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 对象的 XAxisYAxisZAxis 属性。例如:

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

版本历史记录

在 R2016b 中推出

另请参阅

| | |