StackedLineProperties のプロパティ

積み上げプロットにおける個々のラインの外観と動作

このページをすべて展開する

StackedLineProperties プロパティは、"積み上げプロット" の個々のラインの外観と動作を制御します。積み上げプロットでは、table または timetable の変数、または行列の列を、個別の y 軸にプロットし、垂直に積み上げることができます。プロパティの値を変更することによって、積み上げプロットの特定の要素を変更できます。

関数 stackedplot は StackedLineChart オブジェクトを返します。これにより、このオブジェクトには LineProperties という名前の StackedLineProperties オブジェクトの配列があります。個々のラインのプロパティを設定するには、LineProperties にインデックスを付けて対応するオブジェクトのプロパティにアクセスします。

プロパティのクエリと設定にドット表記を使用できます。たとえば、その PlotType プロパティを使用して 3 番目のプロットを散布図に変更します。

T = readtable("outages.csv");
s = stackedplot(T);
c = s.LineProperties(3).PlotType
s.LineProperties(3).PlotType = "scatter";

複数のラインを 1 本の "y" 軸でプロットする場合、その "y" 軸でラインごとに異なるライン プロパティの値を指定できます。たとえば、積み上げプロットの 1 本目の "y" 軸で 1 つの table 変数をプロットし、2 本目の "y" 軸で 2 つの table 変数をプロットします。2 本目の "y" 軸で、s.LineProperties(2).PlotType を string 配列として指定してラインごとに異なるプロット タイプを指定します。

T = array2table(magic(9));
s = stackedplot(T,{"Var1",["Var2" "Var3"]});
s.LineProperties(1).PlotType = "stairs";
s.LineProperties(2).PlotType = ["scatter","plot"];

ラインのプロパティ

すべて展開する

ラインの色。RGB 3 成分、RGB 3 成分の 3 列の行列、16 進数カラー コード、または 1 番目の表にリストされている色のオプションのいずれかとして指定します。

カスタム色を使用する場合は、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"

Sample of the color red

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

Sample of the color green

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

Sample of the color blue

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

Sample of the color cyan

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

Sample of the color magenta

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

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"該当なし該当なし該当なし色なし

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

パレットパレットの色

"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 進数カラー コードを取得します。

メモ: 複数のラインを 1 本の "y" 軸でプロットする場合、ラインごとに異なる色を指定する RGB 3 成分の 3 列の行列として Color を指定できます。たとえば、"y" 軸に 2 本のラインがある場合、Color を [1 0 0] (両方のラインを赤にする場合) または [1 0 0; 0 0 1] (1 本目のラインを赤にして 2 本目のラインを青にする場合) のように指定できます。

例: s.LineProperties(1).Color = "blue";

例: s.LineProperties(2).Color = [0 0 1];

例: s.LineProperties(3).Color = "#0000FF";

例: s.LineProperties(4).Color = [1 0 0; 0 0 1]; (4 本目の "y" 軸に 2 本のラインがある場合)。

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

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

Sample of solid line

"--"破線

Sample of dashed line

":"点線

Sample of dotted line

"-."一点鎖線

Sample of dash-dotted line, with alternating dashes and dots

"none"ラインなしラインなし

メモ: 複数のラインを 1 本の "y" 軸でプロットする場合、ラインごとに異なるオプションを指定する string 配列または文字ベクトルの cell 配列として LineStyle を指定できます。

例: s.LineProperties(1).LineStyle = "-";

例: s.LineProperties(3).LineStyle = ["-",":"]; (3 本目の "y" 軸に 2 本のラインがある場合)。

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

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

メモ: 複数のラインを 1 本の "y" 軸でプロットする場合、ラインごとに異なる幅を指定するベクトルとして LineWidth を指定できます。

例: s.LineProperties(1).LineWidth = 1.0;

例: s.LineProperties(3).LineWidth = [1.5 3.0]; (3 本目の "y" 軸に 2 本のラインがある場合)。

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

マーカー説明結果のマーカー
"o"円

Sample of circle marker

"+"プラス記号

Sample of plus sign marker

"*"アスタリスク

Sample of asterisk marker

"."点

Sample of point marker

"x"十字

Sample of cross marker

"_"水平線

Sample of horizontal line marker

"|"垂直線

Sample of vertical line marker

"square"正方形

Sample of square marker

"diamond"菱形

Sample of diamond marker

"^"上向き三角形

Sample of upward-pointing triangle marker

"v"下向き三角形

Sample of downward-pointing triangle marker

">"右向き三角形

Sample of right-pointing triangle marker

"<"左向き三角形

Sample of left-pointing triangle marker

"pentagram"星形五角形

Sample of pentagram marker

"hexagram"星形六角形

Sample of hexagram marker

"none"マーカーなし該当なし

メモ: 複数のラインを 1 本の "y" 軸でプロットする場合、ラインごとに異なるマーカーを指定する string 配列または文字ベクトルの cell 配列として Marker を指定できます。

例: s.LineProperties(1).Marker = "+";

例: s.LineProperties(3).Marker = ["^","v"]; (3 本目の "y" 軸に 2 本のラインがある場合)。

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

メモ: 複数のラインを 1 本の "y" 軸でプロットする場合、ラインごとに異なるマーカー サイズを指定する正の値のベクトルとして MarkerSize を指定できます。

例: s.LineProperties(1).MarkerSize = 3.0;

例: s.LineProperties(3).MarkerSize = [10 16]; (3 本目の "y" 軸に 2 本のラインがある場合)。

マーカーの輪郭の色。"none"、RGB 3 成分、16 進数カラー コード、または 1 番目の表にリストされている色のオプションのいずれかとして指定します。

カスタム色を使用する場合は、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"

Sample of the color red

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

Sample of the color green

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

Sample of the color blue

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

Sample of the color cyan

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

Sample of the color magenta

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

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"該当なし該当なし該当なし色なし

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

パレットパレットの色

"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 進数カラー コードを取得します。

メモ: 複数のラインを 1 本の "y" 軸でプロットする場合、ラインごとに異なるマーカーの輪郭の色を指定する RGB 3 成分の 3 列の行列として MarkerEdgeColor を指定できます。たとえば、"y" 軸に 2 本のラインがある場合、MarkerEdgeColor を [1 0 0] (両方のラインのマーカーを赤の輪郭にする場合) または [1 0 0; 0 0 1] (1 本目のラインのマーカーを赤の輪郭にして 2 本目のラインのマーカーを青の輪郭にする場合) のように指定できます。

例: s.LineProperties(1).MarkerEdgeColor = "blue";

例: s.LineProperties(2).MarkerEdgeColor = [0 0 1];

例: s.LineProperties(3).MarkerEdgeColor = "#0000FF";

例: s.LineProperties(4).MarkerEdgeColor = [1 0 0; 0 0 1]; (4 本目の "y" 軸に 2 本のラインがある場合)。

マーカーの塗りつぶし色。"none"、RGB 3 成分、16 進数カラー コード、または 1 番目の表にリストされている色のオプションのいずれかとして指定します。

カスタム色を使用する場合は、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"

Sample of the color red

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

Sample of the color green

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

Sample of the color blue

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

Sample of the color cyan

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

Sample of the color magenta

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

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"該当なし該当なし該当なし色なし

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

パレットパレットの色

"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 進数カラー コードを取得します。

メモ: 複数のラインを 1 本の "y" 軸でプロットする場合、ラインごとに異なるマーカーの塗りつぶし色を指定する RGB 3 成分の 3 列の行列として MarkerFaceColor を指定できます。たとえば、"y" 軸に 2 本のラインがある場合、MarkerFaceColor を [1 0 0] (両方のラインのマーカーを赤で塗りつぶす場合) または [1 0 0; 0 0 1] (1 本目のラインのマーカーを赤で塗りつぶして 2 本目のラインのマーカーを青で塗りつぶす場合) のように指定できます。

例: s.LineProperties(1).MarkerFaceColor = "blue";

例: s.LineProperties(2).MarkerFaceColor = [0 0 1];

例: s.LineProperties(3).MarkerFaceColor = "#0000FF";

例: s.LineProperties(4).MarkerFaceColor = [1 0 0; 0 0 1]; (4 本目の "y" 軸に 2 本のラインがある場合)。

プロット タイプ。"plot"、"stairs"、"scatter"、あるいは string 配列または文字ベクトルの cell 配列として指定します。

複数のラインを 1 本の "y" 軸でプロットする場合、PlotType を string 配列または文字ベクトルの cell 配列として指定してラインごとに異なるプロット タイプを指定できます。

例: s.LineProperties(1).PlotType = "scatter";

例: s.LineProperties(3).PlotType = ["scatter","stairs"]; (3 本目の "y" 軸に 2 本のラインがある場合)。

バージョン履歴

R2018b で導入

参考

関数

プロパティ

トピック