Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

stem3

3 次元離散データ列のプロット

説明

stem3(Z)xy 平面から伸び、エントリ値の円で終了するステムとして Z のエントリをプロットします。xy 平面のステムの位置は自動的に生成されます。

stem3(X,Y,Z)xy 平面から伸びるステムとして Z のエントリをプロットします。ここで、XYxy 平面のステムの位置を指定します。XY および Z の入力は、同じサイズのベクトルまたは行列でなければなりません。

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

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

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

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

h = stem3(___) は、Stem オブジェクト h を返します。

すべて折りたたむ

行ベクトル入力を使用して -π/2π/2 の余弦値の 3 次元ステム プロットを作成します。

figure
X = linspace(-pi/2,pi/2,40);
Z = cos(X);
stem3(Z)

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

stem3 は等間隔に配置された x の値における同じ y 値に対して、Z の要素をプロットします。

列ベクトル入力を使用して -π/2π/2 の余弦値の 3 次元ステム プロットを作成します。

figure
X = linspace(-pi/2,pi/2,40)';
Z = cos(X);
stem3(Z)

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

stem3 は等間隔に配置された y の値における同じ x 値に対して、Z の要素をプロットします。

行列入力を使用して -π/2π/2 の正弦値と余弦値の 3 次元ステム プロットを作成します。

figure
X = linspace(-pi/2,pi/2,40);
Z = [sin(X); cos(X)];
stem3(Z)

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

stem3 は等間隔に配置された x の値における同じ y 値に対して、Z の各行をプロットします。

3 次元ステム プロットを作成し、曲線に沿ってステムの位置を指定します。view を使って図の軸の角度を調節します。

figure
X = linspace(-5,5,60);
Y = cos(X);
Z = X.^2;
stem3(X,Y,Z)
view(-8,30)

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

XY により、ステムの位置が決定します。Z により、マーカーの高さが決定します。

行列データを使って 3 次元ステム プロットを作成し、xy 平面でのステムの位置を指定します。

figure
[X,Y] = meshgrid(0:.1:1);
Z = exp(X+Y);
stem3(X,Y,Z)

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

XY により、ステムの位置が決定します。Z により、マーカーの高さが決定します。

-ππ の余弦値の 3 次元ステム プロットを作成し、マーカーを塗りつぶします。

X = linspace(-pi,pi,40);
Z = cos(X);
stem3(Z,'filled')

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

-ππ の余弦値の 3 次元ステム プロットを作成します。ステムには破線のスタイルを使用し、マーカー記号を星、色をマゼンタに設定します。

figure
X = linspace(-pi,pi,40);
Z = cos(X);
stem3(Z,'--*m')

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

3 つの LineSpec のオプションのうち 2 つだけを指定するには、文字ベクトルから 3 番目のオプションを省略します。たとえば、'*m' はマーカー記号と色を設定し、ライン スタイルは既定値を使用します。

3 次元ステム プロットを作成し、円に沿ってステムの位置を指定します。ステムを点線スタイル、マーカー記号を星、色をマゼンタに設定します。

figure
theta = linspace(0,2*pi);
X = cos(theta);
Y = sin(theta);
Z = theta;
stem3(X,Y,Z,':*m')

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

XY により、ステムの位置が決定します。Z により、マーカーの高さが決定します。

-ππ の余弦値の 3 次元ステム プロットを作成します。マーカー記号を緑の面とマゼンタのエッジをもつ正方形に設定します。

figure
X = linspace(-pi,pi,40);
Z = cos(X);
stem3(Z,'Marker','s',...
     'MarkerEdgeColor','m',...
     'MarkerFaceColor','g')

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

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

X = linspace(-2,2,50);
Y = X.^3;
Z = exp(X);
tiledlayout(2,1)

% Top plot
ax1 = nexttile;
stem(ax1,X,Z)

% Bottom plot
ax2 = nexttile;  
stem3(ax2,X,Y,Z)

Figure contains 2 axes. Axes 1 contains an object of type stem. Axes 2 contains an object of type stem.

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

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

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

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

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

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

入力引数

すべて折りたたむ

表示するデータ列。ベクトルまたは行列として指定します。stem3xy 平面から伸び、データ値で終了するステムとして、Z の各要素をプロットします。

  • Z が行ベクトルの場合、stem3 は、等間隔に配置された x の値における同じ y 値に対して、すべての要素をプロットします。

  • Z が列ベクトルの場合、stem3 は、等間隔に配置された y の値における同じ x 値に対して、すべての要素をプロットします。

  • Z が行列の場合、stem3 は、等間隔に配置された x の値における同じ y 値に対して、Z の各行をプロットします。

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

Z の値をプロットする位置。ベクトルまたは行列として指定します。XY および Z の入力は、同じサイズのベクトルまたは行列でなければなりません。

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

Z の値をプロットする位置。ベクトルまたは行列として指定します。XY および Z の入力は、同じサイズのベクトルまたは行列でなければなりません。

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

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

例: '--or' は丸いマーカーをもった赤い破線

ライン スタイル説明
-実線
--破線
:点線
-.一点鎖線
マーカー説明
'o'
'+'プラス記号
'*'アスタリスク
'.'
'x'十字
'_'水平線
'|'垂直線
's'正方形
'd'菱形
'^'上向き三角形
'v'下向き三角形
'>'右向き三角形
'<'左向き三角形
'p'星形五角形
'h'星形六角形
説明

y

m

マゼンタ

c

シアン

r

g

b

w

k

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

名前と値のペアの引数

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

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

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

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

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

'--'破線

':'点線

'-.'一点鎖線

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

ステムとマーカー エッジのライン幅。ポイント単位の正の値として指定します。

例: 0.75

ステムの色。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'マーカーなし

例: '+'

例: 'diamond'

マーカー サイズ。ポイント単位の正の値として指定します。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'

出力引数

すべて折りたたむ

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

拡張機能

R2006a より前に導入