matplotlibのhist()が返す「n・bins・patches」とは？意味と使い方を解説

matplotlibのhist()メソッドは、ヒストグラムを作成するときにn（各ビンの度数）、bins（ビンの境界値）、patches（描画オブジェクトのコンテナ）という3つの戻り値を返します。

patchesは、ヒストグラムを構成する個々のバー（Rectangleアーティスト）を格納するコンテナです。複数のデータセットを入力した場合は、コンテナのリストが返されます。binsは、指定した範囲を等幅に分割する際のビンの境界値を定義します。

それでは、実際の例を使って動作を確認してみましょう。

手順

• 図のサイズを設定し、サブプロット間および周囲の余白を調整します。
• numpyを使ってランダムなデータポイントを生成します。
• 100個のビンを持つヒストグラムを描画します。
• アーティストオブジェクトに対してプロパティを設定します。
• show()メソッドで図を表示します。

コード例

import numpy as np
import matplotlib.pyplot as plt

plt.rcParams["figure.figsize"] = [7.50, 3.50]
plt.rcParams["figure.autolayout"] = True

x = np.random.normal(size=100)

n, bins, patches = plt.hist(x, bins=100)

plt.setp(patches[0], 'facecolor', 'yellow')

plt.show()

実行結果

この例では、正規分布に従う100個の乱数を生成し、100個のビンでヒストグラムを描画しています。戻り値のpatchesから最初のバーを取り出し、setp()メソッドで塗りつぶし色を黄色に変更している点にも注目してください。このように、patchesを操作することで特定のバーだけ色やスタイルを個別にカスタマイズできます。