このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。
stem3
3 次元離散データ列のプロット

構文
説明
ベクトルと行列のデータ
stem3(___,
は、円を塗りつぶします。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。"filled"
)
テーブル データ
例
行ベクトル入力
行ベクトル入力を使用して ~ の余弦値の 3 次元ステム プロットを作成します。
figure X = linspace(-pi/2,pi/2,40); Z = cos(X); stem3(Z)
stem3
は等間隔に配置された x の値における同じ y 値に対して、Z
の要素をプロットします。
列ベクトル入力
列ベクトル入力を使用して ~ の余弦値の 3 次元ステム プロットを作成します。
figure X = linspace(-pi/2,pi/2,40)'; Z = cos(X); stem3(Z)
stem3
は等間隔に配置された y の値における同じ x 値に対して、Z
の要素をプロットします。
行列入力
行列入力を使用して ~ の正弦値と余弦値の 3 次元ステム プロットを作成します。
figure X = linspace(-pi/2,pi/2,40); Z = [sin(X); cos(X)]; stem3(Z)
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)
X
と Y
により、ステムの位置が決定します。Z
により、マーカーの高さが決定します。
行列入力を使ったステム位置の指定
行列データを使って 3 次元ステム プロットを作成し、xy 平面でのステムの位置を指定します。
figure [X,Y] = meshgrid(0:.1:1); Z = exp(X+Y); stem3(X,Y,Z)
X
と Y
により、ステムの位置が決定します。Z
により、マーカーの高さが決定します。
マーカーの塗りつぶし
~ の余弦値の 3 次元ステム プロットを作成し、マーカーを塗りつぶします。
X = linspace(-pi,pi,40);
Z = cos(X);
stem3(Z,'filled')
ライン スタイル、マーカー記号および色のオプション
~ の余弦値の 3 次元ステム プロットを作成します。ステムには破線のスタイルを使用し、マーカー記号を星、色をマゼンタに設定します。
figure
X = linspace(-pi,pi,40);
Z = cos(X);
stem3(Z,'--*m')
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')
X
と Y
により、ステムの位置が決定します。Z
により、マーカーの高さが決定します。
追加のスタイル オプション
~ の余弦値の 3 次元ステム プロットを作成します。マーカー記号を緑の面とマゼンタのエッジをもつ正方形に設定します。
figure X = linspace(-pi,pi,40); Z = cos(X); stem3(Z,'Marker','s',... 'MarkerEdgeColor','m',... 'MarkerFaceColor','g')
table のデータのプロット
R2022b 以降
table のデータをプロットするには、table を関数 stem3
に渡してプロット対象の変数を指定すると便利です。
weather.csv
を timetable tbl
として読み取ります。次に、table の最初の 3 行を表示します。
tbl = readtimetable("weather.csv");
head(tbl,3)
Time WindDirection WindSpeed Humidity Temperature RainInchesPerMinute CumulativeRainfall PressureHg PowerLevel LightIntensity ____________________ _____________ _________ ________ ___________ ___________________ __________________ __________ __________ ______________ 25-Oct-2021 00:00:09 46 1 84 49.2 0 0 29.96 4.14 0 25-Oct-2021 00:01:09 45 1.6 84 49.2 0 0 29.96 4.139 0 25-Oct-2021 00:02:09 36 2.2 84 49.2 0 0 29.96 4.138 0
変数 Time
を "x" 軸に、変数 Temperature
を "y" 軸に、そして変数 CumulativeRainfall
を "z" 軸にプロットします。Stem
オブジェクトを h
として返します。軸ラベルが table 変数名と一致することがわかります。
h = stem3(tbl,"Time","Temperature","CumulativeRainfall");
Color
プロパティを設定して、プロットの色を赤の色調に変更します。
h.Color = [0.7 0 0.2];
特定の座標軸におけるステム プロット
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)
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)
入力引数
Z
— 表示するデータ列
ベクトルまたは行列
表示するデータ列。ベクトルまたは行列として指定します。stem3
は xy 平面から伸び、データ値で終了するステムとして、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
| categorical
| datetime
| duration
X
— Z
の値をプロットする位置
ベクトルまたは行列
Z
の値をプロットする位置。ベクトルまたは行列として指定します。X
、Y
および Z
の入力は、同じサイズのベクトルまたは行列でなければなりません。
データ型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
| categorical
| datetime
| duration
Y
— Z
の値をプロットする位置
ベクトルまたは行列
Z
の値をプロットする位置。ベクトルまたは行列として指定します。X
、Y
および Z
の入力は、同じサイズのベクトルまたは行列でなければなりません。
データ型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
| categorical
| datetime
| duration
LineSpec
— ライン スタイル、マーカー、色
string | 文字ベクトル
ライン スタイル、マーカーおよび色。記号を含む string または文字ベクトルとして指定します。記号の順番は任意です。3 つの特性 (ライン スタイル、マーカーおよび色) をすべて指定する必要はありません。たとえば、ライン スタイルを省略してマーカーを指定する場合、プロットはラインなしでマーカーのみを表示します。
例: "--or"
は円形マーカー付きの赤い破線
ライン スタイル | 説明 | 結果として得られる線 |
---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
マーカー | 説明 | 結果のマーカー |
---|---|---|
"o" | 円 |
|
"+" | プラス記号 |
|
"*" | アスタリスク |
|
"." | 点 |
|
"x" | 十字 |
|
"_" | 水平線 |
|
"|" | 垂直線 |
|
"square" | 正方形 |
|
"diamond" | 菱形 |
|
"^" | 上向き三角形 |
|
"v" | 下向き三角形 |
|
">" | 右向き三角形 |
|
"<" | 左向き三角形 |
|
"pentagram" | 星形五角形 |
|
"hexagram" | 星形六角形 |
|
色名 | 省略名 | RGB 3 成分 | 外観 |
---|---|---|---|
"red" | "r" | [1 0 0] | |
"green" | "g" | [0 1 0] | |
"blue" | "b" | [0 0 1] | |
"cyan" | "c" | [0 1 1] | |
"magenta" | "m" | [1 0 1] | |
"yellow" | "y" | [1 1 0] | |
"black" | "k" | [0 0 0] | |
"white" | "w" | [1 1 1] | |
tbl
— ソース table
table | timetable
プロットするデータが含まれるソース table。table または timetable として指定します。
zvar
— z 座標を含む table 変数
string スカラー | 文字ベクトル | パターン | 数値スカラー | logical ベクトル | vartype()
z 座標を含む table 変数。表のインデックス方式のいずれかを使用して指定します。変数を 1 つのみ指定します。
インデックス方式 | 例 |
---|---|
変数名:
|
|
変数インデックス:
|
|
変数の型:
|
|
指定する table 変数は、数値、logical 値、categorical 値、datetime 値、または duration 値を含むことができます。
例: stem3(tbl,"x","y","z")
は、z 座標用に z
という名前の table 変数を指定します。
xvar
— x 座標を含む table 変数
string スカラー | 文字ベクトル | パターン | 数値スカラー | logical ベクトル | vartype()
x 座標を含む table 変数。表のインデックス方式のいずれかを使用して指定します。変数を 1 つのみ指定します。
インデックス方式 | 例 |
---|---|
変数名:
|
|
変数インデックス:
|
|
変数の型:
|
|
指定する table 変数は、数値、logical 値、categorical 値、datetime 値、または duration 値を含むことができます。
例: stem3(tbl,"x","y","z")
は、x 座標用に x
という名前の table 変数を指定します。
yvar
— y 座標を含む table 変数
string スカラー | 文字ベクトル | パターン | 数値スカラー | logical ベクトル | vartype()
y 座標を含む table 変数。表のインデックス方式のいずれかを使用して指定します。変数を 1 つのみ指定します。
インデックス方式 | 例 |
---|---|
変数名:
|
|
変数インデックス:
|
|
変数の型:
|
|
指定する table 変数は、数値、logical 値、categorical 値、datetime 値、または duration 値を含むことができます。
例: stem3(tbl,"x","y","z")
は、y 座標用に y
という名前の table 変数を指定します。
ax
— Axes
オブジェクト
Axes
オブジェクト
Axes
オブジェクト。座標軸を指定しない場合、stem
は現在の座標軸にプロットします。
名前と値の引数
引数のオプションのペアを Name1=Value1,...,NameN=ValueN
として指定します。ここで Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name
を引用符で囲みます。
例: "LineStyle",":","MarkerFaceColor","red"
は、点線でステムをプロットし、マーカーの面の色を赤に設定します。
ここでは、プロパティの一部だけを紹介しています。完全な一覧については、Stem のプロパティ を参照してください。
LineStyle
— ライン スタイル
"-"
(既定値) | "--"
| ":"
| "-."
| "none"
ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。
ライン スタイル | 説明 | 結果として得られる線 |
---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
LineWidth
— ステムとマーカー エッジのライン幅
0.5
(既定値) | 正の値
ステムとマーカー エッジのライン幅。ポイント単位の正の値として指定します。
例: 0.75
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" | 正方形 |
|
"diamond" | 菱形 |
|
"^" | 上向き三角形 |
|
"v" | 下向き三角形 |
|
">" | 右向き三角形 |
|
"<" | 左向き三角形 |
|
"pentagram" | 星形五角形 |
|
"hexagram" | 星形六角形 |
|
"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)を参照してください。
バージョン履歴
R2006a より前に導入R2022b: データ型のサポートの拡張
入力引数 x
、y
、および z
は、任意の数値、logical 値、datetime 値、duration 値、または categorical 値を取ることができます。以前のリリースでは、数値と logical 値のみがサポートされていました。
R2022b: table を直接 stem3
に渡す
table を関数 stem3
に渡し、その後にプロット対象の変数を渡すことで、プロットを作成します。データを table として指定すると、軸ラベルと凡例 (存在する場合) に table 変数名を使用して自動的にラベルが付けられます。
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)