Main Content

refline

プロットへの基準線の追加

ページ内をすべて折りたたむ

構文

refline(m,b)
refline(coeffs)
refline
refline(ax,___)
hline = refline(___)

説明

refline(m,b)は、勾配mおよび切片bをもつ基準線を現在の座標軸に追加します。

例

refline(coeffs)は、ベクトルcoeffsの要素によって定義される線を Figure に追加します。

例

入力因数のないreflineは、lslineに等しくなります。

例

refline(ax,___)は、前の構文の入力引数のいずれかを使用して、axによって指定された座標軸で基準線をプロットに追加します。

例

hline= refline(___)は、前の構文の入力引数のいずれかを使用して、基準線オブジェクトhlineを返します。特定の基準線のプロパティを作成後に変更するには、hlineを使用します。プロパティの一覧については、Line のプロパティを参照してください。

例

すべて折りたたむ

ライブ スクリプトを開く

独立変数xおよび従属変数yについて標本データを生成します。

x = 1:10; y = x + randn(1,10);

xおよびyの散布図を作成します。

scatter(x,y,25,'b','*')

Figure contains an axes object. The axes object contains an object of type scatter.

散布図に最小二乗線 を重ね合わせます。

refline

Figure contains an axes object. The axes object contains 2 objects of type scatter, line.

散布図の平均の位置に基準線を追加します。

mu = mean(y); hline = refline([0 mu]); hline.Color ='r';

Figure contains an axes object. The axes object contains 3 objects of type scatter, line.

赤い線は、データの平均における基準線です。

ライブ スクリプトを開く

プロットに使用する変数 x と 2 つの異なる変数 y を定義します。

rngdefault% For reproducibilityx = 1:10; y1 = x + randn(1,10); y2 = 2*x + randn(1,10);

ax1を図の上半分として定義し、ax2を図の下半分として定義します。y1を使用して上の座標軸に最初の散布図を作成し、y2を使用して下の座標軸に2番目の散布図を作成します。

figure ax1 = subplot(2,1,1); ax2 = subplot(2,1,2); scatter(ax1,x,y1) scatter(ax2,x,y2)

Figure contains 2 axes objects. Axes object 1 contains an object of type scatter. Axes object 2 contains an object of type scatter.

上のプロットの最小二乗線と、下のプロットのy2値の平均で基準線を重ね合わせます。

lsline(ax1)% This is equivalent to refline(ax1)mu = mean(y2); refline(ax2,[0 mu])

Figure contains 2 axes objects. Axes object 1 contains 2 objects of type scatter, line. Axes object 2 contains 2 objects of type scatter, line.

入力引数

すべて折りたたむ

基準線の勾配。数値スカラーを指定します。この関数は、mを使用して次の直線を定義します。

y = m*x + b.

例:refline(-1,1)

データ型:single|double

基準線の切片。数値スカラーを指定します。この関数は、bを使用して次の直線を定義します。

y = m*x + b.

例:refline(2,-10)

データ型:single|double

線形係数。長さ 2 の数値ベクトルを指定します。coeffsには、次のように定義される直線の係数を格納します。

y = coeffs(1)*x + coeffs(2).

例:refline([-1,2])

データ型:single|double

ターゲットの座標軸。axesオブジェクトを指定します。現在の座標軸が直交座標軸の場合、座標軸が指定されなければ、関数reflineは現在の座標軸を使用します。

出力引数

すべて折りたたむ

1 つ以上の基準線オブジェクト。スカラーまたはベクトルとして返されます。これらのオブジェクトは、特定の基準線のプロパティのクエリと変更に使用できる一意な識別子です。プロパティの一覧については、Line のプロパティを参照してください。

バージョン履歴

R2006a より前に導入

参考

||