ドキュメンテーション

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

stairs

説明

stairs(Y) は、Y の要素の階段状グラフを描画します。

  • Y がベクトルの場合、stairs は 1 つのラインを描画します。

  • Y が行列の場合、stairs は行列の列ごとに 1 つのラインを描画します。

stairs(X,Y) は、X で指定された位置に Y の要素をプロットします。XY の入力は、同じサイズのベクトルまたは行列でなければなりません。また、X は行ベクトルまたは列ベクトルで、Ylength(X) 行の行列でなければなりません。

stairs(___,LineSpec) は、ライン スタイル、マーカー記号、色を指定します。たとえば ':*r' はアスタリスクのマーカーをもつ赤い点線を指定します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。

stairs(___,Name,Value) は 1 つ以上の名前と値のペアの引数を使用して階段状グラフを変更します。たとえば 'Marker','o','MarkerSize',8 は 8 ポイントの円のマーカーを指定します。

stairs(ax,___) は、現在の座標軸 (gca) の代わりに ax によって指定される座標軸にプロットします。オプションの ax は、前述の構文のすべての入力引数の組み合わせより前に指定できます。

h = stairs(___) は、1 つ以上の Stair オブジェクトを返します。hStair オブジェクトの作成後にそのオブジェクトのプロパティを変更する場合に使用します。

[xb,yb] = stairs(___) はプロットを描画しませんが、plot(xb,yb) が階段状グラフをプロットするような、同じサイズの行列 xbyb を返します。

すべて折りたたむ

0 ~ 4π の間にある等間隔の 40 個の値で評価した、階段状の正弦プロットを作成します。

X = linspace(0,4*pi,40);
Y = sin(X);

figure
stairs(Y)

Y の長さによって、x 軸のスケールが自動的に決定され生成されます。

0 ~ 4π の間にある等間隔の 50 個の値で評価した、2 つの余弦関数の階段状プロットを作成します。

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];

figure
stairs(Y)

Y の行数によって、x 軸のスケールが自動的に決定され生成されます。

0 ~ 4π の間にある等間隔の値で評価した、正弦波の階段状プロットを作成します。プロットの x 値のセットを指定します。

X = linspace(0,4*pi,40);
Y = sin(X);

figure
stairs(X,Y)

Y のエントリは、X の対応するエントリに対してプロットされます。

0 ~ 4π の間にある等間隔の値で評価した、2 つの余弦波の階段状プロットを作成します。プロットの x 値のセットを指定します。

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];

figure
stairs(X,Y)

1 番目のベクトル入力 X は、両方のデータ系列の x 軸の位置を決定します。

異なる値で評価した 2 つの正弦波の階段状プロットを作成します。各データ系列のプロットごとに、x 値の一意のセットを指定します。

x1 = linspace(0,2*pi)';
x2 = linspace(0,pi)';
X = [x1,x2];
Y = [sin(5*x1),exp(x2).*sin(5*x2)];

figure
stairs(X,Y)

X の各列は、Y の対応する列に対してプロットされます。

階段状プロットを作成し、ライン スタイルを破線、マーカー記号を円、色を赤に設定します。

X = linspace(0,4*pi,20);
Y = sin(X);

figure
stairs(Y, '-.or')

階段状プロットを作成し、Name,Value ペアの引数を使用してラインの幅を 2、マーカー記号を菱形、マーカーの面の色をシアンに設定します。

X = linspace(0,4*pi,20);
Y = sin(X);

figure
stairs(Y,'LineWidth',2,'Marker','d','MarkerFaceColor','c')

2 つのサブプロットを含む Figure を作成し、2 つの Axes ハンドル s(1) および s(2) を返します。Axes のハンドルを参照して、サブプロットごとに階段状プロットを作成します。

figure
s(1) = subplot(2,1,1);
s(2) = subplot(2,1,2);  

X = linspace(0,2*pi);
Y1 = 5*sin(X);
Y2 = sin(5*X);
stairs(s(1),X,Y1)
stairs(s(2),X,Y2)

2 つのデータ系列の階段状プロットを作成し、2 つの stair オブジェクトを返します。

X = linspace(0,1,30)';
Y = [cos(10*X), exp(X).*sin(10*X)];
h = stairs(X,Y);

1 つ目のデータ系列に小さい円のマーカーを使用します。2 つ目の系列にマゼンタで塗りつぶした円を使用します。R2014b から、プロパティの設定にドット表記を使用できるようになりました。それより前のリリースを使用している場合は、代わりに関数setを使用してください。

h(1).Marker = 'o';
h(1).MarkerSize = 4;
h(2).Marker = 'o';
h(2).MarkerFaceColor = 'm';

0 ~ 4π の間にある等間隔の 50 個の値で 2 つの余弦関数を評価し、plot を使用して階段状プロットを作成します。

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];
[xb,yb] = stairs(X,Y);

stairs は同じサイズ xbyb の 2 つの行列を返しますが、プロットは実行しません。

plot を使って、xbyb に関する階段状プロットを作成します。

figure
plot(xb,yb)

入力引数

すべて折りたたむ

y 値。ベクトルまたは行列として指定します。Y がベクトルの場合、stairs は stair オブジェクトを 1 つ作成します。Y が行列の場合、stairs は行列の列ごとに線を 1 本描画し、列ごとに個別の stair オブジェクトを作成します。

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

x 値。ベクトルまたは行列として指定します。Y がベクトルの場合、X は同じサイズのベクトルでなければなりません。Y が行列の場合、X は同じサイズの行列または長さが Y の行数と等しいベクトルでなければなりません。

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

ライン スタイル、マーカー記号および色。文字ベクトルまたは string として指定します。ライン スタイル、マーカー記号および色のオプションの詳細については、LineSpec を参照してください。

例: ':*r'

Axes オブジェクト。座標軸を指定しない場合、stairs は現在の座標軸にプロットします。

名前と値のペアの引数

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

例: 'Marker','s','MarkerFaceColor','red' は、赤い正方形のマーカーを使って階段状グラフをプロットします。

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

ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。

ライン スタイル説明結果として得られる線
'-'実線

'--'破線

':'点線

'-.'一点鎖線

'none'ラインなしラインなし

ライン幅。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。ラインがマーカーをもつ場合、ライン幅はマーカー エッジにも影響します。

ラインの色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。

  • RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

  • 16 進数カラー コードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。これらの値では大文字小文字は区別されません。したがって、カラー コード '#FF8800''#ff8800''#F80'、および '#f80' は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

色名省略名RGB 3 成分16 進数カラー コード外観
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

'none'該当なし該当なし該当なし色なし

MATLAB® の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

例: 'blue'

例: [0 0 1]

例: '#0000FF'

マーカー記号。次の表に挙げる値のいずれかとして指定します。既定では、オブジェクトはマーカーを表示しません。マーカー記号を指定すると、各データ点または各頂点にマーカーが追加されます。

説明
'o'
'+'プラス記号
'*'アスタリスク
'.'
'x'十字
'square' または 's'正方形
'diamond' または 'd'菱形
'^'上向き三角形
'v'下向き三角形
'>'右向き三角形
'<'左向き三角形
'pentagram' または 'p'星形五角形
'hexagram' または 'h'星形六角形
'none'マーカーなし

マーカー サイズ。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。

マーカーの輪郭の色。'auto'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。既定値の 'auto' は、Color プロパティと同じ色を使用します。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。

  • RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

  • 16 進数カラー コードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。これらの値では大文字小文字は区別されません。したがって、カラー コード '#FF8800''#ff8800''#F80'、および '#f80' は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

色名省略名RGB 3 成分16 進数カラー コード外観
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

'none'該当なし該当なし該当なし色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

マーカーの塗りつぶし色。'auto'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。'auto' オプションは親の座標軸の Color プロパティと同じ色を使用します。'auto' を指定し、座標軸のプロット ボックスが非表示の場合、マーカーの塗りつぶし色は figure の色です。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。

  • RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

  • 16 進数カラー コードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。これらの値では大文字小文字は区別されません。したがって、カラー コード '#FF8800''#ff8800''#F80'、および '#f80' は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

色名省略名RGB 3 成分16 進数カラー コード外観
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

'none'該当なし該当なし該当なし色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

出力引数

すべて折りたたむ

Stair オブジェクト。これらの一意の識別子を使って、Stair オブジェクトの作成後にそのオブジェクトのプロパティをクエリしたり変更したりできます。

plot で使用する x の値。ベクトルまたは行列として返されます。xb には plot(xb,yb) が階段状グラフを作成できるように、適切な値が含まれています。

plot で使用する y の値。ベクトルまたは行列として返されます。yb には plot(xb,yb) が階段状グラフを作成できるように、適切な値が含まれています。

拡張機能

R2006a より前に導入