Main Content

rticklabels

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

説明

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

rl = rticklabels は、現在の座標軸の r 軸の目盛りラベルを返します。

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

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

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

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

すべて折りたたむ

極座標プロットを作成します。r 軸に沿って、0.1、0.3 および 0.5 の値で目盛りとグリッド ラインを表示します。次に、各目盛りのラベルを指定します。

theta = linspace(0,2*pi);
rho = theta/10;
polarplot(theta,rho)
rticks([0.1 0.25 0.5])
rticklabels({'r = .1','r = .3','r = .5'})

Figure contains an axes object. The axes object contains an object of type line.

極座標プロットを作成し、polar axes オブジェクトを変数 pax に割り当てます。rticksrticklabels がここで作成した極座標軸に確実に影響を与えるようにするには、これらの関数の最初の入力引数として pax を渡します。

theta = 0:0.01:2*pi;
rho = 50*sin(2*theta);
polarplot(theta,rho)
pax = gca;

rticks(pax,[10 25 50])
rticklabels(pax,{'r = 10','r = 25','r = 50'})

Figure contains an axes object. The axes object contains an object of type line.

極座標プロットを作成し、r 軸の目盛り値と対応するラベルを指定します。次に、r 軸の目盛り値とラベルを既定値に戻します。

theta = linspace(0,2*pi);
rho = theta/10;
polarplot(theta,rho)
rticks([0.1 0.25 0.5])
rticklabels({'r = .1','r = .3','r = .5'})

Figure contains an axes object. The axes object contains an object of type line.

rticks('auto')
rticklabels('auto')

Figure contains an axes object. The axes object contains an object of type line.

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

theta = 0:0.01:2*pi;
rho = 50*sin(2*theta);
polarplot(theta,rho)
rticklabels({})

Figure contains an axes object. The axes object contains an object of type line.

入力引数

すべて折りたたむ

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

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

例: rticklabels({'January','Febrary','March'})

例: rticklabels({})

メモ

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

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

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

極座標軸、または極座標軸の配列。この引数を指定しない場合、rticklabels は (現在の座標軸が polar axes オブジェクトであるという条件下で) 現在の座標軸を変更します。

出力引数

すべて折りたたむ

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

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

  • 'auto' — 座標軸が r 軸の目盛りラベルを自動的に決定します。

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

詳細

すべて折りたたむ

目盛りラベル

目盛りラベルは、各目盛りの横に表示されるラベルです。目盛り値は、r 軸上の目盛りが表示される位置です。目盛り値を設定するには関数 rticks を使用します。対応する目盛りラベルを設定するには関数 rticklabels を使用します。

アルゴリズム

関数 rticklabels は、r 軸の目盛りラベルに関連する複数の極座標軸プロパティを設定およびクエリします。

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

  • RTickLabelModer 軸の目盛りラベル モードを保存するプロパティ。rticklabels を使用して r 軸の目盛りラベルを設定すると、このプロパティは 'manual' に変わります。

  • RTickModer 軸の目盛り値モードを保存するプロパティ。rticklabels を使用して r 軸の目盛りラベルを設定すると、このプロパティは 'manual' に変わります。

バージョン履歴

R2016b で導入