ドキュメンテーション

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

axis

軸の範囲と外観の設定

構文

  • axis(limits)
  • axis style
  • axis mode
  • axis ydirection
  • axis visibility
  • lim = axis
  • [m,v,d] = axis('state')
  • ___ = axis(ax,___)

説明

axis(limits) は、現在の座標軸の範囲を設定します。現在の座標軸が直交座標軸である場合は、limits[xmin xmax ymin ymax] の形式の 4 要素ベクトルとして指定し、x 軸と y 軸の範囲を設定します。z 軸の範囲も設定するには、6 要素ベクトルを指定します。色の範囲も設定するには、8 要素ベクトルを指定します。現在の座標軸が極座標軸である場合は、limits を 4 要素ベクトルとして指定し、θ 軸と r 軸の範囲を設定します。

axis style は、範囲とスケーリングの設定に事前定義スタイルを使用します。たとえば、各軸に沿って等しい長さのデータ単位を使用するには、style に equal を指定します。

axis mode は、軸の範囲を自動選択するかどうかを設定します。mode には、manualauto、あるいはいずれかの半自動オプション ('auto x' など) を指定します。

axis ydirection は、座標系の原点の配置および y 値の増加方向を制御します。ydirectionij に設定すると、原点が座標軸の左上隅に配置されます。y 値は上から下に増加します。ydirectionxy に設定すると、原点が座標軸の左下隅に配置されます。y 値は下から上に増加します。これは既定値です。

axis visibility は、座標軸または極座標軸の背景の可視性を制御します。visibilityoff に設定すると、座標軸の背景が非表示になります。座標軸内のプロットは引き続き表示されます。visibilityon に設定すると、座標軸の背景が表示されます。これは既定値です。

lim = axis は、現在の座標軸の x 軸と y 軸の範囲を返します。3 次元座標軸の場合、z 軸の範囲も返します。極座標軸の場合、θ 軸と r 軸の範囲を返します。

[m,v,d] = axis('state') は、座標軸の範囲の選択、座標軸の可視性および y 軸の方向に関する現在の設定を返します。

    メモ:   この構文は将来のリリースで削除される予定です。値を取得するには、代わりに座標軸の XLimModeYLimModeZLimModeVisible および YDir の各プロパティを使用してください。

___ = axis(ax,___) は現在の座標軸の代わりに ax で指定される座標軸または極座標軸を使用します。最初の入力引数として ax を指定します。元の構文によりサポートされる場合にのみ、追加の入力引数または出力引数を含めることができます。入力引数が文字列の場合、引数を単一引用符で囲みます (例: axis(ax,'equal'))。

すべて折りたたむ

正弦関数をプロットします。

x = linspace(0,2*pi);
y = sin(x);
plot(x,y,'-o')

x 軸の範囲が $0$ $2\pi$ に、y 軸の範囲が -1.5 ~ 1.5 になるよう、座標軸の範囲を変更します。

axis([0 2*pi -1.5 1.5])

プロットを作成します。x 軸の範囲を設定し、y 軸の下限値を設定します。y 軸の上限値には、自動計算された値を使用します。

x = linspace(-10,10,200);
y = sin(4*x)./exp(.1*x);
plot(x,y)
axis([-10 10 0 inf])

2 つのサブプロットを含む Figure を作成します。各サブプロットに正弦波をプロットします。その後、サブプロットの軸の範囲を同じ値に設定します。

x1 = linspace(0,10,100);
y1 = sin(x1);
ax1 = subplot(2,1,1);
plot(ax1,x1,y1)

x2 = linspace(0,5,100);
y2 = sin(x2);
ax2 = subplot(2,1,2);
plot(ax2,x2,y2)

axis([ax1 ax2],[0 10 -1 1])

座標軸のラインと背景を表示せずに、表面をプロットします。

surf(peaks)
axis off

表面をプロットします。座標軸の端までプロットされるよう、軸の範囲をデータ範囲と同じに設定します。

surf(peaks)
axis tight

現在の軸の範囲の値を返します。

l = axis
l =

    1.0000   49.0000    1.0000   49.0000   -6.5466    8.0752

チェッカーボードのプロットを作成し、座標系の方向を変更します。

まず、summer のカラーマップを使用してプロットを作成します。既定では、x の値は左から右に増加し、y の値は下から上に増加します。

C = eye(10);
pcolor(C)
colormap summer

y 値が上から下に増加するよう、座標系を反転します。

axis ij

正弦波をプロットします。

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

hold on を使用して、座標軸に正弦波をもう 1 つ追加します。範囲モードを manual に設定して、現在の軸の範囲を保持します。

y2 = 2*sin(x);
hold on
axis manual
plot(x,y2)
hold off

適切な座標軸の範囲が自動選択されるようにする場合は、範囲モードの設定を auto に戻します。

axis auto

入力引数

すべて折りたたむ

座標軸の範囲。次のいずれかの形式で、4、6 または 8 要素ベクトルとして指定します。

  • [xmin xmax ymin ymax]x 軸の範囲を xmin から xmax までに設定します。y 軸の範囲を ymin から ymax までに設定します。

  • [xmin xmax ymin ymax zmin zmax]z 軸の範囲も zmin から zmax までに設定します。

  • [xmin xmax ymin ymax zmin zmax cmin cmax] — 色の範囲も設定します。 cmin はカラーマップの最初の色にマップされるデータ値です。cmax はカラーマップの最後の色にマップされるデータ値です。

直交座標軸ではなく、極座標軸の範囲を設定する場合は、次の形式で範囲を指定します。

  • [thetamin thetamax rmin rmax] — θ 軸の範囲を thetamin から thetamax までに設定します。r 軸の範囲を rmin から rmax までに設定します。

    メモ:   半自動の範囲では、自動選択する座標軸の範囲に inf または -inf を使用してください。たとえば、axis([-inf 10 0 inf]) を使用すると、x 軸の下限値および y 軸の上限値に、適切な値が選択されます。x 軸の上限値と y 軸の下限値には、指定した値が使用されます。

範囲を指定した場合、axes オブジェクトの XLimYLimZLimCLim の各プロパティが、指定した値に変更されます。極座標軸を使用している場合、範囲を設定すると ThetaLim および RLim の各プロパティが設定されます。関連するモードのプロパティも 'manual' に変更されます。

例: [0 1 0 1]

例: [0 1 0 1 0 1]

軸の範囲の手動、自動または半自動の選択。次の表のいずれかとして指定します。

説明変更される座標軸のプロパティ
manual すべての軸の範囲を現在の値に固定します。 XLimModeYLimMode および ZLimMode'manual' に設定されます。極座標軸を使用している場合、このオプションは ThetaLimMode および RLimMode'manual' に設定します。
auto座標軸のすべての軸の範囲が自動選択されます。 XLimModeYLimMode および ZLimMode'auto' に設定されます。極座標軸を使用している場合、このオプションは ThetaLimMode および RLimMode'auto' に設定します。
'auto x'座標軸の x 軸の範囲が自動選択されます。 XLimMode'auto' に設定されます。
'auto y'座標軸の y 軸の範囲が自動選択されます。 YLimMode'auto' に設定されます。
'auto z'座標軸の z 軸の範囲が自動選択されます。 ZLimMode'auto' に設定されます。
'auto xy'座標軸の x 軸および y 軸の範囲が自動選択されます。 XLimMode および YLimMode'auto' に設定されます。
'auto xz'座標軸の x 軸および z 軸の範囲が自動選択されます。 XLimMode および ZLimMode'auto' に設定されます。
'auto yz'座標軸の y 軸および z 軸の範囲が自動選択されます。 YLimMode および ZLimMode'auto' に設定されます。

これらのオプションを極座標軸に使用することはできません。

軸の範囲とスケーリング。次のいずれかの値として指定します。

説明変更される座標軸のプロパティ
tight軸の範囲の設定をデータ範囲と等しくして、座標軸のボックスをデータ範囲にぴったり合わせます。 XLimModeYLimMode および ZLimMode'auto' に変更されます。極座標軸を使用している場合、ThetaLimMode および RLimMode が変更されます。座標軸に追加された新規データを取り込むために、範囲は自動更新されます。hold on の使用時に範囲が変更されないようにするには、axis tight manual を使用します。
equal各軸のデータ単位に同じ長さを使用します。 DataAspectRatio[1 1 1] に、PlotBoxAspectRatio[3 4 4] に設定されます。また、関連するモードのプロパティが manual に設定されます。"表示域に合わせる" 動作が無効になります。
image各軸のデータ単位に同じ長さを使用し、座標軸のボックスをデータ範囲にぴったり合わせます。 DataAspectRatio[1 1 1] に設定され、また関連するモードのプロパティが manual に設定されます。"表示域に合わせる" 動作が無効になります。
square軸に長さが等しいラインを使用します。それに合わせて、データ単位のインクリメントを調整します。 PlotBoxAspectRatio[1 1 1] に設定され、また関連するモードのプロパティが manual に設定されます。"表示域に合わせる" 動作が無効になります。
fill"表示域に合わせる" 動作を有効にします (既定)。座標軸の Position プロパティに定義された位置を表す四角形の辺の長さが、各軸のラインの長さになります。プロット ボックスの縦横比モードおよびデータの縦横比モードの各プロパティが、auto に設定されます。
vis3d縦横比プロパティを固定します。プロット ボックスの縦横比モードおよびデータの縦横比モードの各プロパティが、manual に設定されます。
normal既定の動作に戻します。プロット ボックスの縦横比モードおよびデータの縦横比モードの各プロパティが、auto に設定されます。

プロット ボックスの縦横比およびデータの縦横比についての詳細は、座標軸の PlotBoxAspectRatio および DataAspectRatio のプロパティを参照してください。

スタイル オプションは組み合わせることができます。これらのオプションは左から右に評価されるので、後続のオプションがその前のオプションで設定されているプロパティを上書きします。

これらのオプションを極座標軸に使用することはできませんが、axis tight および axis normal のコマンドは例外となります。

y 軸の方向。次のいずれかの値として指定します。

  • xy — 既定の方向。2 次元表示の座標軸の場合、y 軸は垂直で、下から上に向かって値が増加します。

  • ij — 逆方向。2 次元表示の座標軸の場合、y 軸は垂直で、上から下に向かって値が増加します。

これらのオプションを極座標軸に使用することはできません。

座標軸のラインと背景の可視性。on または off として指定します。可視性を指定すると、axes オプジェクトまたは polar axes オブジェクトの Visible プロパティが指定値に設定されます。

axes オブジェクトまたは polar axes オブジェクト。スカラーまたはベクトルとして指定します。座標軸を指定しない場合、axis により現在の座標軸の範囲 (gca) が設定されます。

座標軸を指定する場合は、それ以外の文字列型の入力引数を単一引用符で囲みます。

例: axis(ax,'tight')

例: axis(ax,limits)

例: axis(ax,'manual')

出力引数

すべて折りたたむ

現在の範囲の値。4 要素ベクトルまたは 6 要素ベクトルで返されます。2 次元表示の直行座標軸の場合、lim の形式は [xmin xmax ymin ymax] です。3 次元表示の座標軸の場合、lim の形式は [xmin xmax ymin ymax zmin zmax] です。座標軸の XLimYLim および ZLim の各プロパティには、範囲の値が格納されています。

極座標軸の場合、lim の形式は [thetamin thetamax rmin rmax] です。極座標軸の ThetaLim および RLim の各プロパティには、範囲の値が含まれています。

詳細

すべて折りたたむ

ヒント

  • 座標軸がない場合は、関数 axis によって作成されます。

  • 事前設定された軸の範囲をプロット関数によって無効にされないようにするには、hold on を使用します。

参考

関数

プロパティ

R2006a より前に導入

この情報は役に立ちましたか?