zticklabels

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

構文

zticklabels(labels)

zl = zticklabels

zticklabels('auto')

zticklabels('manual')

m = zticklabels('mode')

___ = zticklabels(ax,___)

説明

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

zl = zticklabels は、現在の座標軸の z 軸の目盛りラベルを返します。

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

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

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

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

例

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

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

[x,y,z] = peaks;
surf(x,y,z)
zticks([-8 0 8])
zticklabels({'z = -8','z = 0','z = 8'})

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

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

tiledlayout(2,1)
ax1 = nexttile;
stem3(ax1,4*rand(5))
zticks(ax1,[0 2 4])
zticklabels(ax1,{'z = 0','z = 2','z = 4'})

ax2 = nexttile;
stem3(ax2,4*rand(5))

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

表面プロットを作成し、z 軸の目盛りの値とラベルを指定します。その後、値とラベルを既定値に戻します。

[x,y,z] = peaks;
mesh(x,y,z)
zticks([-8 0 8])
zticklabels({'z = -8','z = 0','z = 8'})

zticks('auto')
zticklabels('auto')

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

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

[x,y,z] = peaks;
surf(x,y,z)
zticklabels({})

入力引数

labels — 目盛りラベル

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

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

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

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

例: zticklabels({})

メモ

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

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

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

ax — ターゲット座標軸

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

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

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

出力引数

zl — 現在の目盛りラベル

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

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

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

'auto' | 'manual'

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

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

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

詳細

目盛りラベル

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

アルゴリズム

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

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

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

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

バージョン履歴

R2016b で導入

参考

関数

• ztickformat | zticks | zlim | zsecondarylabel | ztickangle

プロパティ

• Axes のプロパティ