yticks

y 軸の目盛り値の設定またはクエリ

構文

yticks(ticks)

yt = yticks

yticks('auto')

yticks('manual')

m = yticks('mode')

___ = yticks(ax,___)

説明

yticks(ticks) は、y 軸の目盛り値を設定します。これらは、y 軸に沿って目盛りが表示される位置です。ticks は、増加する値からなるベクトルとして指定します。たとえば、[0 2 4 6] とします。このコマンドは、現在の座標軸に影響します。

yt = yticks は、現在の y 軸の目盛り値をベクトルとして返します。

yticks('auto') は、座標軸によって y 軸の目盛り値を決定できる自動モードに設定します。このオプションは、目盛り値を変更した後でそれらを既定値に戻す場合に使用します。

yticks('manual') は、y 軸の目盛り値を現在の値に固定する手動モードに設定します。このオプションは、座標軸のサイズ変更時や座標軸への新規データの追加時に、現在の目盛り値を保持する場合に使用します。

m = yticks('mode') は、現在の y 軸の目盛り値モードを 'auto' または 'manual' のいずれかとして返します。目盛り値を指定したりモードを手動に変更したりしない限り、自動モードが既定で使用されます。

___ = yticks(ax,___) は、現在の座標軸の代わりに ax で指定される座標軸を使用します。前述の構文いずれかの最初の入力引数として ax を指定します。

例

y 軸の目盛りの値とラベルの指定

ライン プロットを作成します。y 軸に沿って、値 0、50 および 100 の位置に目盛りを表示します。次に、各目盛りのラベルを指定します。

x = linspace(0,10);
y = x.^2;
plot(x,y)
yticks([0 50 100])
yticklabels({'y = 0','y = 50','y = 100'})

非等間隔で y 軸の目盛り値を指定

y 軸に沿って、0 から 25 までの非等間隔の値で目盛りを表示します。MATLAB® は、目盛りに数値のラベルを付けます。

x = linspace(-5,5);
y = x.^2;
plot(x,y)
yticks([0 2 4 6 8 10 15 25])

25 ずつインクリメントする y 軸の目盛り値

y 軸に沿って、0 から始まり 100 で終わる、25 ずつインクリメントする目盛りを表示します。

x = linspace(0,10);
y = x.^2;
plot(x,y)
yticks(0:25:100)

y 軸の目盛り値を既定値に戻す

ステム グラフを作成し、y 軸の目盛り値を指定します。その後、y 軸の目盛り値を既定値に設定し直します。

stem(1:10)
yticks([0 5 10])

yticks('auto')

特定の座標軸の y 軸の目盛り値を指定

R2019b 以降、関数 tiledlayout および nexttile を使用して、プロットをタイル表示できます。関数 tiledlayout を呼び出して、2 行 1 列のタイル表示チャート レイアウトを作成します。関数 nexttile を呼び出して、axes オブジェクト ax1 および ax2 を作成します。各座標軸にデータをプロットします。ax2 を関数 yticks の最初の入力引数として渡すことで、下のプロットの y 軸の目盛りを設定します。

tiledlayout(2,1)
ax1 = nexttile;
plot(rand(3))

ax2 = nexttile;
plot(rand(3))
yticks(ax2,0:.2:1)

y 軸の目盛りの削除

目盛り値を空の配列として指定することで、y 軸に沿った目盛りを削除します。

x = linspace(0,10);
y = sin(x);
plot(x,y)
yticks([])

入力引数

ticks — 目盛り値

増加する値からなるベクトル

目盛り値。増加する値からなるベクトルとして指定します。y 軸に沿って目盛りを表示しない場合は、空のベクトル [] を指定します。

目盛り値は、数値、カテゴリカル値、datetime 値または duration 値として指定できます。ただし、指定する値のタイプは、y 軸に沿った値のタイプと一致していなければなりません。

例: yticks([pi 2*pi 3*pi 4*pi])

例: yticks(0:10:100)

例: yticks([])

メモ

目盛りラベルを指定するには、関数 yticklabels を使用します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

ax — ターゲット座標軸

Axes オブジェクト | Axes オブジェクトの配列

ターゲット座標軸。Axes オブジェクトまたは Axes オブジェクトとの配列して指定します。

この引数を指定しない場合、yticks は現在の座標軸を変更します。

出力引数

yt — 現在の目盛り値

ベクトル

現在の目盛り値。ベクトルとして返されます。

m — 現在のモード

'auto' | 'manual'

現在のモード。次のいずれかの値が返されます。

• 'auto' — y 軸の目盛り値が自動的に決定されます。

• 'manual' — 手動で指定された y 軸の目盛り値を使用します。

詳細

目盛り値

目盛り値は、y 軸に沿って目盛りが表示される位置です。目盛りラベルは、各目盛りの横に表示されるラベルです。目盛り値を設定するには関数 yticks を使用します。対応する目盛りラベルを設定するには関数 yticklabels を使用します。

アルゴリズム

関数 yticks は、y 軸の目盛り値に関連するいくつかの座標軸プロパティを設定およびクエリします。

• YTick — y 軸の目盛り値を保存するプロパティ。

• YTickMode — y 軸の目盛り値モードを保存するプロパティ。y 軸の目盛り値を設定すると、このプロパティは 'manual' に変更されます。

バージョン履歴

R2016b で導入

参考

関数

• xticks | zticks | ytickformat | yticklabels | ytickangle | ylim

プロパティ

• Axes のプロパティ

トピック

• 軸の目盛り値とラベルの指定