area

2 次元プロットの面積の塗りつぶし

• 

構文

area(X,Y)

area(Y)

area(___,basevalue)

area(tbl,xvar,yvar)

area(tbl,yvar)

area(___,Name=Value)

area(ax,___)

a = area(___)

説明

ベクトルと行列のデータ

area(X,Y) は、x 座標の X に対する Y の値をプロットします。次に、この関数は Y の形状に基づいて曲線間の領域を塗りつぶします。

• Y がベクトルの場合、プロットには 1 つの曲線が含まれます。area は、曲線と水平軸間の領域を塗りつぶします。

• Y が行列の場合、プロットには Y の列ごとに 1 つの曲線が含まれます。area は曲線間の領域を塗りつぶしてそれらをスタックし、各 x 座標の高さの合計に対する各行要素の相対的な寄与を示します。

area(Y) は、暗黙的な x 座標のセットに対して Y をプロットし、曲線間の領域を塗りつぶします。

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

• Y が行列の場合、x 座標の範囲は、1 から Y の行数までです。

area(___,basevalue) には、面積プロットのベースライン値を指定します。basevalue は水平ベースラインに対応します。area は、曲線とこのライン間に拘束された領域を塗りつぶします。前述のいずれかの構文で、最後の引数として basevalue を指定します。

テーブル データ

area(tbl,xvar,yvar) は、table tbl の変数 xvar および yvar をプロットします。1 つの曲線をプロットするには、xvar と yvar にそれぞれ 1 つの変数を指定します。複数の曲線をプロットするには、xvar、yvar、またはその両方に複数の変数を指定します。両方の引数に複数の変数を指定する場合は、同数の変数を指定しなければなりません。 (R2026a 以降)

area(tbl,yvar) は、table tbl の変数 yvar をプロットします。table が timetable の場合、yvar は timetable の行時間に対してプロットされます。 (R2026a 以降)

追加オプション

area(___,Name=Value) は、1 つ以上の名前と値のペアの引数を使用して面積プロットのプロパティを変更します。プロパティは、表示されているすべての領域に適用されます。たとえば、area(X,Y,LineStyle="--") はプロットに破線のライン スタイルを指定します。前述の任意の構文で、すべての引数の後に名前と値の引数を指定します。プロパティの一覧については、Area のプロパティ を参照してください。

area(ax,___) は、ターゲット座標軸に面積プロットを表示します。前述の任意の構文で、最初の引数として座標軸を指定します。

a = area(___) は、1 つ以上の Area オブジェクトを返します。オブジェクトの数は、プロットされた領域の数と同じです。領域のプロパティを作成した後に変更するには a を使用します。プロパティの一覧については、Area のプロパティ を参照してください。

例

1 つの曲線をもつ面積プロットの作成

4 つの値のベクトルを作成します。面積プロットに値を表示します。

y = [1 5 6 3];
area(y)

複数の曲線をもつ面積プロットの作成

行列 Y を作成します。面積プロットとして Y に値を表示します。Y に 3 つの列があるため、area は 3 つの曲線をプロットし、それらをスタックします。

Y = [1 5 3; 3 2 7; 1 5 3; 2 6 1];
area(Y)

水平軸の値を使用した面積プロットの作成

x を 3 つのカーディーラー ID のベクトルとして定義します。Y をモデルあたりの自動車の販売台数を含む行列として定義します。面積プロットの行列に値を表示します。次に、軸ラベルと凡例を追加します。

x = [10 11 12];
Y = [21.6 25.4; 70.8 66.1; 58.0 43.6];
area(x,Y)
xlabel('Dealership ID')
ylabel('Sales')
legend({'Model A','Model B'})

x 軸の目盛り間隔が x の値になるように設定します。

ax = gca; % current axes
ax.XTick = x;

table を使用した面積プロットの作成

R2026a 以降

4 つの変数をもつ table を作成し、変数をプロットします。次に、凡例を追加します。既定では、"x" 軸ラベルと凡例に変数名が表示されます。

Distance = (1:5)';
SensorA = [6; 4; 5; 1; 2];
SensorB = SensorA + 2;
SensorC = SensorA + 3;
tbl = table(Distance,SensorA,SensorB,SensorC);
area(tbl,"Distance",["SensorA","SensorB","SensorC"]);
legend

面積プロットのベースライン値の調整

行列 Y を作成します。ベースライン値を -4 として面積プロットで Y の値を表示します。area は曲線とライン y = -4 で指定された領域を塗りつぶします。

Y = [1 5 3; 3 2 7; 1 5 3; 2 6 1];
basevalue = -4;
area(Y,basevalue)

面積プロットのライン スタイルの指定

行列 Y を作成します。点線スタイルを使用する面積プロットで Y の値を表示します。

Y = [1 3 5; 3 2 7; 3 4 2];
area(Y,'LineStyle',':')

塗りつぶされた領域をターゲット座標軸にプロット

タイル表示チャート レイアウトを 'flow' タイル配置に作成して、座標軸がそのレイアウトの使用可能なスペースを塗りつぶすようにします。次に、関数 nexttile を呼び出して Axes オブジェクトを作成し、それを ax1 として返します。ax1 を関数 area に渡して面積プロットを表示します。

tiledlayout('flow')
ax1 = nexttile;
Y1 = [3 6; 1 5; 7 2; 5 9];
area(ax1,Y1)

このプロセスを繰り返して 2 番目の Axes オブジェクトと 2 番目の面積プロットを作成します。

ax2 = nexttile;
Y2 = [4 2 11; 5 6 0; 1 7 2; 9 5 9];
area(ax2,Y2)

プロット後の領域の特性の変更

行列 Y を作成します。次に、面積プロットを作成し、関数 area を呼び出すときに出力引数を指定します。この場合、area は 3 つの Area オブジェクトのベクトルを返します。オブジェクトはそれぞれ Y の別の列に対応します。

Y = [2 3 4; 6 1 5; 7 4 9];
a = area(Y);

2 番目の領域を、太い赤の縁取りをもつ緑に変更します。

a(2).FaceColor = [0.2 0.6 0.5];
a(2).EdgeColor = [0.63 0.08 0.18];
a(2).LineWidth = 2;

面積プロットの色の設定

3 つの曲線をもつ面積プロットを表示します。

area([1 5 3; 3 2 7; 1 5 3; 2 6 1])

色の順序を、青、紫、グレーに設定します。

newcolors = [0 0.5 1; 0.5 0 1; 0.7 0.7 0.7];
colororder(newcolors)

入力引数

X — x 座標

ベクトル | 行列

x 座標。ベクトルまたは行列として指定します。X のサイズと形状は、データの形状と作成するプロットのタイプによって異なります。次の表では、最も一般的な状況について説明します。

プロットのタイプ	座標の指定方法
単一の領域	X および Y を同じ長さの行ベクトルまたは列ベクトルの任意の組み合わせとして指定します。以下に例を示します。 area([1 3 5],[9; 4; 6]) X は、増加する値からなるベクトルとして指定します。X の値が増加していない場合、area はプロットする前に値を並べ替えます。
スタックされた領域	area は、Y の列ごとに 1 つの塗りつぶされた領域をプロットし、領域をスタックします。Y を行列として指定し、X を Y の行数と同じ長さの行または列ベクトルとして指定します。以下に例を示します。 area([1 2 3 4],[3 6; 1 5; 7 2; 5 9]) X の値が増加していない場合、area はプロットする前に値を並べ替えます。 X を Y と同じサイズの行列として指定することもできます。X が行列の場合に想定外の出力を避けるには、同じ列をもつ X を指定します。

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

Y — y 座標

ベクトル | 行列

y 座標。ベクトルまたは行列として指定します。Y のサイズと形状は、データの形状と作成するプロットのタイプによって異なります。次の表で、考えられる状況を説明します。

プロットのタイプ	座標の指定方法
単一の領域	X および Y を同じ長さの行ベクトルまたは列ベクトルの任意の組み合わせとして指定します。以下に例を示します。 area([1 3 5],[9; 4; 6]) X は、増加する値からなるベクトルとして指定します。X の値が増加していない場合、area はプロットする前に値を並べ替えます。
スタックされた領域	area は、Y の列ごとに 1 つの塗りつぶされた領域をプロットし、領域をスタックします。Y を行列として指定し、X を Y の行数と同じ長さの行または列ベクトルとして指定します。以下に例を示します。 area([1 2 3 4],[3 6; 1 5; 7 2; 5 9]) X の値が増加していない場合、area はプロットする前に値を並べ替えます。 X を Y と同じサイズの行列として指定することもできます。X が行列の場合に想定外の出力を避けるには、同じ列をもつ X を指定します。

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

basevalue — ベースライン値

0 (既定値) | 数値スカラー

ベースライン値。数値スカラーとして指定します。ベースライン値は、水平ベースラインの y 座標を指定します。area は、データ曲線とこのベースラインの間に拘束された領域を塗りつぶします。

tbl — ソース table

table | timetable

プロットするデータが含まれるソース table。table または timetable として指定します。

xvar — x 座標を含む table 変数

string 配列 | 文字ベクトル | cell 配列 | パターン | 数値スカラーまたはベクトル | logical ベクトル | vartype 添字

x 座標を含む table 変数。table のインデックス方式の 1 つを使用して指定します。指定する table 変数には、数値、categorical 値、datetime 値、または duration 値を含めることができます。xvar と yvar の両方が複数の変数を指定する場合、変数の数は同じでなければなりません。

インデックス方式	例
変数名: string 配列、文字ベクトル、または cell 配列。 pattern オブジェクト。	"A" または 'A' — A という名前の変数 ["A","B"] または {'A','B'} — A および B という名前の 2 つの変数 "Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。 数値のベクトル。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。	3 — table の 3 番目の変数 [2 3] — table の 2 番目と 3 番目の変数 [false false true] — 3 番目の変数
変数の型: 指定した型の変数を選択する vartype 添字。	vartype("categorical") — categorical 値を含んでいるすべての変数

例: area(tbl,["x1","x2"],"y") は、x 座標用に x1 および x2 という名前の table 変数を指定し、y 座標用に y という名前の変数を指定します。

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

例: area(tbl,vartype("numeric"),"y") は、x 座標用にすべての数値変数を指定し、y 座標用に y という名前の変数を指定します。

yvar — y 座標を含む table 変数

string 配列 | 文字ベクトル | cell 配列 | パターン | 数値スカラーまたはベクトル | logical ベクトル | vartype 添字

y 座標を含む table 変数。table のインデックス方式の 1 つを使用して指定します。指定する table 変数には、数値または duration 値を含めることができます。xvar と yvar の両方が複数の変数を指定する場合、変数の数は同じでなければなりません。

インデックス方式	例
変数名: string 配列、文字ベクトル、または cell 配列。 pattern オブジェクト。	"A" または 'A' — A という名前の変数 ["A","B"] または {'A','B'} — A および B という名前の 2 つの変数 "Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。 数値のベクトル。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。	3 — table の 3 番目の変数 [2 3] — table の 2 番目と 3 番目の変数 [false false true] — 3 番目の変数
変数の型: 指定した型の変数を選択する vartype 添字。	vartype("categorical") — categorical 値を含んでいるすべての変数

例: area(tbl,"x",["y1","y2"]) は、x 座標用に x という名前の table 変数を指定し、y 座標用に y1 および y2 という名前の変数を指定します。

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

例: area(tbl,"x",vartype("numeric")) は、x 座標用に x という名前の table 変数を指定し、y 座標用にすべての数値変数を指定します。

ax — ターゲット座標軸

Axes オブジェクト

ターゲット座標軸。Axes オブジェクトとして指定します。座標軸を指定しない場合、area は現在の座標軸にプロッを表示します。

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

例: area([1 2 3],FaceColor="red") は、面積プロットに赤の塗りつぶし色を指定します。

メモ

ここには一部のプロパティのみを示します。完全な一覧については、Area のプロパティ を参照してください。

FaceColor — 領域の塗りつぶし色

RGB 3 成分 | 16 進数カラー コード | "r" | "g" | "b" | "flat" | ...

領域の塗りつぶし色。RGB 3 成分、16 進数カラー コード、色名、または "flat" として指定します。

カスタム色を使用する場合は、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" — ダーク テーマの既定値

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

EdgeColor — 領域の外枠の色

RGB 3 成分 | "r" | "g" | "b" | "flat" | ...

領域の外枠の色。RGB 3 成分、16 進数カラー コード、色名、または "flat" として指定します。このプロパティを "flat" として指定する場合は、カラーマップの色を使用します。

カスタム色を使用する場合は、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" — ダーク テーマの既定値

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

LineStyle — ライン スタイル

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

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

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

LineWidth — 領域の外枠の幅

0.5 (既定値) | スカラー数値

領域の外枠の幅。ポイント単位のスカラー数値として指定します。1 ポイントは 1/72 インチです。

例: 1.5

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

ヒント

• area は、座標軸の ColorOrder プロパティに基づいて色を使用します。すべての色を切り替えた後、色の数より多くの塗りつぶし領域をプロットする場合は、サイクルを繰り返します。

  座標軸の ColorOrder プロパティを設定することによって、プロット後に色を変更できます。また、関数 colororder を呼び出して、Figure 内のすべての座標軸の色の順序を変更することもできます。

拡張機能

GPU 配列

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

area 関数は GPU 配列入力をサポートしますが、次の使用上の注意および制限があります。

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

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

分散配列

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

area 関数は分散配列をサポートしますが、次の使用上の注意および制限があります。

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

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

バージョン履歴

R2006a より前に導入

R2026a: table を直接 area に渡す

table を area 関数に渡し、その後にプロット対象の変数を渡すことで、面積プロットを作成します。データを table として指定すると、軸ラベルと凡例 (存在する場合) に table 変数の名前が自動的に表示されます。

参考

関数

• bar | plot

プロパティ

• Area のプロパティ

トピック

• 面積グラフの重ね合わせによるデータ セットの比較
• categorical データのプロット
• 日付と時刻のプロット