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

xlim

x 軸の範囲の設定とクエリ

構文

xlim(limits)

xl = xlim

xlim auto

xlim manual

m = xlim('mode')

___ = xlim(target,___)

説明

xlim(limits) は、現在の座標軸またはチャートの x 軸の範囲を設定します。[xmin xmax] の形式の 2 要素ベクトルとして limits を指定します。ここで xmax は xmin より大きい値です。

xl = xlim は現在の範囲を 2 要素ベクトルとして返します。

xlim auto は、座標軸によって x 軸の範囲を決定できる自動モードに設定します。範囲はプロットされたデータの範囲です。このオプションは、範囲を変更した後でそれを既定値に戻す場合に使用します。このコマンドは座標軸の XLimMode プロパティを 'auto' に設定します。

xlim manual は、範囲を現在の値に固定する手動モードに設定します。このオプションは、hold on コマンドで座標軸に新しいデータを追加する際に、現在の範囲を維持する場合に使用します。このコマンドは座標軸の XLimMode プロパティを 'manual' に設定します。

m = xlim('mode') は、現在の x 軸の範囲モードを 'auto' または 'manual' のいずれかとして返します。範囲を指定したりモードを手動に設定したりしない限り、自動モードが既定で使用されます。

___ = xlim(target,___) は、現在の座標軸の代わりに target で指定される座標軸またはチャートを使用します。前述の構文いずれかの最初の入力引数として target を指定します。元の構文が出力引数をサポートしている場合は、出力引数を含めることができます。モード入力は xlim(target,'auto') のように一重引用符で囲みます。

例

x 軸の範囲の設定

ラインをプロットして x 軸の範囲を 0 ～ 5 に設定します。

x = linspace(0,10);
y = sin(x);
plot(x,y)
xlim([0 5])

x 軸範囲の半自動設定の使用

表面プロットを作成し、0 より大きい x 値のみを表示します。x 軸の範囲の下限を 0 に指定し、上限は MATLAB に選択させます。

[X,Y,Z] = peaks;
surf(X,Y,Z)
xlim([0 inf])

日付をもつ x 軸の範囲の設定

x 軸に沿って日付をもつステム グラフを作成します。x 軸の範囲を 2014 年 6 月 1 日から 2014 年 6 月 5 日までに設定します。

t = datetime(2014,06,1) + caldays(0:10);
y = rand(11,1);
stem(t,y,'filled')

tstart = datetime(2014,06,1);
tend = datetime(2014,06,5);
xlim([tstart tend])

特定の座標軸に対する x 軸の範囲の設定

R2019b 以降、関数 tiledlayout および nexttile を使用して、プロットをタイル表示できます。関数 tiledlayout を呼び出して、2 行 1 列のタイル表示チャート レイアウトを作成します。関数 nexttile を呼び出して、axes オブジェクト ax1 および ax2 を作成します。各座標軸にデータをプロットします。次に、xlim の最初の入力引数として ax2 を指定することで、下のプロットの x 軸の範囲を設定します。

tiledlayout(2,1)
x = linspace(0,5,1000);
y = sin(100*x)./exp(x);
ax1 = nexttile;
plot(ax1,x,y)

ax2 = nexttile;
plot(ax2,x,y)
xlim(ax2,[0 1])

現在の x 軸の範囲の維持

座標軸にプロットを追加する際に現在の x 軸の範囲を維持するには、手動モードを使用します。

まず、ラインをプロットします。

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

x 軸の範囲モードを手動に設定し、範囲が変更されないようにします。hold on を使用して座標軸に 2 番目のプロットを追加します。

xlim manual
hold on
plot(2*x,2*y)
hold off

x 軸の範囲は、新しいプロットに合わせて更新されません。

モードを自動にリセットして、範囲が自動更新されるよう再設定します。

xlim auto

x 軸の範囲を返す

乱数データの散布図を作成します。x 軸の範囲の値を返します。

x = randn(50,1);
y = randn(50,1);
scatter(x,y)

xl = xlim

xl = 1×2

    -3     4

入力引数

limits — 範囲の下限と上限

2 要素ベクトル

範囲の上限と下限。[xmin xmax] の形式の 2 要素ベクトルとして指定します。ここで、xmax は xmin より大きい値です。範囲は、数値、カテゴリカル値、datetime 値、または duration 値として指定できます。ただし、指定する値のタイプは、x 軸に沿った値のタイプと一致していなければなりません。

両方の制限値を指定することも、一方の制限値を指定してもう一方を MATLAB^® で自動計算することもできます。下限値および上限値を自動的に計算する場合は、それぞれ -inf または inf を使用します。

例: xlim([0 1])

例: xlim([-inf 1])

例: xlim([0 inf])

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

target — ターゲットの座標軸またはチャート

Axes オブジェクト | チャート | 座標軸またはチャートの配列

ターゲット座標軸またはチャート。次のいずれかとして指定します。

• Axes オブジェクト。

• HeatmapChart オブジェクトなど、XLimits プロパティをもつチャート オブジェクト。

• 同じクラスに属する axes オブジェクトまたはチャート オブジェクトの配列。クラスを判定するには、関数 class を使用します。

この引数を指定しない場合、xlim は gca コマンドで返されるグラフィックス オブジェクトの範囲を設定します。

出力引数

xl — 現在の範囲

2 要素ベクトル

現在の範囲。[xmin xmax] の形式の 2 要素ベクトルとして返されます。

範囲をクエリすると、対応する Axes オブジェクトまたはグラフィックス オブジェクトの XLim または XLimits プロパティの値が返されます。

m — 現在の範囲モード

'auto' | 'manual'

現在の範囲モード。次のいずれかの値が返されます。

• 'auto' — 範囲を自動的に決定します。

• 'manual' — 手動で指定された範囲を使用します。データの変更を反映する更新は行われません。

x 軸の範囲モードをクエリすると、対応する Axes オブジェクトの XLimMode プロパティ値が返されます。

アルゴリズム

関数 xlim は、x 軸の範囲に関連するいくつかの座標軸プロパティの設定およびクエリを行います。

• XLim — x 軸の範囲を保存するプロパティ。

• XLimMode — x 軸の範囲モードを保存するプロパティ。x 軸の範囲を設定すると、このプロパティは 'manual' に変更されます。

参考

関数

• grid | xlabel | xtickformat | xticklabels | xticks | ylim | zlim

プロパティ

• Axes のプロパティ

トピック

• 軸の範囲の指定

R2006a より前に導入

×

例を開く

この例の変更されたバージョンがシステム上にあります。代わりにこのバージョンを開きますか?

いいえ、変更されたバージョンを上書きします。 はい