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)

関数 ginput は位置を数値として返します。num2ruler を使用して x に返された数値と等価の日付値を判別します。

xdate = num2ruler(x,ax.XAxis)

xdate = 

   06-Jan-2015 19:36:13

数値データ。配列として指定します。

例: num = [1 2 3]

データマッピングを決定するルーラー。以下のルーラーオブジェクトのタイプのいずれかとして指定します。

DurationRuler オブジェクト — num の値を duration 値に変換します。
DatetimeRuler オブジェクト — num の値を datetime 値に変換します。数値を datetime 値に変換する方法を制御するには、ルーラーの ReferenceDate プロパティを目的のタイムゾーンの datetime 値に設定します。
NumericRuler オブジェクト — 変換なし。出力は入力と等しくなります。
CategoricalRuler オブジェクト — num の値を categorical 値に変換します。カテゴリの順序を制御するには、ルーラーの Categories プロパティを設定します。
GeographicRuler オブジェクト — 変換なし。出力は入力と等しくなります。

Axes オブジェクトの XAxis、YAxis、または ZAxis プロパティとしてルーラーオブジェクトを指定します。以下に例を示します。

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

R2016b で導入