num2ruler

转换数值数据以用于特定标尺

语法

data = num2ruler(num,ruler)

说明

data = num2ruler(num,ruler) 将 num 中的数值转换为适合指定标尺的值。生成的值取决于 ruler 输入的类型和范围。输出 data 是与 num 具有相同大小的数组。

示例

将数值转换为等效的日期值

将 ginput 的输出从数值转换为等效的日期值。

创建 x 轴为日期值的绘图。然后点击坐标区上的某个点，并使用 ginput 函数返回该选定点的位置。

t = datetime(2015,1,1:10);
y = rand(10,1);
plot(t,y)
ax = gca;
[x,y] = ginput(1)

x =

    5.8168


y =

    0.6458

ginput 函数以数值形式返回该位置。使用 num2ruler 确定与 x 的返回数值等效的日期值。

xdate = num2ruler(x,ax.XAxis)

xdate = 

   06-Jan-2015 19:36:13

输入参数

num — 数值数据

数组

数值数据，指定为数组。

示例: num = [1 2 3]

ruler — 决定数据映射的标尺

DurationRuler 对象 | DatetimeRuler 对象 | NumericRuler 对象 | CategoricalRuler 对象 | GeographicRuler 对象

决定数据映射的标尺，指定为下列类型的标尺对象之一：

• DurationRuler 对象 - 将 num 中的值转换为持续时间值。

• DatetimeRuler 对象 - 将 num 中的值转换为日期时间值。要控制如何将数值转换为 datetime 值，请将标尺的 ReferenceDate 属性设置为具有所需时区的日期时间值。

• NumericRuler 对象 - 不转换。输出等于输入。

• CategoricalRuler 对象 - 将 num 中的值转换为分类值。要控制类别的顺序，请设置标尺的 Categories 属性。

• GeographicRuler 对象 - 不转换。输出等于输入。

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

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

版本历史记录

在 R2016b 中推出

另请参阅

ruler2num | axes | datetime | duration