binScatterPlot
高配列のビンの散布図
構文
説明
binScatterPlot(
は、X, Y
)X
およびY
のデータのビン化された散布図を作成します。関数binScatterPlot
は、X
およびY
の要素の範囲をカバーし、基となる分布の形状を明らかにするように選択された、一様な領域のビンを返す自動ビン化アルゴリズムを使用します。
binScatterPlot(
では、前の構文のいずれかを使用し、1 つ以上の名前と値のペアの引数で追加オプションを指定します。たとえば、X, Y
,Name,Value
)'Color'
と有効な色のオプションを指定してプロットのカラー テーマを変更したり、'Gamma'
を正のスカラーで指定して詳細レベルを調整したりできます。
は、h
= binScatterPlot(___)Histogram2
オブジェクトを返します。このオブジェクトを使用して、プロットのプロパティを調べます。
例
正規分布の乱数データがビン化された散布図
2つの乱数データの高ベクトルを作成します。このデータについて,ビン化された散布図を作成します。
tall 配列に対する計算を実行する場合、MATLAB® は並列プール (Parallel Computing Toolbox™ がある場合は既定) またはローカルの MATLAB セッションを使用します。Parallel Computing Toolbox がある場合にローカルの MATLAB セッションを使用して例を実行するには、関数mapreducer
を使用してグローバルな実行環境を変更します。
mapreducer(0) X = tall(randn(1e5,1)); Y = tall(randn(1e5,1)); binScatterPlot(X,Y)
Evaluating tall expression using the Local MATLAB Session: - Pass 1 of 1: Completed in 1.1 sec Evaluation completed in 2.3 sec Evaluating tall expression using the Local MATLAB Session: - Pass 1 of 1: Completed in 0.23 sec Evaluation completed in 0.33 sec
生成される Figure には、イメージの詳細レベルを調整するためのスライダーが含まれています。
散布図のビンの個数の指定
3 番目の入力引数としてスカラー値を指定して各次元で同じ個数のビンを使用するか、2 要素ベクトルを指定して各次元で異なる個数のビンを使用します。
tall 配列に対する計算を実行する場合、MATLAB® は並列プール (Parallel Computing Toolbox™ がある場合は既定) またはローカルの MATLAB セッションを使用します。Parallel Computing Toolbox がある場合にローカルの MATLAB セッションを使用して例を実行するには、関数mapreducer
を使用してグローバルな実行環境を変更します。
mapreducer(0)
各次元で 100 個のビンに分類された乱数データのビン化された散布図をプロットします。
X = tall(randn(1e5,1)); Y = tall(randn(1e5,1)); binScatterPlot(X,Y,100)
Evaluating tall expression using the Local MATLAB Session: - Pass 1 of 1: Completed in 0.9 sec Evaluation completed in 1.3 sec Evaluating tall expression using the Local MATLAB Session: - Pass 1 of 1: Completed in 0.26 sec Evaluation completed in 0.6 sec
x次元では 20 個のビンを、y次元では引き続き 100 個のビンを使用します。
binScatterPlot(X,Y,[20 100])
Evaluating tall expression using the Local MATLAB Session: - Pass 1 of 1: Completed in 0.18 sec Evaluation completed in 0.29 sec Evaluating tall expression using the Local MATLAB Session: - Pass 1 of 1: Completed in 0.12 sec Evaluation completed in 0.17 sec
散布図のビンのエッジの指定
ビンのエッジを指定して、乱数データのビン化された散布図をプロットします。外れ値を捕捉するため、ビンのエッジとしてInf
と-Inf
を使用します。
tall 配列に対する計算を実行する場合、MATLAB® は並列プール (Parallel Computing Toolbox™ がある場合は既定) またはローカルの MATLAB セッションを使用します。Parallel Computing Toolbox がある場合にローカルの MATLAB セッションを使用して例を実行するには、関数mapreducer
を使用してグローバルな実行環境を変更します。
mapreducer(0)
各次元で[-2 2]
に 100 個のビンがある、ビン化された散布図を作成します。指定したビンのエッジの外部にあるデータは、プロットに含まれません。
X = tall(randn(1e5,1)); Y = tall(randn(1e5,1)); Xedges = linspace(-2,2); Yedges = linspace(-2,2); binScatterPlot(X,Y,Xedges,Yedges)
Evaluating tall expression using the Local MATLAB Session: - Pass 1 of 1: Completed in 0.98 sec Evaluation completed in 1.3 sec
プロットのエッジで無限大まで広がる粗いビンを使用して、外れ値を捕捉します。
Xedges = [-Inf linspace(-2,2) Inf]; Yedges = [-Inf linspace(-2,2) Inf]; binScatterPlot(X,Y,Xedges,Yedges)
Evaluating tall expression using the Local MATLAB Session: - Pass 1 of 1: Completed in 0.26 sec Evaluation completed in 0.39 sec
プロットのカラー テーマの調整
'Color'
として'c'
を指定して、乱数データのビン化された散布図をプロットします。
tall 配列に対する計算を実行する場合、MATLAB® は並列プール (Parallel Computing Toolbox™ がある場合は既定) またはローカルの MATLAB セッションを使用します。Parallel Computing Toolbox がある場合にローカルの MATLAB セッションを使用して例を実行するには、関数mapreducer
を使用してグローバルな実行環境を変更します。
mapreducer(0) X = tall(randn(1e5,1)); Y = tall(randn(1e5,1)); binScatterPlot(X,Y,'Color','c')
Evaluating tall expression using the Local MATLAB Session: - Pass 1 of 1: Completed in 1.1 sec Evaluation completed in 2.3 sec Evaluating tall expression using the Local MATLAB Session: - Pass 1 of 1: Completed in 0.27 sec Evaluation completed in 0.36 sec
入力引数
X, Y
- - - - - -(別々の引数として) ビンに分散させるデータ
tall ベクトル|tall 行列|tall 多次元配列
ビンに分散させるデータ。tall ベクトル、tall 行列行列または tall 多次元配列を別々の引数として指定します。X
とY
は同じサイズでなければなりません。X
とY
がベクトルではない場合、binScatterPlot
はこれらを 1 列のベクトルX(:)
およびY(:)
として扱います。
X
およびY
の対応する要素では、2 次元データ点[X(k),Y(k)]
の x 座標と y 座標を指定します。X
とY
の基となるデータ型は違うものにできますが,binScatterPlot
はこれらの入力を連結し、単一の、支配的な基となるデータ型によるN
行2
列の tall 行列にします。
binScatterPlot
は、すべてのNaN
値を無視します。同様に、ビンのエッジとしてInf
または-Inf
を明示的に指定しない限り、binScatterPlot
は値Inf
および-Inf
を無視します。
メモ
flintmax
より大きいint64
またはuint64
型の整数がX
またはY
に含まれている場合、ビンのエッジを明示的に指定することをお勧めします。binScatterPlot
は倍精度を使用して自動的に入力データをビン化しますが、flintmax
より大きい数値では整数の精度が不足します。
データ型:single
|double
|int8
|int16
|int32
|int64
|uint8
|uint16
|uint32
|uint64
|logical
nbins
- - - - - -各次元におけるビンの個数
スカラー|ベクトル
各次元におけるビンの個数。正の整数スカラー、または正の整数が格納されている 2 要素のベクトルを指定します。nbins
を指定しない場合、binScatterPlot
はX
とY
の値に基づいて、使用するビンの個数を自動的に計算します。
nbins
がスカラーの場合、binScatterPlot
はこの個数のビンを各次元で使用します。nbins
がベクトルの場合、nbins(1)
は x 次元におけるビンの個数を、nbins(2)
は y 次元におけるビンの個数を指定します。
例:binScatterPlot(X,Y,20)
は、各次元で 20 個のビンを使用します。
例:binScatterPlot(X,Y,[10 20])
は、x
次元で 10 個のビンを、y
次元で 20 個のビンを使用します。
Xedges
- - - - - -x 次元におけるビンのエッジ
ベクトル
x 次元におけるビンのエッジ。ベクトルを指定します。Xedges(1)
は x 次元における最初のビンの最初のエッジです。Xedges(end)
は最後のビンの外側のエッジです。
Xedges(i)
≤X(k)
<Xedges(i+1)
かつYedges(j)
≤Y(k)
<Yedges(j+1)
の場合、値[X(k),Y(k)]
は(i,j)
番目のビンに含まれます。各次元の最後のビンには、最後の (外側の) エッジも含まれます。たとえば、Xedges(end-1)
≤X(k)
≤Xedges(end)
かつYedges(i)
≤Y(k)
<Yedges(i+1)
の場合、[X(k),Y(k)]
は最後の行のi
番目のビンに含まれます。
データ型:single
|double
|int8
|int16
|int32
|int64
|uint8
|uint16
|uint32
|uint64
|logical
Yedges
- - - - - -y 次元におけるビンのエッジ
ベクトル
y 次元におけるビンのエッジ。ベクトルを指定します。Yedges(1)
は y 次元における最初のビンの最初のエッジです。Yedges(end)
は最後のビンの外側のエッジです。
Xedges(i)
≤X(k)
<Xedges(i+1)
かつYedges(j)
≤Y(k)
<Yedges(j+1)
の場合、値[X(k),Y(k)]
は(i,j)
番目のビンに含まれます。各次元の最後のビンには、最後の (外側の) エッジも含まれます。たとえば、Xedges(end-1)
≤X(k)
≤Xedges(end)
かつYedges(i)
≤Y(k)
<Yedges(i+1)
の場合、[X(k),Y(k)]
は最後の行のi
番目のビンに含まれます。
データ型:single
|double
|int8
|int16
|int32
|int64
|uint8
|uint16
|uint32
|uint64
|logical
名前と値の引数
オプションの引数のペアをName1=Value1,...,NameN=ValueN
として指定します。ここでName
は引数名、Value
は対応する値です。名前と値の引数は他の引数の後ろにする必要がありますが、ペアの順序は関係ありません。
R2021a より前では、名前と値をそれぞれコンマを使って区切り、Name
を引用符で囲みます。
例:binScatterPlot(X,Y,'BinWidth',[5 10])
BinMethod
- - - - - -ビン化アルゴリズム
'auto'
(既定値) |'scott'
|'integers'
ビン化アルゴリズム。'BinMethod'
と次のいずれかの値から構成されるコンマ区切りのペアとして指定します。
値 | 説明 |
---|---|
'auto' |
既定の'auto' アルゴリズムでは、最大 100 個のビンを使用します。データ範囲をカバーし、基となる分布の形状が明らかになるようにビンの幅を選択します。 |
'scott' |
スコットの法則は、データを結合すると正規分布に近づく場合に最適です。この法則は、他のほとんどの分布にも適しています。[3.5*std(X)*numel(X)^(-1/4), 3.5*std(Y)*numel(Y)^(-1/4)] というビン サイズを使用します。 |
'integers' |
整数ルールは、各整数についてビンを作成するので、整数データで有効です。幅が 1 のビンを使用し、ビンのエッジを各整数の中間に設定します。誤って多すぎるビンを作成しないようにするため、このルールを使用して、作成するビンの個数を 65536 個 (216) 個に制限することができます。データ範囲が 65536 を超える場合、整数ルールではさらに幅が広いビンを代わりに使用します。 |
メモ
生成されるHistogram2
オブジェクトのBinMethod
プロパティの値は、常に'manual'
になります。
BinWidth
- - - - - -各次元におけるビンの幅
スカラー|ベクトル
各次元におけるビンの幅。'BinWidth'
と正の整数のスカラーまたは 2 要素ベクトル[xWidth yWidth]
から構成されるコンマ区切りのペアとして指定します。スカラー値を指定すると、ビンの幅が各次元で同じになります。
BinWidth
を指定した場合、binScatterPlot
は各次元で最大 1024 個 (210個) のビンを使用できます。さらにビンが必要となる幅が指定された場合、binScatterPlot
はビンの最大数に合わせてビンの幅を大きくします。
例:binScatterPlot(X,Y,'BinWidth',[5 10])
は、サイズが5
のビンをx
次元で、サイズが10
のビンをy
次元で使用します。
Color
- - - - - -プロットのカラー テーマ
'b'
(既定値) |'y'
|'m'
|'c'
|'r'
|'g'
|'k'
プロットのカラー テーマ。'Color'
と次のいずれかのオプションから構成されるコンマ区切りのペアとして指定します。
オプション | 説明 |
---|---|
'b' |
青 |
'm' |
赤紫 |
'c' |
シアン |
'r' |
赤 |
'g' |
緑 |
'y' |
黄 |
'k' |
黒 |
Gamma
- - - - - -ガンマ補正
1
(既定値) |正のスカラー
ガンマ補正。'Gamma'
と正のスカラーから構成されるコンマ区切りのペアとして指定します。このオプションを使用して、イメージの詳細の量に影響を与える明度および色強度を調整します。
gamma < 1
- - - - - -ガンマが減少するにつれ、ビンのカウント数が小さいビンのシェーディングが徐々に暗くなり、より多くのイメージ詳細が含まれます。gamma > 1
- - - - - -ガンマが増加するにつれ、ビンのカウント数が小さいビンのシェーディングが徐々に明るくなり、イメージから詳細が取り除かれます。既定値の 1 では表示の補正は適用されません。
XBinLimits
- - - - - -x 次元におけるビンの範囲
ベクトル
x 次元におけるビンの範囲。'XBinLimits'
と 2 要素ベクトル[xbmin,xbmax]
から構成されるコンマ区切りのペアとして指定します。このベクトルは、x 次元における最初と最後のビンのエッジを指定します。
binScatterPlot
はビンの範囲に含まれるデータData(Data(:,1)>=xbmin & Data(:,1)<=xbmax)
のみをプロットします。
YBinLimits
- - - - - -y 次元におけるビンの範囲
ベクトル
y 次元におけるビンの範囲。'YBinLimits'
と 2 要素ベクトル[ybmin,ybmax]
から構成されるコンマ区切りのペアとして指定します。このベクトルは、y 次元における最初と最後のビンのエッジを指定します。
binScatterPlot
はビンの範囲に含まれるデータData(Data(:,2)>=ybmin & Data(:,2)<=ybmax)
のみをプロットします。
出力引数
h
- - - - - -ビン化された散布図
Histogram2
オブジェクト
ビン化された散布図。Histogram2
オブジェクトとして返されます。詳細については、Histogram2 のプロパティを参照してください。
拡張機能
tall 配列
メモリの許容量を超えるような多数の行を含む配列を計算します。
この関数は、tall 配列を完全にサポートします。詳細は、tall 配列を参照してください。
バージョン履歴
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
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:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina(Español)
- Canada(English)
- United States(English)
Europe
- Belgium(English)
- Denmark(English)
- Deutschland(Deutsch)
- España(Español)
- Finland(English)
- France(Français)
- Ireland(English)
- Italia(Italiano)
- Luxembourg(English)
- Netherlands(English)
- Norway(English)
- Österreich(Deutsch)
- Portugal(English)
- Sweden(English)
- Switzerland
- United Kingdom(English)