area
2 次元プロットの面積の塗りつぶし
説明
area( は、暗黙的な x 座標のセットに対して Y)Y をプロットし、曲線間の領域を塗りつぶします。
Yがベクトルの場合、x 座標は 1 からlength(Y)までの範囲となります。Yが行列の場合、x 座標の範囲は、1 からYの行数までです。
area(___, には、面積プロットのベースライン値を指定します。basevalue)basevalue は水平ベースラインに対応します。area は、曲線とこのライン間に拘束された領域を塗りつぶします。前述のいずれかの構文で、最後の引数として basevalue を指定します。
area(___, は、1 つ以上の名前と値のペアの引数を使用して面積プロットのプロパティを変更します。プロパティは、表示されているすべての領域に適用されます。たとえば、Name,Value)'LineStyle','--' ではプロットの破線のライン スタイルを指定します。前述のいずれかの構文で、すべての引数の後に名前と値のペアを指定します。プロパティの一覧については、Area のプロパティ を参照してください。
a = area(___) は、1 つ以上の Area オブジェクトを返します。オブジェクトの数は、プロットされた領域の数と同じです。領域のプロパティを作成した後に変更するには a を使用します。プロパティの一覧については、Area のプロパティ を参照してください。
例
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;
行列 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)
入力引数
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。
例: area([1 2 3],'FaceColor','r') は、赤の領域の塗りつぶし色を指定します。
メモ
ここには一部のプロパティのみを示します。完全な一覧については、Area のプロパティ を参照してください。
領域の塗りつぶし色。RGB 3 成分、16 進数カラー コード、色名、または 'flat' として指定します。
R2017b から、この既定値は座標軸の ColorOrder プロパティの RGB 3 成分です。以前のリリースにおいて、この既定値は '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" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
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 進数カラー コードを取得します。
領域の外枠の色。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" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
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 進数カラー コードを取得します。
ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。
| ライン スタイル | 説明 | 結果として得られる線 |
|---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
領域の外枠の幅。ポイント単位のスカラー数値として指定します。1 ポイントは 1/72 インチです。
例: 1.5
データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
ヒント
areaは、座標軸のColorOrderプロパティに基づいて色を使用します。すべての色を切り替えた後、色の数より多くの塗りつぶし領域をプロットする場合は、サイクルを繰り返します。R2019b 以降、座標軸の
ColorOrderプロパティを設定することによって、プロット後に色を変更できます。また、関数colororderを呼び出して、Figure 内のすべての座標軸の色の順序を変更することもできます。
拡張機能
バージョン履歴
R2006a より前に導入
