matplotlib.pyplot.hist #

matplotlib.pyplot. hist ( x、 bins = None、 range = None、 density = False、 weights = None、 cumulative = False、 bottom = None、 histtype = 'bar'、 align = 'mid'、 orientation = 'vertical'、 rwidth = None、ログ=偽、色=None、 label = None、 stacked = False、 *、 data = None、 ** kwargs ) [source] #

ヒストグラムを計算してプロットします。

このメソッドはnumpy.histogram、データをxBarContainerにビン化し、各ビンの値の数をカウントしてから、分布を aまたはとして描画します Polygon。bins 、range、density、および weightsパラメータはに転送されます。numpy.histogram

データが既にビニングされてカウントされている場合は、barまたはを使用stairsして分布をプロットします。

counts, bins = np.histogram(x)
plt.stairs(bins, counts)

hist()または、各ビンをそのカウントに等しい重みを持つ単一のポイントとして扱うことにより、事前に計算されたビンとカウントをプロットします。

plt.hist(bins[:-1], bins, weights=counts)

データ入力xは、特異配列、潜在的に異なる長さのデータセットのリスト ([ x0 , x1 , ...])、または各列がデータセットである 2D ndarray にすることができます。ndarray 形式は、リスト形式に対して相対的に転置されることに注意してください。入力が配列の場合、戻り値はタプル ( n、ビン、パッチ) です。入力が一連の配列の場合、戻り値はタプル ([ n0 , n1 , ...], bins , [ patch0 , patch1 , ...]) です。

マスク配列はサポートされていません。

パラメータ:

x (n,) 配列または (n,) 配列のシーケンス

入力値。これは、単一の配列または同じ長さである必要のない一連の配列のいずれかを取ります。

ビンint または sequence または str、デフォルト: rcParams["hist.bins"](デフォルト: 10)

binsが整数の場合、範囲内の等幅ビンの数を定義します。

binsがシーケンスの場合、最初のビンの左端と最後のビンの右端を含むビンの端を定義します。この場合、ビンの間隔が不均等になることがあります。最後 (一番右) のビン以外はすべて半分開いています。つまり、binsが次の場合:

[1, 2, 3, 4]

最初のビンは(1 を含むが 2 を除く) で、2 番目のビンはです。ただし、最後のビンはで、4 が 含まれています。[1, 2)[2, 3)[3, 4]

binsが文字列の場合numpy.histogram_bin_edges、'auto'、'fd'、'doane'、'scott'、'stone'、'rice'、'sturges'、または 'sqrt' でサポートされているビニング戦略の 1 つです。

範囲タプルまたはなし、デフォルト: なし

ビンの下限と上限。上下の外れ値は無視されます。指定しない場合、範囲はです。binsがシーケンスの場合、Range は効果がありません。(x.min(), x.max())

binsがシーケンスまたは範囲が指定されている場合、自動スケーリングは x の範囲ではなく、指定されたビンの範囲に基づきます。

密度ブール値、デフォルト: False

の場合、確率密度を描画して返します。各ビンには、ビンの raw カウントを合計カウント数とビン幅Trueで割った値が表示され ( )、ヒストグラムの下の領域が 1 に統合されます ( )。density = counts / (sum(counts) * np.diff(bins))np.sum(density * np.diff(bins)) == 1

積み上げもの場合True、ヒストグラムの合計は 1 に正規化されます。

weights (n,) 配列のようなものまたはなし、デフォルト: なし

xと同じ形状の重みの配列。xの各値は、 (1 ではなく) ビンカウントに関連する重みのみを提供します。密度がの場合True、範囲全体の密度の積分が 1 のままになるように、重みが正規化されます。

累積ブール値または -1、デフォルト: False

の場合True、各ビンがそのビン内のカウントと小さい値のすべてのビンを与えるヒストグラムが計算されます。最後のビンは、データポイントの総数を示します。

密度もである場合True、最後のビンが 1 に等しくなるようにヒストグラムが正規化されます。

累積が 0 未満の数値 (-1 など) の場合、累積の方向が逆になります。この場合、密度も Trueである場合、最初のビンが 1 に等しくなるようにヒストグラムが正規化されます。

一番下の配列のような、スカラー、またはなし、デフォルト: なし

各ビンの底の位置。bottomビンは～から描画されます。スカラーの場合、各ビンの下部は同じ量だけシフトされます。配列の場合、各ビンは個別にシフトされ、底の長さはビンの数と一致する必要があります。なしの場合、デフォルトは 0 です。bottom + hist(x, bins)

histtype {'bar', 'barstacked', 'step', 'stepfilled'}, デフォルト: 'bar'

描画するヒストグラムのタイプ。

'bar' は従来のバータイプのヒストグラムです。複数のデータが指定されている場合、バーは横に並べて配置されます。
'barstacked' は、複数のデータが互いに積み上げられたバータイプのヒストグラムです。
'step' は、既定で塗りつぶされていない折れ線グラフを生成します。
'stepfilled' は、既定で塗りつぶされたラインプロットを生成します。

align {'left', 'mid', 'right'}, デフォルト: 'mid'

ヒストグラムバーの水平方向の配置。

'left': バーはビンの左端の中央に配置されます。
'mid': バーはビンの端の間の中央に配置されます。
'right': バーはビンの右端の中央に配置されます。

向き{'vertical', 'horizontal'}、デフォルト: 'vertical'

'horizontal' の場合barh、バータイプのヒストグラムに使用され、一番下のkwarg が左端になります。

rwidth float または None、デフォルト: None

ビンの幅に対するバーの相対的な幅。の場合 None、自動的に幅を計算します。

histtypeが 'step' または 'stepfilled' の場合は無視されます。

ログブール、デフォルト: False

の場合True、ヒストグラム軸は対数スケールに設定されます。

color color または色の配列のようなもの、または None、デフォルト: None

データセットごとに 1 つの色または色のシーケンス。デフォルト ( None) は、標準のラインカラーシーケンスを使用します。

label str または None、デフォルト: None

複数のデータセットに一致する文字列、または文字列のシーケンス。棒グラフはデータセットごとに複数のパッチを生成しますが、ラベルを取得するのは最初のものだけなので、legend期待どおりに機能します。

積み上げブール値、デフォルト: False

の場合True、複数のデータが互いに積み上げられ Falseます

戻り値:

n配列または配列のリスト: ヒストグラムビンの値。考えられるセマンティクスの説明については、密度と重みを参照してください。入力xが配列の場合、これは長さnbinsの配列です。入力が配列のシーケンスである場合、これは各配列のヒストグラムの値が同じ順序である配列のリストです。配列n (またはその要素配列)の dtype は、重み付けや正規化が使用されていない場合でも、常に float になります。[data1, data2, ...]
ビン配列: ビンの端。長さ nbins + 1 (最後のビンの nbins 左端と右端)。複数のデータセットが渡された場合でも、常に 1 つの配列です。
単一のパッチまたはそのようなオブジェクトのリストBarContainerPolygon: 複数の入力データセットがある場合に、ヒストグラムまたはそのようなコンテナーのリストを作成するために使用される個々のアーティストのコンテナー。

その他のパラメータ: