MATLAB Function Reference

Axes プロパティ

つぎの2つの方法を使って、グラフィックオブジェクトのプロパティを設定したり、引用したりできます。

• Property Editor は、会話型のツールで、オブジェクトのプロパティ値を設定したり、変更したりできます。
• コマンドsetとget は、プロパティの値を設定したり、引用したりします。

プロパティのデフォルト値を変更するには、 デフォルトプロパティ値の設定を参照してください。

Axes プロパティの記述

この節は、プロパティ名とそこで設定できる値のタイプをリストしています。中括弧{}はデフォルト値です。

Alpha 軸の範囲。MATLABが、フィギュアのalphamapにサーフェス、パッチ、イメージオブジェクトのAlphaData値をどのようにマップするかを決定する2要素ベクトルです。aminは、alphamapの中の最初のalpha値にマップするデータ値 で、amaxは、最後のalpha値です。これらの間の値は、最初と最後のalphamap値を線形に補間し、この範囲外のものは、最も近い値に設定します。

ALimModeがauto(デフォルト)の場合、MATLABは、グラフィックオブジェクトのAlphaDataの中で、最小値をamin に、最大値をamaxに設定します。これは、AlphaDataの最小のデータ値をalphamapの最初の要素に、最大値を最後の要素にマッピングします。この間のデータ値は、線形にマッピングされます。

軸が複数のグラフィックオブジェクトを含んでいると、MATLABは、ALimをすべてのオブジェクトのAlphaData (または、パッチオブジェクトに対して、FaceVertexAlphaData )の範囲をカバーするようにします。

Alpha 軸の範囲の設定モード。auto モードの中で、MATLAB は、ALimプロパティを軸の中に表示されるグラフィックオブジェクトの範囲AlphaDataをカバーするように設定します。ALimModeがマニュアルの場合、子の軸の範囲AlphaDataが変更されるとき、MATLABは、ALim の値を変更しません。ALimプロパティの設定は、ALimModeをマニュアルに設定します。

ウィンドウ内の背景のライティング。周囲光は、Axes内のすべてのオブジェクト上を、無指向性で、一様に照らすものです｡ しかし、Axes内のLightオブジェクトが可視状態でなければ、AmbientLightColorを使いません｡また、Axes内に複数のLightオブジェクトが存在すると、AmbientLightColorは、他の光源にも加えられます。

このプロパティは、引用したり、または、変更したとき、ワーニングメッセージを作成します。DataAspectRatio[Mode] や PlotBoxAspectRatio[Mode]プロパティを使ってください。

Axesボックスモード。このプロパティは、2次元表示でのボックスや3次元表示の箱を使って、Axesの範囲を囲むかどうかを設定するものです｡デフォルトは、ボックス表示しません。

コールバックルーチンの割込み。BusyActionプロパティを使って、実行中のコールバックルーチンに割込みを行うイベントの取り扱い方法を制御することができます。実行中のコールバックルーチンがあれば、続いて呼び込まれるコールバックルーチンは、常にそれを中断しようとします。実行中のオブジェクトのコールバックのInterruptibleプロパティがon(デフォルト)に設定されていれば、イベントキューが処理されるつぎの点で割込みが起こります。Interruptibleプロパティがoffの場合、(実行中のコールバックをもつオブジェクトの)BusyActionプロパティは、MATLABがイベントを処理する方法を指定します。つぎのような選択があります。

• cancel - 2番目のコールバックルーチンを実行するイベントを廃棄します。
• queue - 現在のコールバックが終了するまで、2番目のコールバックルーチンを実行しようとするイベントを待機させます。

マウスボタンを押したときのコールバックルーチン。ポインタがAxesの中に存在するときにマウスボタンを押すと、必ず実行されるコールバックルーチン。しかし、Axes内に表示されたそれ以外のグラフィックスオブジェクト上では、実行しません｡ 3次元表示の場合､アクティブな範囲は､ Axesで囲まれる直方体で定義されます。

このルーチンは、正しいMATLAB表現やM-ファイル名を使った文字列で定義できます｡ 式は、ワークスペース内で実行します。

カメラの位置。 このプロパティは、Axesを見るカメラの位置を定義します｡Axesの座標の中で点を設定してください。

CameraViewAngleを固定すると､ CameraPositionを変更することによりスクリーンの拡大・縮小が可能で、ウィンドウ上で拡大するためCameraTargetに近付づけたり、縮小するためにCameraTargetから遠ざけたりします。CameraPositionを変更すると､ Projectionがperspectiveならば、遠近量も変化します｡ また、CameraViewAngleを変更することにより、拡大・縮小できますが、ウィンドウ上で遠近の度合いを変更することはできません。

CameraPositionの自動、または、マニュアル設定。autoに設定すると、MATLABは、 viewによって設定される仰角と方位角に沿って、CameraTarget からの固定された距離にカメラを設定するCameraPositionを自動的に計算します｡ CameraPositionに対して値を設定すると、このプロパティはmanualに設定されます｡

カメラターゲットにする点。このプロパティは、カメラが指し示すAxesの中の位置を設定します。CameraTarget とCameraPositionは、カメラが見える方向に沿ったベクトル(view軸)を定義します｡

CameraTargetの自動、または、マニュアル設定。このプロパティをautoに設定すると､ Axesのプロットボックスの中央にCameraTargetを自動的に設定します｡CameraTargetに対して値を設定すると､ このプロパティはmanualに設定されます｡

カメラの回転。 このプロパティは、CameraTargetとCameraPositionプロパティにより定義される視点軸の周りでのカメラの回転を設定します｡ベクトルのx, y, z要素を含む3要素配列として、CameraUpVectorを定義します｡ たとえば、[0 1 0] は、正のy軸を上向きに設定します｡

CameraUpVectorのデフォルト値は､[0 0 1]で、正のz軸を上向きとして定義します。

デフォルト、または、ユーザ指定の上向きベクトル。CameraUpVectorModeをautoに設定すると､ MATLABは、3次元表示に対して[0 0 1](正の z軸が上向き)、2次元表示に対して[0 1 0](正のy軸が上向き)になります。CameraUpVectorに値を設定すると、このプロパティはmanualに変更されます｡

表示フィールド。 このプロパティは、カメラの表示フィールドを設定します｡ この値は、Axesの中に表示されるグラフィックスオブジェクトの見掛けの大きさに影響を与えます｡ しかし、遠近量に影響はありません。角度を大きくすればするほど、表示フィールドは大きくなり、ウィンドウ内に表れるオブジェクトは小さくなります｡

CameraViewAngleの自動設定、または、マニュアル設定。autoモードに設定すると､ MATLABは、全体を捉えるために必要な角度を最小なものにします(180度以下)。

つぎの表は、MATLABの自動的なカメラの挙動をまとめたものです。

CameraViewAngle	Camera Target	Camera Position	挙動
auto	auto	auto	CameraTargetは、プロットボックスを中央に設定します｡CameraViewAngleは、全体図を取り込むように設定されます｡ CameraPositionは、表示軸に沿って設定されます。
auto	auto	manual	CameraTargetは、プロットボックスを中央に設定します｡ CameraViewAngleは、全体図を取り込むように設定されます。
auto	manual	auto	CameraViewAngleは、全体図を取り込むように設定されます｡ CameraPositionは、表示軸に沿って設定されます。
auto	manual	manual	CameraViewAngleは、全体図を取り込むように設定します。
manual	auto	auto	CameraTargetは、プロットボックスを中央に設定します｡ CameraPositionは、表示軸に沿って設定されます｡
manual	auto	manual	CameraTargetは、プロットボックスを中央に設定します。
manual	manual	auto	CameraPositionは、表示軸に沿って設定されます。
manual	manual	manual	カメラプロパティは、すべてユーザ指定です。

Axesの子オブジェクト。Axes内に描かれたすべてのグラフィックスオブジェクト(可視状態、非可視状態に関わらず)のハンドル番号を含むベクトル。Axesの子オブジェクトになるグラフィックスオブジェクトは、images, lights, lines, patches, surfaces, textです。ユーザは、ハンドルの順番を変更でき、表示上のオブジェクトのスタックを変更できます。

x, y, z-軸をラベル付けするために使われるTextオブジェクトは、Axesの子オブジェクトですが、これらのHandleVisibilityプロパティは、callbackと設定されていなければなりません。これは、ルートのShowHiddenHandlesプロパティをonに設定しない限り､ これらのハンドル番号は、AxesのChildrenプロパティの中で表示されないことを意味しています｡

カラー軸の範囲。MATLABがSurface Patch オブジェクトのCData値をFigureのcolormapに写像する方法を設定する2要素ベクトルです。cminは、カラーマップの中の最初のカラーに写像するデータ値です。そして、cmaxは、カラーマップの中の最後のカラーに写像するデータの値です。これらの値の中間のデータ値は、2番目から最後から2番目までのカラーインデックスを線形に変換します。範囲外の値は、カラーマップの最初または最後の色の近いほうに設定されます。

CLimModeがauto(デフォルト)の場合、MATLABは、グラフィックスオブジェクトのCDataの中で､ 最小値データをcminに、最大値データをcmaxに設定します｡ これは、最小データ値のCDataの要素を最初のカラーマップの要素に、最大データ値のCDataの要素を最後のカラーマップの要素に写像します。

Axesが複数のグラフィックスオブジェクトを含んでいると､ MATLABは、すべてのオブジェクトのCDataの範囲をカバーするようにCLim を設定します。

カラー軸範囲の設定モード。CLimModeがauto モードならば、MATLABは、Axesの中に表示されたグラフィックスオブジェクトがすべて入るようにCDataの範囲をCLimプロパティに設定します｡ CLimModeがmanualモードならば、CDataがAxesの子オブジェクトの変更を制限しているときはCLimの値をMATLABは変更しません。CLimプロパティを設定すると、このプロパティは、manualに設定されます。

このプロパティは、Axesに影響を与えません｡

Axesの背景のカラー。このプロパティをnoneに設定すると、Axesは透明度をもち、それを通して、フィギュアカラーが表示されます。ColorSpecは、3要素のRGBベクトルか、またはMATLABで既定された名前の一つを使います｡ デフォルト値はnoneで、matlabrc.m ファイルを使って、Axesのcolorに特定のカラーを設定することができます。

複数のプロットに使われるカラー。関数plotやplot3でプロットする各ラインのカラーを設定するRGBのm行3列の行列です。plotとplot3でラインのカラーを設定しないで複数のラインを表示すると、ColorOrderで設定した順にカラーを割り当てます。スタートアップ時に設定されるカレントのColorOrderを取得するためには、つぎのプロパティ値

get(gca,'ColorOrder')

を取得してください。

オブジェクトの作成中に実行されるコールバックルーチン。このプロパティは、MATLABがAxesオブジェクトを作成するときに実行するコールバックルーチンを定義します｡このプロパティは、Axesに対してデフォルト値として定義しなければなりません。たとえば、つぎのステートメント

set(0,'DefaultAxesCreateFcn','set(gca,''Color'',''b'')')

最も新しくクリックした位置で、Axesデータユニットを表現。2点の座標を含んだ2行3列の行列は、ポインタの位置を定義します｡ これらの2つの点は、スクリーン平面に垂直で、ポインタの位置を通る線上に存在します。3次元 座標は、axesの座標系でAxes直方体の前面と背面を交差する線上にある点です(Axesの x, y, zの範囲で設定されます)。

データユニットの相対的なスケーリング。x, y, z 方向のデータユニットの相対的なスケーリングをコントロールする3要素ベクトルです。たとえば、このプロパティを[1 2 1] に設定することは、x-軸でデータユニットを1、y-軸データユニットを2、z-軸データユニットを1にすることを意味します｡

ユーザ、または、MATLABによるデータのスケーリングの制御。このプロパティは、DataAspectRatioプロパティ値をユーザが設定するのか､ MATLABにより自動的に設定されるのかを制御するものです。DataAspectRatioプロパティに値を設定することは、このプロパティを自動的にmanualにすることになります。DataAspectRatioMode,PlotBoxAspectRatioMode,CameraViewAngleModeがすべてautoならば、DataAspectRatioModeをmanualに変更すると、stretch-to-fill機能を使えなくなります。

Axesを削除するときのコールバックルーチン。 Axesオブジェクトが削除される(たとえば、 deleteまたはcloseコマンドを実行する)とき、実行するコールバックルーチン。MATLABは、オブジェクトのプロパティを壊す前にルーチンを実行します｡ そのため、コールバックルーチンは、これらの値を参照することができます。

レンダリング法。このプロパティは、フィギュアの Rendererプロパティがpaintersのとき、Axes内で表示されるグラフィックスオブジェクトをレンダリングする手法を制御します。

• normal モードは、可視でないsurfaceの消去やオブジェクトの交差を行うために、カレントの表示をベースに後から前にオブジェクトを描きます。
• fast モードは、3次元でのオブジェクトの位置関係を考慮しないで、設定した描画コマンドの順にオブジェクトを描きます｡ 表示の中での位置に従って、オブジェクトのソートを必要としないので、より速いレンダリングが可能になりますが、通常の DrawModeが提供する可視でないオブジェクトの消去やオブジェクトの交差を無視するため、予期しない結果になることがあります。

イタリックフォント、標準フォントの選択。このプロパティは、Axesのテキストに対するキャラクタを選択します｡ normalはイタリックフォントでないものを、italicと oblique はイタリックフォントを設定します｡

フォントファミリ名。フォントファミリ名は､ Axesラベルに対して使われるフォントを設定するものです。適切に印刷したり、表示したりするため､ FontNameは、ユーザのシステムがサポートしているフォントでなければなりません。ユーザが、マニュアルでこれらのフォントをリセット(XLabel, XLabel,Zlabelプロパティで設定するか、またはxlabel,ylabel,zlabel コマンドを使って設定する)しない限り、x-、y-、z-軸のラベルは、新しいフォントで表示されません。目盛りマークは、すぐに変更されます｡

固定幅のフォントの指定

任意の部分で、良く見えるような固定幅のフォントをaxesで使いたい場合、FontName に文字列 FixedWidthを設定してください。

set(axes_handle,'FontName','FixedWidth')

このパラメータ値は、固定幅のフォントの名前をハードコードするために必要な処理をエルミネーションします。これは、ASCIIキャラクタコーディング(日本語)を使用しないシステム上で、適切にテキストを表示できません。固定幅のフォントを使用するために記述されたMATLABアプリケーションは、FontName を FixedWidthに設定し、エンドユーザの環境の中に正しく設定されたルートのFixedWidthFontNameプロパティを使います。

エンドユーザは、ルートのFixedWidthFontName プロパティをstartup.mに設定した適切な値に設定することにより、種々の部分や個人の環境に MATLABアプリケーションを採用できます。

ルートFixedWidthFontName プロパティを設定することは、新しいフォントを使用して表示したものをすぐに更新することになります。

フォントサイズ。FontUnits プロパティで決められる単位で、Axesラベルやタイトルに対して使われるフォントサイズを設定する整数です。デフォルトのポイント数は、12です。これらをマニュアルでリセットしない限り、(XLabel,YLabel,ZLabelプロパティを設定するか、xlabel,ylabel,zlabelコマンドを使って設定する)、x-、y-、z-軸のテキストラベルは、新しいフォントで表示されません。目盛りラベルは、すぐ変更されます。

FontSizeプロパティを解釈するのに使う単位。normalizedを設定すると、MATLABは、FontSizeの値をAxesの高さの割合で表わします｡たとえば、normalizedで0.1に設定されたFontSizeは、Axesの高さの1/10の大きさを高さにするフォントになります。デフォルトの単位(ポイント数)は､ 1/72インチです。

太文字フォントと標準フォントの選択。Axesのテキストのキャラクタのタイプ。x-、y-、z-軸のテキストラベルは、マニュアルでリセットする(XLabel, YLabel,ZLabelプロパティで設定するか､またはxlabel,ylabel,zlabelコマンドを使って設置する)までは、太文字では表示されません｡目盛りラベルは、すぐに変更されます。

グリッドラインのラインスタイル。ラインスタイルは、コーテーションマーク内に、実線(-),点線(:)、鎖線(--)、一点鎖線(-.)等を指定するキャラクタから構成されます｡ デフォルトのグリッドラインスタイルは、点線です。グリッドラインの表示の切り替えには、grid コマンドを使います｡

コマンドラインユーザとGUIによるオブジェクトのハンドルへのアクセスの制御。このプロパティは、オブジェクトのハンドルが、その子オブジェクトの親のリスト内で視覚可能であるときを決定します。このプロパティは、(ダイアログボックスのような)ユーザインタフェースデバイスのみを含んでいるFigure内に、コマンドラインから誤って書き込むことや削除することを防ぐために有効です｡

マウスクリックによる選択。HitTestは、Axes上でのマウスクリックの結果、Axesがカレントのオブジェクト(gco コマンドとFigureのCurrentObjectプロパティにより出力される)になり得るかどうかを指定します。HitTestがoffならば、axesをクリックすると、その下のオブジェクト(通常はそのオブジェクトを含むFigure)を選択します。

コールバックルーチンの中断モード。Interruptibleプロパティは、Axesのコールバックルーチンが連続的に読み込まれるコールバックルーチンによって、中断されるかどうかを制御します。 ButtonDownFcnに対して定義されたコールバックルーチンのみが、Interruptibleプロパティにより影響を受けます。MATLABは、ルーチン内で drawnow,figure,getframe,pauseコマンドが実行されるときのみ、コールバックルーチンを中断できるイベントをチェックします。関連情報については、BusyActionプロパティを参照してください。

グラフィックスオブジェクトを軸ラインの上、または、下に書く。このプロパティは、任意の2次元表示(x,y,またはz軸に沿って見ているとき)で、軸のラインと目盛りが、Axesの子オブジェクトの上に書かれるか､下に書かれるかを決めるものです。これを使って、イメージの上にグリッドラインと目盛りを設定することができます。

プロットに使われるラインスタイルとマーカの順序。 このプロパティは、複数ラインのプロットを作成するときに、ラインスタイルとマーカの使用順序を設定するものです。たとえば

set(gca,'LineStyleOrder', '-*|:|o')

set(gca,'LineStyleOrder',{'-*',':','o'})

軸ラインの幅。このプロパティは、x-、y-、z-軸の幅をポイント単位で設定します｡デフォルトのライン幅は、0.5ポイント(1ポイントは1/72インチです)で す。

つぎのプロットを描画する方法。このプロパティは、既存のAxesの中に高水準プロット関数をどのように描くかを決めます｡

• add -- グラフィックスオブジェクトを描画するのに、既存のAxesを使います｡
• replace -- グラフィックスを表示する前に、存在しているAxesのすべての子オブジェクトを削除して、デフォルトに設定し直します｡ただし、Positionオブジェクトは除きます(cla resetと等価です)｡
• replacechildren -- すべての子オブジェクトを削除しますが、Axesプロパティをリセットしません(claと等価です)。

Axesの親オブジェクト。Axesの親オブジェクトのハンドル番号。Axesオブジェクトの親オブジェクトは、それを表示しているフィギュアです。ユーティリティ関数gcf は、カレントAxesの親オブジェクトのハンドル番号を出力します｡ FigureオブジェクトのみがAxesのParent(親)オブジェクトになります。

Axesプロットボックスの相対的なスケーリング。 プロットボックスの相対的なスケールをx-,y-, z-軸方向に制御する3要素ベクトル。プロットボックスは、x-, y-, z-軸の範囲によって定義されたAxesデータ領域を取り囲むものです。

Axesのスケーリングを制御する方法。このプロパティは、PlotBoxAspectRatioプロパティの値をユーザが設定するか、または、MATLABにより自動的に選択するかを制御するものです。 PlotBoxAspectRatioプロパティに対して、値を設定すると､このプロパティは自動的にmanualに設定されます｡DataAspectRatioMode, PlotBoxAspectRatioMode, CameraViewAngleModeをすべてautoに設定した場合、 PlotBoxAspectRatioModeをmanualに変更すると、stretch-to-fillの機能が使用できなくなります。

Axesの位置。フィギュアウィンドウの中のAxesの位置を決定する長方形を設定する4要素ベクトル。ベクトルは、つぎの型をしています。

[left bottom width height]

射影のタイプ。このプロパティは、2つ用意されている射影法の選択を行い ます。

• orthographic - この射影タイプは、視点から与えられた点までの距離に関して、グラフックスオブジェクトの正しい相対的な大きさを保ちます｡ データ内の平行線は、スクリーン上で平行に描画されます。
• perspective - この射影タイプは、3次元のオブジェクトを2次元表現で深みを与えるために、遠近を付けて表現するものです｡ しかし、perspectiveは、オブジェクトの相対的な大きさを保存しません。同じ長さのラインでも、遠いものは､ 近いものに比べ短く表示されます。データ内の平行線は、スクリーン上では平行ではなくなります。

選択されたオブジェクトの表示。このプロパティをonにし、SelectionHighlight プロパティもon (デフォルト)とするならば、MATLABは選択状態を示す"ハンドル"をオブジェクトの隅と中央に表示します｡ たとえば、ButtonDownFcn コールバックルーチンでこのプロパティをonに設定するように定義すると、axesが選択されたことを示すことができます。

選択時のオブジェクトの強調。このプロパティをonに設定していると､ MATLABは、4つのエッジと4隅にハンドル(グラフィックスのハンドル番号とは異なる)を描画することにより、選択されている状態を示します｡ SelectionHighlight プロパティをoffにすると、MATLABはハンドルを表示しません｡

ユーザ設定のオブジェクトラベル。 Tag プロパティは、ユーザ設定のラベルをもつグラフィックスオブジェクトを識別する方法を与えます｡ これは、オブジェクトのハンドル番号をグローバル変数として定義したり、コールバックルーチン間の引数としてそれらを受け渡したりする必要がある対話型のグラフィックスプログラムを構築するときに､特に有効です。

axes('Tag','Special Axes')

axes(findobj('Tag','Special Axes'))

目盛りの方向付け。2次元表示に対して､デフォルトは、軸ラインの内側方向に目盛りを設定します｡ 3次元表示に対しては､ 軸ラインの外側方向に設定します｡

目盛り方向の自動制御。auto モードで、MATLABは、2次元表示に対しては内側方向に、3次元では外側方向に目盛りを設定します｡ TickDirにある値を設定すると､ MATLABはTickDirMode を manualに設定します｡ manualでは、MATLABは、設定する目盛り方向を変更しません｡

目盛りの長さ。Axesの目盛りの長さを設定する2要素ベクトルです。最初の要素は､ 2次元表示に対して使われる目盛りマークの長さで、2番目の要素は､ 3次元表示に対して使われる目盛りの長さです。目盛りマークの長さは、可視のX、Y、Z軸の注釈行のうち最長の長さに対して正規化される単位で設定してください。

軸のタイトル。Axesタイトルに対して使われているtextオブジェクトのハンドル番号。このハンドル番号を使って､ タイトルのtext のプロパティを変更したり､ 既存のTextオブジェクトのハンドルに Titleを設定することができます。たとえば、つぎのステートメントは、カレントのタイトルのカラーを赤に変更します｡

set(get(gca,'Title'),'Color','r')

set(gca,'Title',text('String','New Title','Color','r'))

title('New Title','Color','r')

グラフィックスオブジェクトのタイプ。このプロパティは、グラフィックスオブジェクトのクラスを識別する文字列を含んでいます｡ Axesオブジェクトに対して､ 必ずTypeは、'axes'で設定されます｡

コンテキストメニューとaxesの対応付け。このプロパティは、Axesの親のFigure内で作成したUicontextmenuオブジェクトのハンドルを割り当てます。コンテキストメニューを作成するためには、関数uicontextmenu を使用してください。Axes上でマウスを右クリックしたときに、コンテキストメニューを表示します。

位置の単位。Positionプロパティを解釈するために使う単位です。すべて の単位は､ Figureウィンドウの下左隅から測ります。

• normalizedは、Figureウィンドウの下左隅を(0,0)に、上右隅を(1.0,1.0)にします。
• inches, centimeters,pointsは、絶対的な単位(1ポイントは1/72インチ)です。
• Characterは、デフォルトのシステムフォントからキャラクタによって定義されます。1つのキャラクタの幅は文字xの幅で、キャラクタの高さはテキスト内の2行のベースライン間の距離です。

ユーザ指定データ。このプロパティは、Axesオブジェクトと関連付けたい任意のデータです。Axesは、このプロパティを使いませんが、関数set,getを使ってアクセスすることができます。

Viewプロパティにより与えられる機能は、現在はAxesのカメラプロパティ (CameraPosition, CameraTarget, CameraUpVector,CameraViewAngle)により制御されるようになりました。viewを参照してください。

Axesの可視化。デフォルトでは、Axesは可視状態です。このプロパティをoff に設定すると、表示されている軸のライン、目盛り、ラベルは消えます。このプロパティは、Axesの子オブジェクトに影響を与えません。

x軸の目盛りとラベルの位置。このプロパティは、MATLABがx-軸の目盛りやラベルを表示する場所を制御します。このプロパティをtopに設定すると、デフォルトの位置であるプロットの下部の部分から、プロット上部にx-軸を移動します。

y-軸の目盛りとラベルの位置。このプロパティは、MATLABがy-軸の目盛りやラベルを表示する場所を制御します。このプロパティを rightに設定すると、デフォルトの位置であるプロットの左側から、プロットの右側にy軸を移動します。2つのy軸を使う簡単な方法は、plotyyを参照してください。

X, Y, Z軸を制御するプロパティ

Axesラインのカラー。RGBの3要素を指定する要素ベクトル、または、既定のMATLABのカラー文字列です。このプロパティは、x-、y-、z-軸の軸ライン、目盛り、ラベル、軸のグリッドカラーを決めます。デフォルトの軸のカラーは、黒色です。カラーの設定法の詳細については、ColorSpecを参照してください。

値の増加する方向。Axesの値の増加する方向を制御するモードです。Axesは、右手座標系を作ります。デフォルトは、

• x-軸の値は、左から右へ増加します。この方向を逆にするには、このプロパティを reverseに設定してください。

set(gca,'XDir','reverse')

• y-軸の値は、2次元の場合、下から上、3次元の場合、前から後に増加します。この方向を逆にするには、このプロパティをreverseに設定してください。

set(gca,'YDir','reverse')

• z-軸の値は、2次元の場合、スクリーンからユーザの視点方向、3次元の場合、下から上に増加します。この方向を逆にするには、このプロパティをreverseに設定してください。

set(gca,'ZDir','reverse')

Axesのグリッドラインを設定。これらのプロパティをonに設定すると、MATLABは、各々の軸に垂直なグリッドラインを描きます(x, y, zの値に沿ったライン)。gridコマンドを使って、これらすべてのプロパティをon、または、offに一度に設定できます。

Axesのラベル。x, y, z-軸それぞれのラベル付けに使うTextオブジェクトのハンドル。これらのプロパティのどれかに値を割り当てるためには、ラベルとして使うテキスト文字列に対してハンドル番号を取得しなければなりません。つぎのステートメントは、Textオブジェクトを定義し、XLabelプロパティにハンドル番号を割り当てます。

set(gca,'Xlabel',text('String','axis label'))

Axesの範囲。各々の軸の最小値と最大値を設定する2要素ベクトル。

MATLAB、または、ユーザによる範囲の制御。Axesの範囲を設定するモードは、プロットされるデータ(たとえば、Axesの子オブジェクトのXData, YData,ZData)をベースに、MATLABがAxesの範囲を計算するかどうか、または、ユーザが、XLim, YLim, ZLimプロパティを使って明示的に値を設定するかどうかを決定します。後者の場合、各範囲の設定モードはmanualに設定されます。

軸のスケーリング。各々の軸に対して、線形スケーリング、または、対数スケーリングを選択します。loglog, semilogx, semilogyを参照してください。

目盛り間隔。各々の軸に沿って目盛りの位置を決めるx-, y-, z-データ値のベクトル。目盛りを表示したくなければ、各々のプロパティを空ベクトル[ ] で設定してください。これらのベクトルは、単調増加でなければなりません。

目盛りラベル。 各々の軸に沿って目盛りに対するラベルとして使う文字行列。 これらのラベルは、MATLABにより生成される数値ラベルを置き換えます。 すべての目盛りに対して、十分なテキストラベルを設定できなければ、MATLABは設定されるラベルをすべてを使ってから設定したラベルを再度使います。

set(gca,'XTickLabel',{'One';'Two';'Three';'Four'})

set(gca,'XTickLabel',{'1';'10';'100'})
set(gca,'XTickLabel','1|10|100')
set(gca,'XTickLabel',[1;10;100])
set(gca,'XTickLabel',['1  ';'10 ';'100'])

目盛り間隔の設定法。各々の軸に対して、MATLABがデータの取り得る範囲をもとに目盛り間隔を計算するか(autoモード)、または、XTick, YTick, ZTick プロパティに設定した値を使うか(manualモード)を決めます。XTick, YTick,ZTickプロパティに対して値を設定すると、各々のモードはmanualに設定されます。

目盛りの設定法。プロットされたデータ範囲をカバーするような目盛りラベルを使うか(autoモード)、または、XTickLabel, YTickLabel, ZTickLabelプロパティで設定して目盛りラベルを使うかを設定します(manualモード)。XTickLabel,YTickLabel, ZTickLabelプロパティに対して値を設定すると、各々の軸の目盛りのモードは、manualに設定されます。

axes

axis