ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

axes

構文

axes
axes(Name,Value)
axes(parent,Name,Value)
ax = axes(___)
axes(cax)

説明

axes は、現在の Figure で既定の直交座標軸を作成して、現在の座標軸にします。通常、プロットする前に座標軸を作成する必要はありません。座標軸が存在しない場合、プロット時にグラフィックス関数により自動的に作成されるためです。

axes(Name,Value) は、1 つ以上の名前と値のペアの引数を使用して、座標軸の外観の変更、またはデータの表示方法の制御を行います。たとえば、'FontSize',14 は座標軸のテキストのフォント サイズを設定します。プロパティの一覧については、Axes のプロパティ を参照してください。

axes(parent,Name,Value) は、現在の Figure 内ではなく、parent で指定された Figure、パネル、またはタブ内に座標軸を作成します。

ax = axes(___) は、作成された Axes オブジェクトを返します。Axes オブジェクトを作成した後でプロパティのクエリや変更を行うには、ax を使用します。プロパティの一覧については、Axes のプロパティ を参照してください。

axes(cax) は、cax で指定された座標軸またはグラフを現在の座標軸にして、親の Figure にフォーカスを移動します。また、このコマンドは cax を Figure の Children プロパティにリストされる最初のオブジェクトにし、Figure の CurrentAxes プロパティを cax に設定します。

すべて折りたたむ

Figure 内に 2 つの Axes オブジェクトを配置し、各オブジェクトにプロットを追加します。

左下隅が点 (0.1 0.1) にあり、幅と高さが 0.7 になるように、1 番目の Axes オブジェクトの位置を指定します。左下隅が点 (0.65 0.65) にあり、幅と高さが 0.28 になるように、2 番目の Axes オブジェクトの位置を指定します。既定では、値は Figure を基準に正規化されます。Axes オブジェクトを ax1 および ax2 として返します。

figure
ax1 = axes('Position',[0.1 0.1 0.7 0.7]);
ax2 = axes('Position',[0.65 0.65 0.28 0.28]);

Axes オブジェクトにプロットを追加します。座標軸を最初の入力引数としてグラフィックス関数に渡すことで、座標軸を指定します。ほとんどのグラフィックス関数は、目盛りの値とラベルなど、座標軸の一部のプロパティをリセットします。ただし、座標軸の位置はリセットしません。

contour(ax1,peaks(20))
surf(ax2,peaks(20))

重ね合わせた 2 つの Axes オブジェクトを作成します。次に、現在の座標軸を指定してプロットを追加します。

まず、2 つの Axes オブジェクトを作成し、位置を指定します。各座標軸を囲むボックスの外枠を表示します。Axes オブジェクトを ax1 および ax2 として返します。

figure
ax1 = axes('Position',[0.1 0.1 .6 .6],'Box','on');
ax2 = axes('Position',[.35 .35 .6 .6],'Box','on');

ax1 を現在の座標軸にします。この操作により、座標軸が前面に表示され、後続のグラフィックス関数のターゲットになります。座標軸にライン プロットを追加します。

axes(ax1)
x = linspace(0,10);
y = sin(x);
plot(x,y)

2 つのタブを含む Figure を作成します。各タブに親コンテナーを指定することで各タブに座標軸を追加します。1 番目のタブにライン、2 番目のタブに表面をプロットします。

figure
tab1 = uitab('Title','Tab1');
ax1 = axes(tab1);
plot(ax1,1:10)

tab2 = uitab('Title','Tab2');
ax2 = axes(tab2);
surf(ax2,peaks)

入力引数

すべて折りたたむ

親コンテナー。FigurePanel または Tab オブジェクトとして指定します。

現在の座標軸にする座標軸。Axes オブジェクト、PolarAxes オブジェクト、または HeatmapChart などのグラフィックス オブジェクトとして指定します。

Figure の状態を変更せずに、オブジェクトを現在の座標軸にする場合、その座標軸を含む Figure の CurrentAxes プロパティを設定します。次に例を示します。

fig = gcf;
fig.CurrentAxes = cax;
この方法は、Figure を最小化したまま、または他の Figure の下にスタックしたままで、現在の座標軸を指定する場合に便利です。

名前と値のペアの引数

例: axes('Position',[.3 .3 .5 .5]) は位置を設定します。

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は一重引用符 (' ') で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を指定できます。

一部のグラフィックス関数は、軸の範囲や目盛り値などをプロットするときに座標軸のプロパティ値を変更します。プロット後に、座標軸のプロパティを設定します。

メモ

ここでは、プロパティの一部だけを紹介しています。完全な一覧については、Axes のプロパティ を参照してください。

ラベルの余白を除いたサイズと位置。[left bottom width height] の形式の 4 要素ベクトルとして指定します。既定では、MATLAB® はコンテナーを基準に正規化された単位で値を測定します。単位を変更するには、Units プロパティを設定します。

  • left 要素と bottom 要素は、コンテナー (通常は Figure、パネルまたはタブ) の左下隅から位置境界の左下隅までの距離を定義します。

  • width 要素と height 要素は、位置境界の寸法です。3 次元表示の座標軸では、Position プロパティは座標軸を囲む最小の四角形です。

座標軸の周りのテキストを考慮して位置を指定する場合は、代わりに OuterPosition プロパティを設定します。以下の図に、OuterPosition 値 (青) と Position 値 (赤) で定義された領域を示します。

座標軸の 2 次元表示座標軸の 3 次元表示

座標軸の位置の詳細については、座標軸のレイアウトの制御を参照してください。

ラベルと余白を含むサイズと位置。[left bottom width height] の形式の 4 要素ベクトルとして指定します。既定では、MATLAB はコンテナーを基準に正規化された単位で値を測定します。単位を変更するには、Units プロパティを設定します。既定値 [0 0 1 1] は、コンテナーの内側全体になります。

  • left 要素と bottom 要素は、コンテナー (通常は Figure、パネルまたはタブ) の左下隅から位置境界の左下隅までの距離を定義します。

  • width 要素と height 要素は、外側の位置境界の寸法です。

以下の図に、OuterPosition 値 (青) と Position 値 (赤) で定義された領域を示します。

座標軸の 2 次元表示座標軸の 3 次元表示

座標軸の位置の詳細については、座標軸のレイアウトの制御を参照してください。

位置の単位。次の値のいずれかとして指定します。

Units説明
'normalized' (既定)コンテナー (通常は Figure またはパネル) を基準に正規化されます。コンテナーの左下隅は (0,0) に、右上隅は (1,1) にマッピングされます。
'inches'インチ。
'centimeters'センチメートル。
'characters'

グラフィックス ルート オブジェクトの既定の uicontrol フォントに基づきます。

  • 文字の幅 = 文字 x の幅。

  • 文字の高さ = 2 行のテキストのベースライン間の距離。

'points'タイポグラフィのポイント。1 ポイントは 1/72 インチです。
'pixels'

ピクセル。

R2015b 以降、Windows® および Macintosh システムにおいて、ピクセル単位の距離はシステム解像度に依存しません。

  • Windows システムの 1 ピクセルは 1/96 インチです。

  • Macintosh システムの 1 ピクセルは 1/72 インチです。

  • Linux® システムでは、ピクセルのサイズは使用しているシステムの解像度によって決まります。

オブジェクトの作成中に Name,Value のペアとして単位を指定する場合、それらの単位を使用するプロパティ (Position など) を指定する前に Units プロパティを設定しなければなりません。

詳細

すべて折りたたむ

現在の座標軸

現在の Axes は、グラフィックス出力のターゲットです。既定では、plottextsurf などのグラフィックス関数は、現在の座標軸にその結果を描画します。現在の Axes オブジェクトは通常、最後に作成された axes オブジェクトまたは最後にマウスでクリックした axes オブジェクトです。現在の Figure を変更すると、現在の Axes も変わります。gca コマンドは、現在の座標軸を返します。

R2006a より前に導入