Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

polarscatter

  • Polar scatter chart

説明

polarscatter(th,r) は、r に対して th をプロットし、各データ点に円マーカーを表示します。thr は同じ長さのベクトルでなければなりません。th はラジアン単位で指定しなければなりません。

  • 1 つの点集合をプロットするには、th および r を等しい長さのベクトルとして指定します。

  • 同じ極座標軸内の複数の点集合をプロットするには、th または r のうちの少なくとも 1 つを行列として指定します。

polarscatter(th,r,sz) はマーカーのサイズを設定します。ここで、sz は各マーカーの大きさを平方ポイントで指定します。すべてのマーカーを同じサイズで描画するには、sz をスカラーとして指定します。マーカーをさまざまなサイズで描画するには、ベクトルまたは行列として指定します。

polarscatter(th,r,sz,c) はマーカーの色を指定します。すべてのマーカーに 1 つの色を指定することも、色を変えることもできます。たとえば、c'red' として指定すると、すべての円を赤でプロットできます。

polarscatter(___,mkr) はマーカー記号を設定します。たとえば、'+' は十字のマーカーを表示します。前述の構文における任意の入力引数の組み合わせの後でマーカー記号を指定します。

polarscatter(___,'filled') はマーカーの内部を塗りつぶします。

polarscatter(___,Name,Value) は、1 つ以上の名前と値のペア引数を使用して、散布図の外観を変更します。たとえば、'FaceAlpha' および 01 の間のスカラー値を指定することにより、半透明のマーカーを使用できます。

polarscatter(pax,___) は、現在の座標軸ではなく pax によって指定される極座標軸にプロットします。

ps = polarscatter(___)Scatter オブジェクトまたは Scatter オブジェクトの配列を返します。Scatter オブジェクトを作成した後でその外観を変更するには、ps を使用します。プロパティの一覧については、Scatter のプロパティ を参照してください。

すべて折りたたむ

極座標に散布図を作成します。

th = pi/4:pi/4:2*pi;
r = [19 6 12 18 16 11 15 15];
polarscatter(th,r)

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

オプションの入力引数 'filled' を指定して、塗りつぶされたマーカーを使用する散布図を作成します。マーカー サイズを 75 平方ポイントに設定します。

th = linspace(0,2*pi,20);
r = rand(1,20);
sz = 75;
polarscatter(th,r,sz,'filled')

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

さまざまなサイズと色のマーカーを使用した散布図を作成します。オプションのサイズと色の入力引数をベクトルとして指定します。色ベクトルにそれぞれ固有の値を使用して、異なる色を指定します。値はカラーマップにある色にマッピングされます。

th = pi/4:pi/4:2*pi;
r = [19 6 12 18 16 11 15 15];
sz = 100*[6 15 20 3 15 3 6 40];
c = [1 2 2 2 1 1 2 1];
polarscatter(th,r,sz,c,'filled','MarkerFaceAlpha',.5)

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

角度値が度単位であるデータを作成します。polarscatter ではラジアン単位の角度値が必要とされるため、プロットする前に deg2rad を使用して値をラジアンに変換します。

th = linspace(0,360,50);
r = 0.005*th/10;
th_radians = deg2rad(th);
polarscatter(th_radians,r)

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

hold コマンドを使用して 2 つの散布図を同一の極座標軸に結合します。それぞれの図の説明を含む凡例を追加します。

th = pi/6:pi/6:2*pi;
r1 = rand(12,1);
polarscatter(th,r1,'filled')

hold on 
r2 = rand(12,1);
polarscatter(th,r2,'filled')
hold off

legend('Series A','Series B')

Figure contains an axes. The axes contains 2 objects of type scatter. These objects represent Series A, Series B.

散布図を作成して、scatter オブジェクトを変数 ps に割り当てます。

th = pi/6:pi/6:2*pi;
r = rand(12,1);
ps = polarscatter(th,r,'filled')

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

ps = 
  Scatter with properties:

             Marker: 'o'
    MarkerEdgeColor: 'none'
    MarkerFaceColor: 'flat'
           SizeData: 36
          LineWidth: 0.5000
          ThetaData: [1x12 double]
              RData: [1x12 double]
              ZData: [1x0 double]
              CData: [0 0.4470 0.7410]

  Show all properties

scatter オブジェクトを作成した後でそのプロパティを変更するには、ps を使用します。

ps.Marker = 'square';
ps.SizeData = 200;
ps.MarkerFaceColor = 'red';
ps.MarkerFaceAlpha = .5;

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

入力引数

すべて折りたたむ

theta 値。スカラー、ベクトルまたは行列として指定します。scatter オブジェクトの ThetaData プロパティは theta 値を保存します。

th のサイズと形状はデータの形状に依存します。次の表では、最も一般的な状況について説明します。

プロットのタイプ座標の指定方法
1 つの点

th および r をスカラーとして指定します。たとえば、次のように指定します。

polarscatter(pi/2,0.5)

1 つの点集合

th および r を同じ長さの行ベクトルまたは列ベクトルの任意の組み合わせとして指定します。たとえば、次のように指定します。

polarscatter([0 pi/4 pi/2],[1; 2; 3])

色が異なる複数の点集合

すべてのセットが同じ theta 値または rho 値を共有している場合は、共有している座標をベクトルとして、その他の座標を行列として指定します。ベクトルの長さは行列の次元の 1 つと一致していなければなりません。たとえば、次のように指定します。

polarscatter([0 pi/4 pi/2],[4 5 6; 7 8 9])
行列が正方の場合、polarscatter は行列の列ごとに別個の点のセットをプロットします。

または、thr をサイズが等しい行列として指定します。この場合、polarscatterth の各列を、対応する r の列に対してプロットします。たとえば、次のように指定します。

polarscatter([0 pi/6 pi/2; pi/8 pi/4 pi],[1 2 3; 4 5 6])

度数をラジアンに変換するには deg2rad を使用します。

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

rho 値。スカラー、ベクトルまたは行列として指定します。scatter オブジェクトの RData プロパティは rho 値を保存します。

r のサイズと形状はデータの形状に依存します。次の表では、最も一般的な状況について説明します。

プロットのタイプ座標の指定方法
1 つの点

th および r をスカラーとして指定します。たとえば、次のように指定します。

polarscatter(pi/2,0.5)

1 つの点集合

th および r を同じ長さの行ベクトルまたは列ベクトルの任意の組み合わせとして指定します。たとえば、次のように指定します。

polarscatter([0 pi/4 pi/2],[1; 2; 3])

色が異なる複数の点集合

すべてのセットが同じ theta 値または rho 値を共有している場合は、共有している座標をベクトルとして、その他の座標を行列として指定します。ベクトルの長さは行列の次元の 1 つと一致していなければなりません。たとえば、次のように指定します。

polarscatter([0 pi/4 pi/2],[4 5 6; 7 8 9])
行列が正方の場合、polarscatter は行列の列ごとに別個の点のセットをプロットします。

または、thr をサイズが等しい行列として指定します。この場合、polarscatterth の各列を、対応する r の列に対してプロットします。たとえば、次のように指定します。

polarscatter([0 pi/6 pi/2; pi/8 pi/4 pi],[1 2 3; 4 5 6])

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

マーカー サイズ。数値スカラー、ベクトル、行列、または空の配列 ([]) として指定します。サイズは各マーカーの平方ポイント単位の面積を制御します。空の行列は、既定の 36 ポイントのサイズを指定します。サイズを指定する方法は、thr の指定方法や目的のプロットの外観によって異なります。次の表では、最も一般的な状況について説明します。

目的のマーカー サイズth および r sz

すべての点に同じサイズ

thr の説明にあるベクトルまたは行列の任意の有効な組み合わせ。

スカラー

th をベクトル、r を行列、sz をスカラーとして指定します。

th = [0 pi/6 pi/2];
r = [1 2; 2 4; 5 6];
polarscatter(th,r,100)

点ごとに異なるサイズ

同じ長さのベクトル

  • th および r と同じ長さのベクトル。

  • 少なくとも 1 つの次元が th および r の長さと一致する行列。行列を指定すると、それぞれの (th,r) の位置にサイズが異なる複数のマーカーを表示する場合に便利です。

thr、および sz をベクトルとして指定します。

th = [0 pi/6 pi/2];
r = [1; 2; 3];
sz = [50 500 100];
polarscatter(th,r,sz)

thr をベクトル、sz を行列として指定します。

th = [0 pi/6 pi/2];
r = [1; 2; 3];
sz = [50 500 100; 300 1000 200];
polarscatter(th,r,sz)

点ごとに異なるサイズ

複数のデータセットをプロットする場合は x または y の少なくとも一方が行列

  • 各データセットの点と同じ数の要素をもつベクトル。

  • th または r の行列と同じサイズの行列。

th をベクトル、r を行列、sz をベクトルとして指定します。

th = [0 pi/6 pi/2];
r = [1 2; 2 4; 5 6];
sz = [50 500 1000];
polarscatter(th,r,sz)

th をベクトル、r を行列、szr と同じサイズの行列として指定します。

th = [0 pi/6 pi/2];
r = [1 2; 2 4; 5 6];
sz = [50 500; 1000 2000; 100 300];
polarscatter(th,r,sz)

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

マーカーの色。色名、RGB 3 成分、RGB 3 成分の行列、またはカラーマップ インデックスのベクトルとして指定します。

  • 色名 — 'red' のような色名、または 'r' のような省略名。

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

  • RGB 3 成分の行列 — 各行が RGB 3 成分である 3 列の行列。

  • カラーマップ インデックスのベクトル — th および r のベクトルと同じ長さの数値のベクトル。

色を指定する方法は、目的の配色や 1 つの座標セットをプロットするか複数の座標セットをプロットするかによって異なります。次の表では、最も一般的な状況について説明します。

配色色の指定方法

すべての点に 1 つの色を使用する。

次の表のいずれかの色名または省略名を指定するか、1 つの RGB 3 成分を指定します。

1 つの点集合をプロットし、色を 'red' に指定します。

th = [0 pi/6 pi/2];
r = [1 2 3];
c = 'red';
polarscatter(th,r,[],c)

2 つの点集合をプロットし、RGB 3 成分を使用して色を赤に指定します。

th = [0 pi/6 pi/2];
r = [1 2; 2 4; 5 6];
c = [1 0 0];
polarscatter(th,r,[],c)

カラーマップを使用して各点に異なる色を割り当てる。

数値の行ベクトルまたは列ベクトルを指定します。数値は現在のカラーマップ配列にインデックスを付けます。最小値はカラーマップの最初の行にマッピングされ、最大値は最後の行にマッピングされます。中間の値は中間の行に線形にマッピングされます。

プロットに点が 3 つある場合、値が必ずカラーマップ インデックスとして解釈されるように列ベクトルを指定します。

この方法は、thr、および sz がいずれもベクトルである場合にのみ使用できます。

4 つのカラーマップ インデックスを指定するベクトル c を作成します。現在のカラーマップの色を使用して 4 つの点をプロットします。その後、カラーマップを winter に変更します。

th = [0 pi/6 pi/2 2*pi/3];
r = [1 2 3 4];
c = [1 2 3 4];
polarscatter(th,r,[],c)
colormap(gca,'winter')

点ごとにカスタム色を作成する。

m 行 3 列の RGB 3 成分の行列を指定します (m はプロットの点の数)。

この方法は、thr、および sz がいずれもベクトルである場合にのみ使用できます。

4 色の RGB 3 成分を指定する行列 c を作成します。その後、それらの色を使用して 4 つの点のプロットを作成します。

th = [0 pi/6 pi/2 2*pi/3];
r = [1 2 3 4];
c = [1 0 0; 0 1 0; 0 0 1; 0 0 0];
polarscatter(th,r,[],c)

データセットごとに異なる色を作成する。

n 行 3 列の RGB 3 成分の行列を指定します (n はデータセットの数)。

この方法は、thr、または sz の少なくとも 1 つが行列である場合にのみ使用できます。

2 つの RGB 3 成分を含む行列 c を作成します。その後、それらの色を使用して 2 つのデータセットをプロットします。

th = [0 pi/6 pi/2];
r = [1 2; 2 4; 5 6];
c = [1 0 0; 0 0 1];
polarscatter(th,r,[],c)

一般的な色の色名と RGB 3 成分

色名省略名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'

MATLAB® の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

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

マーカー記号。次の表に挙げるマーカー記号のいずれかとして指定します。

マーカー説明
'o'
'+'プラス記号
'*'アスタリスク
'.'
'x'十字
'_'水平線
'|'垂直線
's'正方形
'd'菱形
'^'上向き三角形
'v'下向き三角形
'>'右向き三角形
'<'左向き三角形
'p'星形五角形
'h'星形六角形

scatter オブジェクトの Marker プロパティはマーカー記号を保存します。

PolarAxes オブジェクト。極座標軸を指定しない場合、polarscatter は現在の座標軸を使用します。polarscatter は直交座標軸へのプロットをサポートしません。

名前と値のペアの引数

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順序で指定できます。

例: polarscatter(th,r,'filled','MarkerFaceAlpha',.5) は、塗りつぶされた半透明のマーカーを作成します。

ここでは、scatter オブジェクトのプロパティの一部だけを紹介しています。完全な一覧については、Scatter のプロパティ を参照してください。

マーカーの面の透明度。[0,1] の範囲のスカラーとして指定します。値 1 は不透明、値 0 は透明を表します。0 と 1 の間の値は半透明です。

マーカーの輪郭の色。'flat'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。既定値の 'flat' を指定すると、CData プロパティからの色が使用されます。

カスタム色を使用する場合は、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'該当なし該当なし該当なし色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

例: [0.5 0.5 0.5]

例: 'blue'

例: '#D2F9A7'

マーカーの塗りつぶし色。'flat''auto'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。'flat' オプションは CData 値を使用します。'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 進数カラー コードを示します。

色名省略名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'該当なし該当なし該当なし色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

例: [0.3 0.2 0.1]

例: 'green'

例: '#D2F9A7'

マーカー エッジの幅。ポイント単位の正の値として指定します。

例: 0.75

R2016b で導入