最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

thingSpeakArea

2 次元プロットの塗りつぶし領域

構文

thingSpeakArea(X,Y)

thingSpeakArea(X,Y,S)

thingSpeakArea(Y)

thingSpeakArea(X,Y,Name,Value)

説明

thingSpeakArea(X,Y) は、積み上げ領域プロットを出力します。これは、さまざまなコンポーネントの全体に対する割合を表すのに適しています。

thingSpeakArea(X,Y,S) は S パラメーターを使用して、ラインのタイプ、ラインの色、およびラインのシンボルも指定します。

thingSpeakArea(Y) は、Y をプロットするか、行列 Y の各列を別個の曲線としてプロットし、それらの曲線を積み上げます。X 軸は、X = 1:size(Y,1) に合わせて自動的にスケーリングされます。

thingSpeakArea(X,Y,Name,Value) は、1 つ以上の Name,Value のペアの引数によって指定された追加オプションを使用します。

例

領域プロットの作成

行列 Y のデータを面積グラフとしてプロットします。

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

ライン スタイルと幅の指定

点線とライン幅 2.5 を使用して領域プロットを作成します。

Y = [1,5,3;3,2,7;1,5,3;2,6,1];
thingSpeakArea(Y,'LineStyle','-.','LineWidth',2.5)

領域プロットのタイトルの指定

タイトルをもつ領域プロットを作成します。

Y = [1,5,3;3,2,7;1,5,3;2,6,1];
thingSpeakArea(Y,'Title','This Is My Area Plot');

入力引数

X — X 値

ベクトル | スカラー | 行列

X 値。スカラー、ベクトル、または行列として指定します。X は数値配列、logical 配列、または datetime 配列にすることができます。

Y — Y 値

ベクトル | スカラー | 行列

Y 値。スカラー、ベクトル、または行列として指定します。Y は数値配列、datetime 配列、または logical 配列にすることができます。

S — ライン タイプ、色、記号

文字列

ライン タイプ、色、記号。文字列として指定します。S は複数の文字からなる文字列で、以下の各列から 1 つまでを選択したものです。

色文字列	色	記号文字列	記号	ライン文字列	ライン スタイル
b	青	.	点	-	実線
g	緑	0	円	:	点線
r	赤	x	X 印	-.	鎖線
c	シアン	+	プラス	- -	破線
m	マゼンタ	*	星	(なし)	ラインなし
y	黄色	s	正方形
k	黒	d	菱形
w	白	v	三角形 (上)
		^	三角形 (下)
		<	三角形 (左)
		>	三角形 (右)
		p	星形五角形
		h	星形六角形

例: thingSpeakArea(X,Y,'c+:') は各データ点をプラス記号にしたシアン色の点線をプロットします。

例: thingSpeakArea(X,Y,'bd') は青色の菱形を各データ点にプロットしますが、接続するラインは描画しません。

名前と値のペアの引数

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

例:

'FaceColor' — 領域の面の色

'flat' (既定値) | RGB 3 成分ベクトル | 色文字列 | 'none'

領域の面の色。次の値のいずれかとして指定します。

• 'none' — 外枠を描画しません。

• 'flat' — 座標軸のカラーマップの色を使用します。

• RGB 3 成分ベクトルまたは色文字列 — カスタム色を指定します。RGB 3 成分の値 [0 0 0] は、黒に相当します。

RGB 3 成分は、各要素が色の赤、緑、青の成分の強度を指定する 3 要素の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。次の表に、等価な色文字列をもつ RGB 3 成分の値を示します。

完全名	省略名	RGB 3 成分
'yellow'	'y'	[1 1 0]
'magenta'	'm'	[1 0 1]
'cyan'	'c'	[0 1 1]
'red'	'r'	[1 0 0]
'green'	'g'	[0 1 0]
'blue'	'b'	[0 0 1]
'white'	'w'	[1 1 1]
'black'	'k'	[0 0 0]

例: 'blue'

例: [0 0 1]

'EdgeColor' — 領域の外枠の色

[0 0 0] (既定値) | RGB 3 成分 | 色文字列 | 'none' | 'flat'

領域の外枠の色。次の値のいずれかとして指定します。

• 'none' — 外枠を描画しません。

• 'flat' — 座標軸のカラーマップの色を使用します。

• RGB 3 成分または色文字列 — カスタム色を指定します。既定の RGB 3 成分の値 [0 0 0] は、黒に相当します。

RGB 3 成分は、各要素が色の赤、緑、青の成分の強度を指定する 3 要素の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

例: 'blue'

例: [0 0 1]

'LineStyle' — ライン スタイル

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

ライン スタイル。次の表にリストされているライン スタイル文字列のいずれかとして指定します。

文字列	ライン スタイル	結果として得られる線
'-'	実線
'--'	破線
':'	点線
'-.'	一点鎖線
'none'	ラインなし	ラインなし

'LineWidth' — 領域の外枠の幅

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

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

例: 1.5

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

'YLabel' — Y 軸ラベル

文字列

Y 軸ラベル。文字列として指定します。

例: thingSpeakArea(1:10,'YLabel','Y-Axis');

'XLabel' — X 軸ラベル

文字列

Y 軸ラベル。文字列として指定します。

例: thingSpeakArea(1:10,'XLabel','X-Axis');

'Title' — プロットのタイトル

文字列

プロットのタイトル。文字列として指定します。

例: thingSpeakArea(1:10,'Title','Plot Title');

'Grid' — グリッドの指定

'off' (既定値) | 'on'

領域プロットにグリッドを表示するかどうかを指定します。グリッドを表示するには値を 'on' に設定します。

'XGrid' — X 軸グリッドを指定

'off' (既定値) | 'on'

領域プロットでグリッドを X 軸にのみ表示するかどうかを指定します。X 軸グリッドを表示するには値を 'on' に設定します。

'YGrid' — Y 軸グリッドを指定

'off' (既定値) | 'on'

領域プロットに Y 軸グリッドを表示するかどうかを指定します。Y 軸グリッドを表示するには、値を 'on' に設定します。

'Legend' — グラフへの凡例の追加

文字列

グラフに凡例を追加します。文字列のセル配列として指定します。

例: thingSpeakArea(x, y,'Legend',{'Sine','Cosine','Tangent'})

参考

関数

• thingSpeakPlot | thingSpeakPlotYY | thingSpeakRead | thingSpeakScatter | thingSpeakStem | thingSpeakWrite | urlFilter