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

stem

離散データ列のプロット

構文

stem(Y)

stem(X,Y)

stem(___,'filled')

stem(___,LineSpec)

stem(___,Name,Value)

stem(ax,___)

h = stem(___)

説明

stem(Y) は、x 軸に沿ったベースラインから伸びるステムとして、データ シーケンス Y をプロットします。データ値は、各ステムの終点となる円によって表されます。

• Y がベクトルの場合、x 軸の範囲は 1 から length(Y) までになります。

• Y が行列の場合、stem は同じ x 値に対して 1 行のすべての要素をプロットします。x 軸の範囲は 1 から Y の行数までになります。

stem(X,Y) は、X で指定した値に、データ シーケンス Y をプロットします。入力 X と Y は、同じサイズのベクトルまたは行列でなければなりません。また、X は行ベクトルまたは列ベクトルで、Y は length(X) 行の行列でなければなりません。

• X と Y が両方ともベクトルの場合、stem は Y のエントリを対応する X のエントリに対してプロットします。

• X がベクトルで Y が行列の場合、stem は Y の 1 行のすべての要素が同じ値に対してプロットされるように、X で指定された一連の値に対して、Y の各列をプロットします。

• X と Y が両方とも行列の場合、stem は Y の列を対応する X の列に対してプロットします。

stem(___,'filled') は、円を塗りつぶします。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。

stem(___,LineSpec) は、ライン スタイル、マーカー記号、色を指定します。

stem(___,Name,Value) は、1 つ以上の Name,Value のペア引数を使用してステム グラフを変更します。

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

h = stem(___) は、Stem オブジェクトのベクトルを h に返します。h を使用して、ステム グラフを作成した後に変更を行います。

例

単一データ系列をプロット

$$-2\pi$$ ～ $$2\pi$$ の範囲にある 50 個のデータ値のステム プロットを作成します。

figure
Y = linspace(-2*pi,2*pi,50);
stem(Y)

データ値は、ベースラインから伸び、データ値で終了するステムとしてプロットされます。Y の長さによって、x 軸上の各ステムの位置が自動的に決定されます。

複数データ系列をプロット

2 列の行列を使って、2 つのデータ系列をプロットします。

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

Y の各列は個別の系列としてプロットされ、Y の同じ行のエントリは同じ x 値に対してプロットされます。Y の行数によって、x 軸上の各ステムの位置が自動的に生成されます。

指定した x 値に単一データ系列をプロット

0 ～ $$2\pi$$ で評価された 50 個のデータの余弦値をプロットし、ステム プロット用に一連の x 値を指定します。

figure
X = linspace(0,2*pi,50)';
Y = cos(X);
stem(X,Y)

最初のベクトル入力によって、x 軸上の各ステムの位置が決定されます。

指定した x 値に複数データ系列をプロット

0 ～ $$2\pi$$ で評価された 50 個のデータの正弦値と余弦値をプロットし、ステム プロット用に一連の x 値を指定します。

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

ベクトル入力によって、両方のデータ系列の x 軸の位置が決定されます。

一連の一意の x 値に複数データ系列をプロット

異なる x の一連の値に、評価された 50 個のデータの正弦値と余弦値をプロットします。系列ごとに対応する一連の x 値を指定します。

figure
x1 = linspace(0,2*pi,50)';
x2 = linspace(pi,3*pi,50)';
X = [x1, x2];
Y = [cos(x1), 0.5*sin(x2)];
stem(X,Y)

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

プロット マーカーの塗りつぶし

ステム プロットを作成し、各ステムの終点となる円を塗りつぶします。

X = linspace(0,10,20)';
Y = (exp(0.25*X));
stem(X,Y,'filled')

ステムおよびマーカー オプションの指定

ステム プロットを作成し、LineSpec オプションを使って、ライン スタイルを点線、マーカー記号を菱形、色を赤に設定します。

figure
X = linspace(0,2*pi,50)';
Y = (exp(X).*sin(X));
stem(X,Y,':diamondr')

菱形の内側に色を付けるには、'fill' オプションを使用します。

追加のステムおよびマーカー オプションの指定

ステム プロットを作成し、Name,Value ペアの引数を使って、ライン スタイルを一点鎖線、マーカー面の色を赤、マーカー エッジの色を緑に設定します。

figure
X = linspace(0,2*pi,25)';
Y = (cos(2*X));
stem(X,Y,'LineStyle','-.',...
     'MarkerFaceColor','red',...
     'MarkerEdgeColor','green')

ステムは、既定の色のままです。

ステム プロットの軸の指定

R2019b 以降、関数 tiledlayout および nexttile を使用して、プロットをタイル表示できます。関数 tiledlayout を呼び出して、2 行 1 列のタイル表示チャート レイアウトを作成します。関数 nexttile を呼び出して、axes オブジェクト ax1 および ax2 を作成します。axes オブジェクトを stem の最初の引数として指定することで、座標軸に個別のステム プロットを作成します。

x = 0:25;
y1 = exp(0.1*x); 
y2 = -exp(.05*x);
tiledlayout(2,1)

% Top plot
ax1 = nexttile;
stem(ax1,x,y1)

% Bottom plot
ax2 = nexttile;
stem(ax2,x,y2)

stem series の作成後の変更

3 次元ステム プロットを作成し、stem series オブジェクトを返します。

X = linspace(0,2);
Y = X.^3;
Z = exp(X).*cos(Y);
h = stem3(X,Y,Z,'filled');

色をマゼンタに、マーカー面の色を黄色に変更します。view を使って図の軸の角度を調節します。プロパティの設定にはドット表記を使用します。

h.Color = 'm';
h.MarkerFaceColor = 'y';
view(-10,35)

ベースライン プロパティの調節

ステム プロットを作成し、ベースラインのプロパティを変更します。

X = linspace(0,2*pi,50);
Y = exp(0.3*X).*sin(3*X);
h = stem(X,Y);

ベースラインのライン スタイルを変更します。プロパティの設定にはドット表記を使用します。

hbase = h.BaseLine; 
hbase.LineStyle = '--';

Visible プロパティを 'off' に設定してベースラインを非表示にします。

hbase.Visible = 'off';

ベースライン レベルの変更

ベースライン レベルが 2 のステム プロットを作成します。

X = linspace(0,2*pi,50)';
Y = (exp(0.3*X).*sin(3*X));
stem(X,Y,'BaseValue',2);

入力引数

Y — 表示するデータ列

ベクトルまたは行列

表示するデータ列。ベクトルまたは行列として指定します。Y がベクトルの場合、stem は Stem オブジェクトを 1 つ作成します。Y が行列の場合、stem は列ごとに別個の Stem オブジェクトを作成します。

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

X — Y のデータ値をプロットする位置

ベクトルまたは行列

Y のデータ値をプロットする位置。ベクトルまたは行列として指定します。Y がベクトルの場合、X は同じサイズのベクトルでなければなりません。Y が行列の場合、X は同じサイズの行列または長さが Y の行数と等しいベクトルでなければなりません。

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

LineSpec — ライン スタイル、マーカー、色

'-o' | 文字ベクトル | string

ライン スタイル、マーカーおよび色。記号を含む文字ベクトルまたは string として指定します。記号の順番は任意です。3 つの特性 (ライン スタイル、マーカーおよび色) をすべて指定する必要はありません。たとえば、色を省略してライン スタイルとマーカーを指定した場合、プロットでは既定の色が使用されます。

例: '--xr' は十字のマーカーをもつ赤の破線スタイルです。

ライン スタイル	説明
-	実線
--	破線
:	点線
-.	一点鎖線

マーカー	説明
o	円
+	プラス記号
*	アスタリスク
.	点
x	十字
s	正方形
d	菱形
^	上向き三角形
v	下向き三角形
>	右向き三角形
<	左向き三角形
p	星形五角形
h	星形六角形

色	説明
y	黄
m	マゼンタ
c	シアン
r	赤
g	緑
b	青
w	白
k	黒

ax — Axes オブジェクト

Axes オブジェクト

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

名前と値のペアの引数

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

例: 'LineStyle',':','MarkerFaceColor','red' は、点線でステムをプロットし、マーカー面の色を赤く色付けします。

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

'LineStyle' — ライン スタイル

'-' (既定値) | '--' | ':' | '-.' | 'none'

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

ライン スタイル	説明	結果として得られる線
'-'	実線
'--'	破線
':'	点線
'-.'	一点鎖線
'none'	ラインなし	ラインなし

'LineWidth' — ライン幅

0.5 (既定値) | 正の値

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

ライン幅をピクセルの幅より細くすることはできません。システムでライン幅をピクセルの幅より細い値に設定すると、ラインは 1 ピクセル幅で表示されます。

'Color' — ステムの色

[0 0 0] (既定値) | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

ステムの色。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'

'Marker' — マーカー記号

'o' (既定値) | '+' | '*' | '.' | 'x' | ...

マーカー記号。次の表に挙げるマーカーのいずれかとして指定します。

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

例: '+'

例: 'diamond'

'MarkerSize' — マーカー サイズ

6 (既定値) | 正の値

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

'MarkerEdgeColor' — マーカーの輪郭の色

'auto' (既定値) | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

マーカーの輪郭の色。'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'

'MarkerFaceColor' — マーカーの塗りつぶし色

'none' (既定値) | 'auto' | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

マーカーの塗りつぶし色。'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'

出力引数

h — Stem オブジェクト

Stem オブジェクト

Stem オブジェクト。特定の Stem オブジェクトの作成後に同オブジェクトのプロパティの変更に使用できる、一意の識別子です。

拡張機能

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

使用上の注意事項および制限事項:

• この関数は GPU 配列を受け入れますが、GPU 上では実行されません。

詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

使用上の注意事項および制限事項:

• この関数は分散配列に対して演算を行いますが、クライアントの MATLAB で実行されます。

詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

参考

関数

• bar | plot | stairs

プロパティ

• Stem のプロパティ

トピック

• ライン プロットとステム プロットの組み合わせ
• 日付と期間のプロット
• categorical データのプロット

R2006a より前に導入

×

例を開く

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

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