stem3

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

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

構文

stem3(Z)

stem3(X,Y,Z)

stem3(___,"filled")

stem3(___,LineSpec)

stem3(tbl,xvar,yvar,zvar)

stem3(___,Name,Value)

stem3(ax,___)

h = stem3(___)

説明

ベクトルと行列のデータ

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

例

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

例

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

例

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

例

テーブルデータ

stem3(tbl,xvar,yvar,zvar) は、テーブル tbl の変数 xvar、yvar、および zvar をプロットします。各次元について、1 つの table 変数を指定します。 (R2022b 以降)

例

追加オプション

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 object. The axes object 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 object. The axes object 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 object. The axes object 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 object. The axes object contains an object of type stem.

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

行列入力を使ったステム位置の指定

ライブスクリプトを開く

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

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

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

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

マーカーの塗りつぶし

ライブスクリプトを開く

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

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

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

ラインスタイル、マーカー記号および色のオプション

ライブスクリプトを開く

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

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

Figure contains an axes object. The axes object 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 object. The axes object contains an object of type stem.

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

追加のスタイルオプション

ライブスクリプトを開く

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

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

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

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");

Figure contains an axes object. The axes object with xlabel Time, ylabel Temperature contains an object of type stem.

Color プロパティを設定して、プロットの色を赤の色調に変更します。

h.Color = [0.7 0 0.2];

Figure contains an axes object. The axes object with xlabel Time, ylabel Temperature contains an object of type stem.

特定の座標軸におけるステムプロット

ライブスクリプトを開く

関数 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 objects. Axes object 1 contains an object of type stem. Axes object 2 contains an object of type stem.

stem series の作成後の変更

ライブスクリプトを開く

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 object. The axes object contains an object of type stem.

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

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

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

入力引数

すべて折りたたむ

`Z` — 表示するデータ列
ベクトルまたは行列

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

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

`X` — `Z` の値をプロットする位置
ベクトルまたは行列

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

`Y` — `Z` の値をプロットする位置
ベクトルまたは行列

`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 つのみ指定します。

インデックス方式例

インデックス方式	例
変数名: string スカラーまたは文字ベクトル。 `pattern` オブジェクト。pattern オブジェクトは 1 つの変数のみを参照しなければなりません。	`"A"` または `'A'` — `A` という名前の変数 `"Var"+digitsPattern(1)` — `"Var"` の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の `0` 値や `false` 値は省略できます。	`3` — table の 3 番目の変数 `[false false true]` — 3 番目の変数
変数の型: 指定したタイプの table 変数を選択する `vartype` 添字。添字は 1 つの変数のみを参照しなければなりません。	`vartype("double")` — double 値を含んでいる変数

変数名:

string スカラーまたは文字ベクトル。
pattern オブジェクト。pattern オブジェクトは 1 つの変数のみを参照しなければなりません。

"A" または 'A' — A という名前の変数
"Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数

変数インデックス:

table 内の変数の位置を参照するインデックス番号。
logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。

3 — table の 3 番目の変数
[false false true] — 3 番目の変数

変数の型:

指定したタイプの table 変数を選択する vartype 添字。添字は 1 つの変数のみを参照しなければなりません。

vartype("double") — double 値を含んでいる変数

指定する table 変数は、数値、logical 値、categorical 値、datetime 値、または duration 値を含むことができます。

例: stem3(tbl,"x","y","z") は、z 座標用に z という名前の table 変数を指定します。

`xvar` — x 座標を含む table 変数
string スカラー | 文字ベクトル | パターン | 数値スカラー | logical ベクトル | `vartype()`

x 座標を含む table 変数。表のインデックス方式のいずれかを使用して指定します。変数を 1 つのみ指定します。

インデックス方式例

インデックス方式	例
変数名: string スカラーまたは文字ベクトル。 `pattern` オブジェクト。pattern オブジェクトは 1 つの変数のみを参照しなければなりません。	`"A"` または `'A'` — `A` という名前の変数 `"Var"+digitsPattern(1)` — `"Var"` の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の `0` 値や `false` 値は省略できます。	`3` — table の 3 番目の変数 `[false false true]` — 3 番目の変数
変数の型: 指定したタイプの table 変数を選択する `vartype` 添字。添字は 1 つの変数のみを参照しなければなりません。	`vartype("double")` — double 値を含んでいる変数

変数名:

string スカラーまたは文字ベクトル。
pattern オブジェクト。pattern オブジェクトは 1 つの変数のみを参照しなければなりません。

"A" または 'A' — A という名前の変数
"Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数

変数インデックス:

table 内の変数の位置を参照するインデックス番号。
logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。

3 — table の 3 番目の変数
[false false true] — 3 番目の変数

変数の型:

指定したタイプの table 変数を選択する vartype 添字。添字は 1 つの変数のみを参照しなければなりません。

vartype("double") — double 値を含んでいる変数

指定する table 変数は、数値、logical 値、categorical 値、datetime 値、または duration 値を含むことができます。

例: stem3(tbl,"x","y","z") は、x 座標用に x という名前の table 変数を指定します。

`yvar` — y 座標を含む table 変数
string スカラー | 文字ベクトル | パターン | 数値スカラー | logical ベクトル | `vartype()`

y 座標を含む table 変数。表のインデックス方式のいずれかを使用して指定します。変数を 1 つのみ指定します。

インデックス方式例

インデックス方式	例
変数名: string スカラーまたは文字ベクトル。 `pattern` オブジェクト。pattern オブジェクトは 1 つの変数のみを参照しなければなりません。	`"A"` または `'A'` — `A` という名前の変数 `"Var"+digitsPattern(1)` — `"Var"` の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の `0` 値や `false` 値は省略できます。	`3` — table の 3 番目の変数 `[false false true]` — 3 番目の変数
変数の型: 指定したタイプの table 変数を選択する `vartype` 添字。添字は 1 つの変数のみを参照しなければなりません。	`vartype("double")` — double 値を含んでいる変数

変数名:

string スカラーまたは文字ベクトル。
pattern オブジェクト。pattern オブジェクトは 1 つの変数のみを参照しなければなりません。

"A" または 'A' — A という名前の変数
"Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数

変数インデックス:

table 内の変数の位置を参照するインデックス番号。
logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。

3 — table の 3 番目の変数
[false false true] — 3 番目の変数

変数の型:

指定したタイプの table 変数を選択する vartype 添字。添字は 1 つの変数のみを参照しなければなりません。

vartype("double") — double 値を含んでいる変数

指定する 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"`	該当なし	該当なし	該当なし	色なし

次の表に、ライトテーマとダークテーマでのプロットの既定のカラーパレットを示します。

パレットパレットの色

パレット	パレットの色
`"gem"` — ライトテーマの既定値 R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。
`"glow"` — ダークテーマの既定値

"gem" — ライトテーマの既定値

R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。

Sample of the "gem" color palette

"glow" — ダークテーマの既定値

Sample of the "glow" color palette

orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラーコードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラーコードに変換します。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。

R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラーコードを取得します。

例: "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 進数カラーコード	外観
`"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"`	該当なし	該当なし	該当なし	色なし

次の表に、ライトテーマとダークテーマでのプロットの既定のカラーパレットを示します。

パレットパレットの色

パレット	パレットの色
`"gem"` — ライトテーマの既定値 R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。
`"glow"` — ダークテーマの既定値

"gem" — ライトテーマの既定値

R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。

Sample of the "gem" color palette

"glow" — ダークテーマの既定値

Sample of the "glow" color palette

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。

R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラーコードを取得します。

`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 進数カラーコード	外観
`"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"`	該当なし	該当なし	該当なし	色なし

次の表に、ライトテーマとダークテーマでのプロットの既定のカラーパレットを示します。

パレットパレットの色

パレット	パレットの色
`"gem"` — ライトテーマの既定値 R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。
`"glow"` — ダークテーマの既定値

"gem" — ライトテーマの既定値

R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。

Sample of the "gem" color palette

"glow" — ダークテーマの既定値

Sample of the "glow" color palette

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。

R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラーコードを取得します。

出力引数

すべて折りたたむ

`h` — `Stem` オブジェクト
`Stem`

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

拡張機能

すべて展開する

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

stem3 関数は 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 変数名を使用して自動的にラベルが付けられます。

stem3

構文

説明

ベクトルと行列のデータ

テーブル データ

追加オプション

例

行ベクトル入力

列ベクトル入力

行列入力

ベクトル入力を使ったステム位置の指定

行列入力を使ったステム位置の指定

マーカーの塗りつぶし

ライン スタイル、マーカー記号および色のオプション

ライン スタイル、マーカー記号および色のオプション

追加のスタイル オプション

table のデータのプロット

特定の座標軸におけるステム プロット

stem series の作成後の変更

入力引数

Z — 表示するデータ列 ベクトルまたは行列

X — Z の値をプロットする位置 ベクトルまたは行列

Y — Z の値をプロットする位置 ベクトルまたは行列

LineSpec — ライン スタイル、マーカー、色 string スカラー | 文字ベクトル

tbl — ソース table table | timetable

zvar — z 座標を含む table 変数 string スカラー | 文字ベクトル | パターン | 数値スカラー | logical ベクトル | vartype()

xvar — x 座標を含む table 変数 string スカラー | 文字ベクトル | パターン | 数値スカラー | logical ベクトル | vartype()

yvar — y 座標を含む table 変数 string スカラー | 文字ベクトル | パターン | 数値スカラー | logical ベクトル | vartype()

ax — Axes オブジェクト Axes オブジェクト

名前と値の引数

LineStyle — ライン スタイル "-" (既定値) | "--" | ":" | "-." | "none"

LineWidth — ステムとマーカー エッジのライン幅 0.5 (既定値) | 正の値

Color — ステムの色 [0 0 0] (既定値) | RGB 3 成分 | 16 進数カラー コード | "r" | "g" | "b" | ...

Marker — マーカー記号 "o" (既定値) | "+" | "*" | "." | "x" | ...

MarkerSize — マーカー サイズ 6 (既定値) | 正の値

MarkerEdgeColor — マーカーの輪郭の色 "auto" (既定値) | RGB 3 成分 | 16 進数カラー コード | "r" | "g" | "b" | ...

MarkerFaceColor — マーカーの塗りつぶし色 "none" (既定値) | "auto" | RGB 3 成分 | 16 進数カラー コード | "r" | "g" | "b" | ...

出力引数

h — Stem オブジェクト Stem

拡張機能

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

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

バージョン履歴

R2022b: データ型のサポートの拡張

R2022b: table を直接 stem3 に渡す

参考

関数

プロパティ

トピック

テーブルデータ

ラインスタイル、マーカー記号および色のオプション

ラインスタイル、マーカー記号および色のオプション

追加のスタイルオプション

特定の座標軸におけるステムプロット

`Z` — 表示するデータ列
ベクトルまたは行列

`X` — `Z` の値をプロットする位置
ベクトルまたは行列

`Y` — `Z` の値をプロットする位置
ベクトルまたは行列

`LineSpec` — ラインスタイル、マーカー、色
string スカラー | 文字ベクトル

`tbl` — ソース table
table | timetable

`zvar` — z 座標を含む table 変数
string スカラー | 文字ベクトル | パターン | 数値スカラー | logical ベクトル | `vartype()`

`xvar` — x 座標を含む table 変数
string スカラー | 文字ベクトル | パターン | 数値スカラー | logical ベクトル | `vartype()`

`yvar` — y 座標を含む table 変数
string スカラー | 文字ベクトル | パターン | 数値スカラー | logical ベクトル | `vartype()`

`ax` — `Axes` オブジェクト
`Axes` オブジェクト

`LineStyle` — ラインスタイル
`"-"` (既定値) | `"--"` | `":"` | `"-."` | `"none"`

`LineWidth` — ステムとマーカーエッジのライン幅
`0.5` (既定値) | 正の値

`Color` — ステムの色
`[0 0 0]` (既定値) | RGB 3 成分 | 16 進数カラーコード | `"r"` | `"g"` | `"b"` | ...

`Marker` — マーカー記号
`"o"` (既定値) | `"+"` | `"*"` | `"."` | `"x"` | ...

`MarkerSize` — マーカーサイズ
`6` (既定値) | 正の値

`MarkerEdgeColor` — マーカーの輪郭の色
`"auto"` (既定値) | RGB 3 成分 | 16 進数カラーコード | `"r"` | `"g"` | `"b"` | ...

`MarkerFaceColor` — マーカーの塗りつぶし色
`"none"` (既定値) | `"auto"` | RGB 3 成分 | 16 進数カラーコード | `"r"` | `"g"` | `"b"` | ...

`h` — `Stem` オブジェクト
`Stem`

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

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

R2022b: table を直接 `stem3` に渡す