15.2.1.1 軸の設定
axis 関数を使用すると、既存のプロットの軸の制限や、アスペクト比や目盛りの外観など、さまざまな軸プロパティを変更できます。デフォルトでは、 などの高レベル プロット関数は 軸プロパティをリセットします。 、などをplot呼び出すことによるプロパティのカスタマイズは、プロットが完了した後、またはhold 関数を呼び出した後に行う必要があります。 axisxlim
: axis ()
: axis ([x_lo x_hi])
: axis ([x_lo x_hi y_lo y_hi])
: axis ([x_lo x_hi y_lo y_hi z_lo z_hi])
: axis (option)
: axis (option1, option2, …)
: axis (hax, …)
: limits = axis ()
軸の制限と外観を設定します。
引数limits は、2、4、6、または 8 要素のベクトルである必要があります。最初と 2 番目の要素は、x 軸の下限と上限を指定します。3 番目と 4 番目は y 軸の制限を指定し、5 番目と 6 番目は z 軸の制限を指定し、7 番目と 8 番目は色軸の制限を指定します。特別な値-Infと は、 Inf軸のデータに基づいて制限を自動的に計算する必要があることを示すために使用できます。
引数を指定しないと、axis自動スケーリングがオンになります。
出力引数が 1 つある場合、limits = axis現在の軸の制限を返します。
制限を指定するベクトル引数はオプションであり、追加の文字列引数を使用してさまざまな軸プロパティを指定できます。
次のオプションは軸のアスペクト比を制御します。
"equal"
x 軸の単位距離を y 軸 (および z 軸) の単位距離と等しくなるように強制します。
"square"
正方形軸のアスペクト比を強制します。
"vis3d"
伸縮せずに回転するには、アスペクト比モード ( "DataAspectRatio"、 "PlotBoxAspectRatio") を に設定します"manual"。
"normal"
"fill"
自動的に計算されたデフォルトのアスペクト比を復元します。
次のオプションは、軸の制限の解釈方法を制御します。
"auto"
"auto[xyz]"
"auto [xyz]"
すべての軸、または指定された軸のみのデータの周りに、自動計算された適切な制限を設定します。
"manual"
現在の軸の制限を修正します。
"tickaligned"
軸を最も近い目盛りの限界に固定します。
"tight"
軸をデータの限界に固定します。
"padded"
軸をデータの限界値にデータ範囲の約 7% のマージンを加えた値に固定します。
"image"
"tight"および と同等です"equal"。
次のオプションは目盛りの外観に影響します。
"tic"
"tic[xyz]"
"tic [xyz]"
すべての軸の目盛りをオンにするか、指定した軸の目盛りをオンにして残りの軸の目盛りをオフにします。
"label"
"label[xyz]"
"label [xyz]"
すべての軸の目盛りラベルをオンにするか、指定した軸の目盛りラベルをオンにして残りの軸の目盛りラベルをオフにします。
"nolabel"
すべての軸の目盛りラベルをオフにします。
注: 軸に目盛りがない場合、ラベルは存在しません。
次のオプションは、軸上の値の増加方向に影響します。
"xy"
デフォルトの Y 軸。値が大きいほど上部に近くなります。
"ij"
Y 軸を逆にすると、値が小さいほど上部に近くなります。
次のオプションは軸の表示に影響します。
"on"
軸を見えるようにします。
"off"
軸を隠します。
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
例1: X/Y制限を設定し、正方形のアスペクト比を強制する
軸（[1, 2, 3, 4]、「正方形」）;
例 2: すべての軸で目盛りを有効にし、y 軸でのみ目盛りラベルを有効にする
軸 ("tic", "labely");
参照: xlim、ylim、zlim、caxis、daspect、pbaspect、box、grid。
同様に、カラーマップの軸の制限は caxis 関数を使用して変更できます。
: caxis ([cmin cmax])
: caxis ("auto")
: caxis ("manual")
: caxis (hax, …)
: limits = caxis ()
プロットの色軸の制限を照会または設定します。
limits 引数は、カラーマップ内の最初の値と最後の値に割り当てる下限と上限を指定する 2 要素のベクトルである必要があります。この範囲外のデータ値は、カラーマップの最初と最後のエントリにクランプされます。
オプションが指定されている場合は"auto"、自動カラーマップ制限が適用されます。自動アルゴリズムは、cmin を最小データ値に設定し、cmax を最大データ値に設定します。"manual"が指定されている場合は、"climmode"プロパティが に設定され"manual"、プロパティ内の数値"clim"が制限に使用されます。
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
引数なしで呼び出されると、現在の色軸の制限が返されます。
プログラミング ノート: カラー軸は、プロパティにインデックス データがあり、プロパティが に設定されている 場合に限り、イメージ、パッチ、およびサーフェス グラフィックス オブジェクトの表示に影響します。トゥルー カラー、または のグラフィック オブジェクトは影響を受けません。 "cdata""cdatamapping""scaled"cdata"direct" cdatamapping
参照: colormap、axis。
xlim、、ylimおよび関数zlimは、個々の軸の制限を取得または設定するために使用できます。各関数の形式は同じです。
: xlimits = xlim ()
: xmode = xlim ("mode")
: xmethod = xlim ("method")
: xlim ([x_lo x_hi])
: xlim ("mode")
: xlim ("method")
: xlim (hax, …)
現在のプロットの x 軸の制限を照会または設定します。
引数なしで呼び出されると、xlim現在のプロットの x 軸の範囲が返されます。
入力クエリ では、 または のいずれかで"mode"ある現在の x 制限計算モードを返します。 "auto""manual"
入力クエリ では"method"、現在の x 制限計算方法 ( "tickaligned"、"tight"、 のいずれか) を返します"padded"。
2 要素のベクトル [ x_lo x_hi ] が渡された場合、x 軸の制限はこれらの値に設定され、モードは に設定されます"manual"。特別な値 -Inf と Inf を使用すると、軸の下限または軸の上限のいずれかが自動的に計算されることを示すことができます。
電流制限の計算は次"mode"のいずれかになります。
"auto"（デフォルト）
プロット データと現在指定されている制限計算方法に基づいて、制限を自動的に計算します。
"manual"
軸の制限を現在の値に固定します。
電流制限の計算方法は、次のいずれかです。
"tickaligned"（デフォルト）
すべてのデータを包含し、最も近い目盛りまで外側に拡張する制限を計算します。
"tight"
データ範囲に正確に適合する制限を計算します。
"padded"
データ範囲の約 7% のデータの周囲に余裕を残す制限を計算します。
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
プログラミング ノート: この関数は、軸オブジェクトの、、およびプロパティを変更することによって動作します。これらのプロパティは、 / を使用して直接検査 および変更xlimでき ます。 "xlim""xlimmode""xlimitmethod"getset
参照: ylim、zlim、axis、set、get、gca。
: ylimits = ylim ()
: ymode = ylim ("mode")
: ymethod = ylim ("method")
: ylim ([y_lo y_hi])
: ylim ("mode")
: ylim ("method")
: ylim (hax, …)
現在のプロットの Y 軸の制限を照会または設定します。
引数なしで呼び出されると、ylim現在のプロットの y 軸の範囲が返されます。
入力クエリ では、 または のいずれかで"mode"ある現在の y 制限計算モードを返します。 "auto""manual"
入力クエリ では"method"、現在の y 制限計算方法 ( "tickaligned"、"tight"、 のいずれか) を返します"padded"。
2 要素のベクトル [ y_lo y_hi ] が渡された場合、y 軸の制限はこれらの値に設定され、モードは に設定されます"manual"。特別な値 -Inf と Inf を使用すると、軸の下限または軸の上限のいずれかが自動的に計算されることを示すことができます。
電流制限の計算は次"mode"のいずれかになります。
"auto"（デフォルト）
プロット データと現在指定されている制限計算方法に基づいて、制限を自動的に計算します。
"manual"
軸の制限を現在の値に固定します。
電流制限の計算方法は、次のいずれかです。
"tickaligned"（デフォルト）
すべてのデータを包含し、最も近い目盛りまで外側に拡張する制限を計算します。
"tight"
データ範囲に正確に適合する制限を計算します。
"padded"
データ範囲の約 7% のデータの周囲に余裕を残す制限を計算します。
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
プログラミング ノート: この関数は、軸オブジェクトの、、およびプロパティを変更することによって動作します。これらのプロパティは、 / を使用して直接検査 および変更ylimでき ます。 "ylim""ylimmode""ylimitmethod"getset
参照: xlim、zlim、axis、set、get、gca。
: zlimits = zlim ()
: zmode = zlim ("mode")
: zmethod = zlim ("method")
: zlim ([z_lo z_hi])
: zlim ("mode")
: zlim ("method")
: zlim (hax, …)
現在のプロットの Z 軸の制限を照会または設定します。
引数なしで呼び出されると、zlim現在のプロットの Z 軸の制限が返されます。
入力クエリ では、 または のいずれかで"mode"ある現在の Z 制限計算モードを返します。 "auto""manual"
入力クエリ では"method"、現在の Z 制限計算方法 ( "tickaligned"、"tight"、 のいずれか) を返します"padded"。
2 要素ベクトル [ z_lo z_hi ] が渡された場合、z 軸の制限はこれらの値に設定され、モードは に設定されます"manual"。特別な値 -Inf と Inf を使用すると、軸の下限または軸の上限のいずれかが自動的に計算されることを示すことができます。
電流制限の計算は次"mode"のいずれかになります。
"auto"（デフォルト）
プロット データと現在指定されている制限計算方法に基づいて、制限を自動的に計算します。
"manual"
軸の制限を現在の値に固定します。
電流制限の計算方法は、次のいずれかです。
"tickaligned"（デフォルト）
すべてのデータを包含し、最も近い目盛りまで外側に拡張する制限を計算します。
"tight"
データ範囲に正確に適合する制限を計算します。
"padded"
データ範囲の約 7% のデータの周囲に余裕を残す制限を計算します。
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
プログラミング ノート: この関数は、軸オブジェクトの、、およびプロパティを変更することによって動作します。これらのプロパティは、 / を使用して直接検査 および変更zlimでき ます。 "zlim""zlimmode""zlimitmethod"getset
参照: xlim、ylim、axis、set、get、gca。
xticks、、、、および 関数は、それぞれの軸の目盛りの位置とモードを取得または設定するために使用できます。 関数の形式はそれぞれ同じですが、モード オプションは現在、、および では使用できませ んyticks。zticksrticksthetaticksrticksthetaticks
: tickval = xticks
: mode = xticks ("mode")
: xticks (tickval)
: xticks ("auto")
: xticks ("manual")
: … = xticks (hax, …)
現在の軸の x 軸の目盛り値を照会または設定します。
引数なしで呼び出されると、"xtick"axes プロパティで指定された現在の目盛りの位置を返します。これらの位置は、目盛り値のベクトルを指定して呼び出すことで変更できますxticks。注: 昇順である必要はありません。
引数 で呼び出されると"mode"、xticks軸プロパティ の現在の値を返します"xtickmode"。このプロパティは、 （アルゴリズムが目盛りの位置を決定する）または（軸のサイズ変更や回転に関係なく目盛りの値が固定されたままになる）xticksのいずれかで を呼び出すことによって変更できます。注: xtick 値を指定すると、プロパティもに設定されます。 "auto""manual""xtickmode""manual"
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
xticksプロパティ値を設定するために 呼び出すときに戻り値を要求すると、エラーが発生します。
参照: xticklabels、yticks、zticks、rticks、thetaticks、get、set。
: tickval = yticks
: mode = yticks ("mode")
: yticks (tickval)
: yticks ("auto")
: yticks ("manual")
: … = yticks (hax, …)
現在の軸の y 軸の目盛り値を照会または設定します。
引数なしで呼び出されると、"ytick"axes プロパティで指定された現在の目盛りの位置を返します。これらの位置は、目盛り値のベクトルを指定して呼び出すことで変更できますyticks。注: 昇順である必要はありません。
引数 で呼び出されると"mode"、yticks軸プロパティ の現在の値を返します"ytickmode"。このプロパティは、 （アルゴリズムが目盛りの位置を決定する）または（軸のサイズ変更や回転に関係なく目盛りの値が固定されたままになる）yticksのいずれかで を呼び出すことによって変更できます。注: ytick 値を指定すると、プロパティもに設定されます。 "auto""manual""ytickmode""manual"
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
yticksプロパティ値を設定するために 呼び出すときに戻り値を要求すると、エラーが発生します。
参照: yticklabels、xticks、zticks、rticks、thetaticks、get、set。
: tickval = zticks
: mode = zticks ("mode")
: zticks (tickval)
: zticks ("auto")
: zticks ("manual")
: … = zticks (hax, …)
現在の軸の Z 軸の目盛り値を照会または設定します。
引数なしで呼び出されると、"ztick"axes プロパティで指定された現在の目盛りの位置を返します。これらの位置は、目盛り値のベクトルを指定して呼び出すことで変更できますzticks。注: 昇順である必要はありません。
引数 で呼び出されると"mode"、zticks軸プロパティ の現在の値を返します"ztickmode"。このプロパティは、 （アルゴリズムが目盛りの位置を決定する）または（軸のサイズ変更や回転に関係なく目盛りの値が固定されたままになる）zticksのいずれかで を呼び出すことによって変更できます。注: ztick 値を指定すると、プロパティも に設定されます。 "auto""manual""ztickmode""manual"
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
zticksプロパティ値を設定するために 呼び出すときに戻り値を要求すると、エラーが発生します。
参照: zticklabels、xticks、yticks、rticks、thetaticks、get、set。
: tickval = rticks
: rticks (tickval)
: … = rticks (hax, …)
現在の軸の r 軸の目盛り値を照会または設定します。
引数なしで呼び出されると、axes プロパティで指定された現在の目盛りの位置を返します"rtick"。これらの位置は、目盛り値のベクトルを指定して呼び出すことで変更できますrticks。注: 昇順である必要はありません。
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
rticksプロパティ値を設定するために 呼び出すときに戻り値を要求すると、エラーが発生します。
注意: Octave は現在 polaraxes オブジェクトを実装していません。したがって、 x、y、z軸 の同等の関数で実行できるようなプロパティ "mode"の クエリや設定を行うことはできません。"rtick"
参照: thetaticks、xticks、yticks、zticks、polar、get、set。
:tickval = タティックス
:タティックス (tickval)
:… = タティックス (hax, …)
現在の軸のシータ軸の目盛り値を照会または設定します。
引数なしで呼び出されると、axes プロパティで指定された現在の目盛りの位置を返します"ttick"。これらの位置は、目盛り値のベクトルを指定して呼び出すことで変更できますthetaticks。注: 昇順である必要はありません。
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
thetaticksプロパティ値を設定するために 呼び出すときに戻り値を要求すると、エラーが発生します。
注意: Octave は現在 polaraxes オブジェクトを実装していません。したがって、 x、y、z軸 の同等の関数で実行できるようなプロパティ"mode"の クエリや設定を行うことはできません。"thetatick"
参照: rticks、xticks、yticks、zticks、polar、get、set。
xticklabels、、yticklabelsおよび関数は、各目盛り位置に割り当てられたラベルzticklabelsと、それぞれの軸のラベル付けモードを取得または設定するために使用できます。各関数の形式は同じです。
: labels = xticklabels
: mode = xticklabels ("mode")
: xticklabels (tickval)
: xticklabels ("auto")
: xticklabels ("manual")
: … = xticklabels (hax, …)
現在の軸の x 軸の目盛りラベルを照会または設定します。
引数なしで呼び出されると、"xticklabel"axes プロパティで指定された現在の目盛りラベルの文字列のセル配列を返します。これらのラベルは、文字列のセル配列で呼び出すことによって変更できますxticklabels。注: 数値のベクトルは文字列のセル配列にマップされます。現在の目盛りの数よりも少ないラベルが指定されている場合は、空のラベルが配列に追加されます。
引数 で呼び出されると"mode"、xticklabels軸プロパティ の現在の値を返します。このプロパティは 、 （アルゴリズムが目盛りラベルを決定する）または（目盛りラベルは固定されたまま）のいずれかで"xticklabelmode"を呼び出すことによって変更できます。注: xticklabel 値を指定すると、 およびプロパティも に 設定されます。 xticklabels"auto""manual""xticklabelmode""xticks""manual"
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
xticklabelsプロパティ値を設定するために 呼び出すときに戻り値を要求すると、エラーが発生します。
参照: xticks、yticklabels、zticklabels、get、set。
: labels = yticklabels
: mode = yticklabels ("mode")
: yticklabels (tickval)
: yticklabels ("auto")
: yticklabels ("manual")
: … = yticklabels (hax, …)
現在の軸の x 軸の目盛りラベルを照会または設定します。
引数なしで呼び出されると、"yticklabel"axes プロパティで指定された現在の目盛りラベルの文字列のセル配列を返します。これらのラベルは、文字列のセル配列で呼び出すことによって変更できますyticklabels。注: 数値のベクトルは文字列のセル配列にマップされます。現在の目盛りの数よりも少ないラベルが指定されている場合は、空のラベルが配列に追加されます。
引数 で呼び出されると"mode"、yticklabels軸プロパティ の現在の値を返します。このプロパティは 、 （アルゴリズムが目盛りラベルを決定する）または（目盛りラベルは固定されたまま）のいずれかで"yticklabelmode"を呼び出すことによって変更できます。注: yticklabel 値を指定すると、 およびプロパティも に 設定されます。 yticklabels"auto""manual""yticklabelmode""yticks""manual"
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
xticklabelsプロパティ値を設定するために 呼び出すときに戻り値を要求すると、エラーが発生します。
参照: yticks、xticklabels、zticklabels、get、set。
: labels = zticklabels
: mode = zticklabels ("mode")
: zticklabels (tickval)
: zticklabels ("auto")
: zticklabels ("manual")
: … = zticklabels (hax, …)
現在の軸の x 軸の目盛りラベルを照会または設定します。
引数なしで呼び出されると、"zticklabel"axes プロパティで指定された現在の目盛りラベルの文字列のセル配列を返します。これらのラベルは、文字列のセル配列で呼び出すことによって変更できますzticklabels。注: 数値のベクトルは文字列のセル配列にマップされます。現在の目盛りの数よりも少ないラベルが指定されている場合は、空のラベルが配列に追加されます。
引数 で呼び出されると"mode"、zticklabels軸プロパティ の現在の値を返します。このプロパティは 、 （アルゴリズムが目盛りラベルを決定する）または（目盛りラベルは固定されたまま）のいずれかで"zticklabelmode"を呼び出すことによって変更できます。注: zticklabel 値を指定すると、 およびプロパティも に 設定されます。 zticklabels"auto""manual""zticklabelmode""zticks""manual"
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
xticklabelsプロパティ値を設定するために 呼び出すときに戻り値を要求すると、エラーが発生します。
参照: zticks、xticklabels、zticklabels、get、set。
xtickangle、、ytickangleおよび関数ztickangleは、それぞれの軸のラベルの回転角度を取得または設定するために使用できます。各関数の形式は同じです。
: angle = xtickangle ()
: angle = xtickangle (hax)
: xtickangle (angle)
: xtickangle (hax, angle)
現在の軸の x 軸上の目盛りラベルの回転角度を照会または設定します。
引数なしで呼び出された場合は、 axes プロパティで指定された目盛りラベルの回転角度を度単位で返します"XTickLabelRotation"。数値スカラーangleで呼び出された場合は、目盛りラベルを反時計回りにangle度回転します。
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
プログラミングノート:
この"XTickLabelRotation"プロパティは現在 Octave では実装されていません。プロパティを設定および照会することはできますが、プロットには影響しません。
指定された回転を設定しながら戻り値を要求すると、エラーが発生します。
参照: ytickangle、ztickangle、get、set。
: angle = ytickangle ()
: angle = ytickangle (hax)
: ytickangle (angle)
: ytickangle (hax, angle)
現在の軸の Y 軸上の目盛りラベルの回転角度を照会または設定します。
引数なしで呼び出された場合は、 axes プロパティで指定された目盛りラベルの回転角度を度単位で返します"YTickLabelRotation"。数値スカラーangleで呼び出された場合は、目盛りラベルを反時計回りにangle度回転します。
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
プログラミングノート:
この"YTickLabelRotation"プロパティは現在 Octave では実装されていません。プロパティを設定および照会することはできますが、プロットには影響しません。
指定された回転を設定しながら戻り値を要求すると、エラーが発生します。
参照: xtickangle、ztickangle、get、set。
: angle = ztickangle ()
: angle = ztickangle (hax)
: ztickangle (angle)
: ztickangle (hax, angle)
現在の軸の Z 軸上の目盛りラベルの回転角度を照会または設定します。
引数なしで呼び出された場合は、 axes プロパティで指定された目盛りラベルの回転角度を度単位で返します"ZTickLabelRotation"。数値スカラーangleで呼び出された場合は、目盛りラベルを反時計回りにangle度回転します。
最初の引数hax が軸ハンドルである場合、 によって返される現在の軸ではなく、この軸に対して操作を行いますgca。
プログラミングノート:
この"ZTickLabelRotation"プロパティは現在 Octave では実装されていません。プロパティを設定および照会することはできますが、プロットには影響しません。
指定された回転を設定しながら戻り値を要求すると、エラーが発生します。
参照: xtickangle、ytickangle、get、set。