xticklabels

x 軸の目盛りラベルの設定またはクエリ

構文

xticklabels(labels)

xl = xticklabels

xticklabels('auto')

xticklabels('manual')

m = xticklabels('mode')

___ = xticklabels(ax,___)

説明

xticklabels(labels) は、現在の座標軸の x 軸の目盛りラベルを設定します。labels は string 配列または文字ベクトルの cell 配列として指定します。たとえば、{'January','February','March'} とします。ラベルを指定すると、x 軸の目盛り値と目盛りラベルは、それ以降、座標軸への変更に基づいて自動的に更新されなくなります。

xl = xticklabels は、現在の座標軸の x 軸の目盛りラベルを返します。

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

xticklabels('manual') は、x 軸の目盛りラベルを現在の値に固定する手動モードに設定します。

m = xticklabels('mode') は、x 軸の目盛りラベル モードの現在の値を 'auto' または 'manual' のいずれかで返します。目盛りラベルを指定したり、モードを手動に設定したりしない限り、自動モードが既定で使用されます。

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

例

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

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

x = linspace(0,10);
y = x.^2;
plot(x,y)
xticks([0 5 10])
xticklabels({'x = 0','x = 5','x = 10'})

x 軸の目盛りラベルを Pi で表示

ライン プロットを作成します。x 軸の範囲を指定し、x 軸に沿って $$\pi$$ ずつインクリメントする目盛りを表示します。

x = linspace(0,6*pi);
y = sin(x);
plot(x,y)
xlim([0 6*pi])
xticks(0:pi:6*pi)

MATLAB® は、目盛りに数値のラベルを付けます。各ラベルのテキストを指定して、$$\pi$$ 記号が表示されるようにラベルを変更します。

xticklabels({'0','\pi','2\pi','3\pi','4\pi','5\pi','6\pi'})

特定の座標軸の x 軸の目盛りラベルを指定

R2019b 以降、関数 tiledlayout および nexttile を使用して、プロットをタイル表示できます。関数 tiledlayout を呼び出して、2 行 1 列のタイル表示チャート レイアウトを作成します。関数 nexttile を呼び出して、axes オブジェクト ax1 および ax2 を作成します。ランダム データの 2 つのプロットを作成します。ax2 を最初の入力引数として指定することで、2 番目のプロットにおける x 軸の目盛りの値とラベルを設定します。

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

ax2 = nexttile;
plot(ax2,rand(3))
xticks(ax2,[1 2 3])
xticklabels(ax2,{'one','two','three'})

x 軸の目盛りラベルを既定のラベルに戻す

ステム グラフを作成して、x 軸の目盛りの値と対応するラベルを指定します。その後、x 軸の目盛りの値とラベルを既定値に設定し直します。

stem(1:10)
xticks([1 4 6 10])
xticklabels({'A','B','C','D'})

xticks('auto')
xticklabels('auto')

x 軸の目盛りラベルの削除

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

plot(rand(5))
xticklabels({})

入力引数

labels — 目盛りラベル

文字ベクトルの cell 配列 | string 配列 | categorical 配列

目盛りラベル。文字ベクトルの cell 配列、string 配列または categorical 配列として指定します。目盛りラベルを表示しない場合は、空の cell 配列 {} を指定します。目盛りラベルでは TeX マークアップおよび LaTeX マークアップがサポートされます。詳細については、Axes オブジェクトの TickLabelInterpreter プロパティを参照してください。

例: xticklabels({'0','\pi','2\pi'})

例: xticklabels({'January','February','March'})

例: xticklabels({})

メモ

• 目盛り値を指定するには、関数 xticks を使用します。

• 指定したラベルの個数が目盛り値の個数より少ない場合、MATLAB^® はラベルに空の文字ベクトルを続けて、残りの目盛りに使用します。

• 目盛りラベルを categorical 配列として指定した場合、MATLAB はカテゴリではなく、配列内の値を使用します。

ax — ターゲット座標軸

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

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

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

出力引数

xl — 現在の目盛りラベル

文字ベクトルの cell 配列 | 文字配列

現在の目盛りラベル。文字ベクトルの cell 配列または文字配列として返されます。

m — 現在の目盛りラベル モード

'auto' | 'manual'

現在の目盛りラベル モード。次のいずれかの値が返されます。

• 'auto' — x 軸の目盛りラベルが自動的に決定されます。

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

詳細

目盛りラベル

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

アルゴリズム

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

• XTickLabel — x 軸の目盛りラベルのテキストを保存するプロパティ。

• XTickLabelMode — x 軸の目盛りラベル モードを保存するプロパティ。xticklabels を使用して x 軸の目盛りラベルを設定すると、このプロパティは 'manual' に変更されます。

• XTickMode — x 軸の目盛り値モードを保存するプロパティ。xticklabels を使用して x 軸の目盛りラベルを設定すると、このプロパティは 'manual' に変更されます。

バージョン履歴

R2016b で導入

参考

関数

• xtickformat | xticks | xlim | xsecondarylabel | xtickangle

プロパティ

• Axes のプロパティ

トピック

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