ドキュメンテーションヘルプ センター
最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。
3 次元散布図
scatter3(X,Y,Z)
scatter3(X,Y,Z,S)
scatter3(X,Y,Z,S,C)
scatter3(___,'filled')
scatter3(___,markertype)
scatter3(___,Name,Value)
scatter3(ax,___)
h = scatter3(___)
例
scatter3(X,Y,Z) は、ベクトル X、Y および Z で指定された位置に円を表示します。
X
Y
Z
scatter3(X,Y,Z,S) は、S で指定されたサイズで各円を描画します。各円を同じサイズでプロットするには、スカラーとして S を指定します。各円を特定のサイズでプロットするには、ベクトルとして S を指定します。
S
scatter3(X,Y,Z,S,C) は、C で指定された色で各円を描画します。
C
C が RGB 3 成分、または色名を含む文字ベクトルまたは string の場合、すべての円が指定された色でプロットされます。
C が 3 列の行列で、C の行数が X、Y および Z の長さと同じ場合、C の各行は対応する円の RGB カラー値を指定します。
C が X、Y および Z と同じ長さのベクトルの場合、C の値は、現在のカラーマップの色に線形にマッピングされます。
scatter3(___,'filled') は、前述の構文の任意の入力引数の組み合わせを使って円を塗りつぶします。
'filled'
scatter3(___,markertype) はマーカーのタイプを指定します。
markertype
scatter3(___,Name,Value) は、1 つ以上の名前と値のペアの引数を使用して、散布図を変更します。
Name,Value
scatter3(ax,___) は、現在の座標軸 (gca) の代わりに ax によって指定される座標軸にプロットします。ax オプションは、前述の構文のすべての入力引数の組み合わせより前に指定できます。
ax
gca
h = scatter3(___) は、Scatter オブジェクトを返します。h は散布図の作成後にそれらのプロパティを変更する場合に使用します。
h
Scatter
すべて折りたたむ
3 次元散布図を作成します。sphere を使用して、ベクトル x、y および z を定義します。
sphere
x
y
z
figure [X,Y,Z] = sphere(16); x = [0.5*X(:); 0.75*X(:); X(:)]; y = [0.5*Y(:); 0.75*Y(:); Y(:)]; z = [0.5*Z(:); 0.75*Z(:); Z(:)]; scatter3(x,y,z)
sphere を使用して、ベクトル x、y および z を定義します。
[X,Y,Z] = sphere(16); x = [0.5*X(:); 0.75*X(:); X(:)]; y = [0.5*Y(:); 0.75*Y(:); Y(:)]; z = [0.5*Z(:); 0.75*Z(:); Z(:)];
ベクトル s を定義して、マーカー サイズを指定します。
s
S = repmat([100,50,5],numel(X),1); s = S(:);
3 次元散布図を作成し、view を使用して Figure の Axes の角度を変更します。
view
figure scatter3(x,y,z,s) view(40,35)
x、y、z および s の対応するエントリによって、各マーカーの位置とサイズが決まります。
ベクトル s と c を定義して、各マーカーのサイズと色を指定します。
c
S = repmat([50,25,10],numel(X),1); C = repmat([1,2,3],numel(X),1); s = S(:); c = C(:);
figure scatter3(x,y,z,s,c) view(40,35)
x、y、z および c の対応するエントリによって、各マーカーの位置と色が決まります。
x ベクトルと y ベクトルを、ランダム ノイズが含まれる余弦値と正弦値として作成します。
z = linspace(0,4*pi,250); x = 2*cos(z) + rand(1,250); y = 2*sin(z) + rand(1,250);
3 次元散布図を作成し、マーカーを塗りつぶします。view を使用して図の軸の角度を変更します。
scatter3(x,y,z,'filled') view(-30,10)
乱数発生器を初期化して rand の出力を反復可能にします。x ベクトルと y ベクトルを、ランダム ノイズが含まれる余弦値と正弦値として定義します。
rand
rng default z = linspace(0,4*pi,250); x = 2*cos(z) + rand(1,250); y = 2*sin(z) + rand(1,250);
3 次元散布図を作成し、マーカー タイプを設定します。view を使用して図の軸の角度を変更します。
figure scatter3(x,y,z,'*') view(-30,10)
3 次元散布図を作成し、マーカー エッジの色とマーカーの面の色を設定します。view を使用して図の軸の角度を変更します。
figure scatter3(x,y,z,... 'MarkerEdgeColor','k',... 'MarkerFaceColor',[0 .75 .75]) view(-30,10)
R2019b 以降、関数 tiledlayout および nexttile を使用して、プロットをタイル表示できます。
tiledlayout
nexttile
seamount データセットを読み込み、x ベクトル、y ベクトルおよび z ベクトルを取得します。関数 tiledlayout を呼び出して、2 行 1 列のタイル表示チャート レイアウトを作成します。関数 nexttile を呼び出して、axes オブジェクト ax1 および ax2 を作成します。次に、axes オブジェクトを scatter3 の最初の引数として指定することで、座標軸に個別の散布図を作成します。
seamount
ax1
ax2
scatter3
load seamount tiledlayout(2,1) ax1 = nexttile; ax2 = nexttile; scatter3(ax1,x,y,z,'MarkerFaceColor',[0 .75 .75]) scatter3(ax2,x,y,z,'*')
関数 sphere を使用してベクトル x、y および z を作成します。
ベクトル s と c を作成し、各マーカーのサイズと色を指定します。
S = repmat([70,50,20],numel(X),1); C = repmat([1,2,3],numel(X),1); s = S(:); c = C(:);
3 次元散布図を作成し、scatter series オブジェクトを返します。
h = scatter3(x,y,z,s,c);
RGB 3 成分を使ってマーカーの面の色を設定します。プロパティの設定にはドット表記を使用します。
h.MarkerFaceColor = [0 0.5 0.5];
x 値。ベクトルとして指定します。X、Y、Z は同じ長さのベクトルでなければなりません。
データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration
single
double
int8
int16
int32
int64
uint8
uint16
uint32
uint64
categorical
datetime
duration
y 値。ベクトルとして指定します。X、Y、Z は同じ長さのベクトルでなければなりません。
z 値。ベクトルとして指定します。X、Y、Z は同じ長さのベクトルでなければなりません。
[]
マーカーの大きさ。スカラー値、ベクトルまたは [] として指定します。S の値は、正の値でなければなりません。領域の単位は平方ポイントです。
S がスカラーの場合、scatter3 は、指定された領域のすべてのマーカーをプロットします。
S が行または列ベクトルの場合、S の各エントリは対応するマーカーの領域を指定します。S の長さは、X、Y および Z の長さと同じでなければなりません。X、Y、Z および S の対応するエントリによって、各マーカーの位置と領域が決まります。
S が空の場合、既定のサイズである 36 平方ポイントが使用されます。
例: 50
50
例: [36,25,25,17,46]
[36,25,25,17,46]
[0 0 1]
'r'
'g'
'b'
マーカーの色。RGB 3 成分、RGB 3 成分の 3 列の行列、ベクトル、または表の色オプションのいずれかとして指定します。
RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、色の完全名および省略名のオプションと、等価の RGB 3 成分の値を示します。
[0,1]
[0.4 0.6 0.7]
'red'
[1 0 0]
'green'
[0 1 0]
'blue'
'yellow'
'y'
[1 1 0]
'magenta'
'm'
[1 0 1]
'cyan'
'c'
[0 1 1]
'white'
'w'
[1 1 1]
'black'
'k'
[0 0 0]
散布図内に 3 つの点がある場合に色をカラーマップ内にインデックスするには、C を 3 要素の列ベクトルとして指定します。
例: 'y'
例: [1,2,3,4]
[1,2,3,4]
'o'
'+'
'*'
'.'
'x'
マーカー。次の表のマーカーのいずれかとして指定します。
'square'
's'
'diamond'
'd'
'^'
'v'
'>'
'<'
'pentagram'
'p'
'hexagram'
'h'
'none'
axes オブジェクト。座標軸を指定しない場合は、scatter3 は現在の座標軸にプロットします。
オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順序で指定できます。
Name
Value
Name1,Value1,...,NameN,ValueN
'MarkerFaceColor','red'
ここでは、プロパティの一部だけを紹介しています。完全な一覧については、Scatter のプロパティ を参照してください。
'LineWidth'
0.5
マーカー エッジの幅。ポイント単位の正の値として指定します。
例: 0.75
0.75
'MarkerEdgeColor'
'flat'
マーカーの輪郭の色。'flat'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。既定値の 'flat' を指定すると、CData プロパティからの色が使用されます。
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' は等価です。
#
0
F
'#FF8800'
'#ff8800'
'#F80'
'#f80'
あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。
'#FF0000'
'#00FF00'
'#0000FF'
'#00FFFF'
'#FF00FF'
'#FFFF00'
'#000000'
'#FFFFFF'
MATLAB® の多くのタイプのプロットで使用されている既定の色の 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]
[0.5 0.5 0.5]
例: 'blue'
例: '#D2F9A7'
'#D2F9A7'
'MarkerFaceColor'
'auto'
マーカーの塗りつぶし色。'flat'、'auto'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。'flat' オプションは CData 値を使用します。'auto' オプションは座標軸の Color プロパティと同じ色を使用します。
Color
MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。
例: [0.3 0.2 0.1]
[0.3 0.2 0.1]
例: 'green'
Scatter オブジェクト。この一意の識別子を使って、Scatter オブジェクトの作成後にそれらのプロパティをクエリしたり変更したりできます。
使用上の注意事項および制限事項:
この関数は GPU 配列を受け入れますが、GPU 上では実行されません。
詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。
この関数は分散配列に対して演算を行いますが、クライアントの MATLAB で実行されます。
詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。
plot3
scatter
この例の変更されたバージョンがシステム上にあります。代わりにこのバージョンを開きますか?
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Contact your local office