matplotlib.axes.Axes.hist2d #
- 軸。hist2d ( x , y ,ビン= 10 ,範囲=なし,密度= False ,重み=なし, cmin =なし, cmax =なし, * ,データ=なし, ** kwargs ) [source] #
2D ヒストグラム プロットを作成します。
- パラメータ:
- x, y配列のような形状 (n, )
入力値
- bins None または int または [int, int] または array-like または [array, array]
ビン仕様:
int の場合、2 次元のビンの数 (nx=ny=bins)。
の場合、各次元のビンの数 (nx、ny = ビン)。
[int, int]
配列の場合、2 次元のビンのエッジ (x_edges=y_edges=bins)。
の場合、各次元のビン エッジ (x_edges、y_edges = ビン)。
[array, array]
デフォルト値は 10 です。
- 範囲配列のような形状 (2, 2)、オプション
各次元に沿ったビンの左端と右端 (ビン パラメータで明示的に指定されていない場合): . この範囲外のすべての値は外れ値と見なされ、ヒストグラムで集計されません。
[[xmin, xmax], [ymin, ymax]]
- 密度ブール値、デフォルト: False
ヒストグラムを正規化します。詳細については、密度 パラメーターのドキュメントを参照して
hist
ください。- 配列のような重み、形状 (n, )、オプション
各サンプル (x_i、y_i) を重み付けする値 w_i の配列。
- cmin、cmax float、デフォルト: なし
カウントがcmin未満またはcmmax を超えるすべてのビンは表示されず (imshow に渡す前に NaN に設定されます)、戻り値のカウント ヒストグラムのこれらのカウント値も返されると nan に設定されます。
- 戻り値:
- h 2D 配列
サンプル x と y の 2 次元ヒストグラム。x の値は最初の次元に沿ってヒストグラム化され、y の値は 2 番目の次元に沿ってヒストグラム化されます。
- xedges 1D配列
x 軸に沿ったビンの端。
- yedges 1D配列
ビンの端は y 軸に沿っています。
- 画像
QuadMesh
- その他のパラメータ:
- cmap str または
Colormap
、デフォルト:rcParams["image.cmap"]
(デフォルト:'viridis'
) スカラー データを色にマップするために使用される Colormap インスタンスまたは登録済みのカラーマップ名。
- ノルムstr または
Normalize
、オプション cmapを使用して色にマッピングする前に、スカラー データを [0, 1] の範囲にスケーリングするために使用される正規化方法。デフォルトでは、線形スケーリングが使用され、最小値が 0 に、最大値が 1 にマッピングされます。
指定する場合、これは次のいずれかになります。
のインスタンス
Normalize
またはそのサブクラスの 1 つ ( Colormap Normalizationを参照)。スケール名。つまり、「linear」、「log」、「symlog」、「logit」などのいずれかです。使用可能なスケールのリストについては、 を呼び出します
matplotlib.scale.get_scale_names()
。その場合、適切なNormalize
サブクラスが動的に生成され、インスタンス化されます。
- vmin、vmax float、オプション
スカラー データを使用し、明示的なnormを使用しない場合、vminとvmaxはカラーマップがカバーするデータ範囲を定義します。デフォルトでは、カラーマップは提供されたデータの値の範囲全体をカバーします。ノルムインスタンスが指定されているときにvmin / vmaxを使用するとエラーになります (ただし、 vmin / vmaxと 一緒にノルム名を使用することは許容されます)。
str
- alphaまたは、オプション
0 <= scalar <= 1
None
アルファ ブレンディング値。
- データのインデックス可能なオブジェクト、オプション
指定された場合、次のパラメーターは string も受け入れます
s
。これは、次のように解釈されますdata[s]
(例外が発生しない限り)。x、y、重み
- **kwargs
pcolormesh
追加のパラメーターは、メソッドとQuadMesh
コンストラクターに渡され ます。
- cmap str または
ノート
現在
hist2d
、独自の軸制限を計算しており、以前に設定された制限は無視されます。対数カラー スケールでヒストグラムをレンダリングするには、
colors.LogNorm
インスタンスをnorm キーワード引数に渡します。同様に、ベキ正規化 (ガンマ補正と同様の効果) を で行うことができますcolors.PowerNorm
。