class Histogram -- Histogram オブジェクト

histogram オブジェクトは Image.get_histogram() によって返されます。基底クラス名は histogram です。

グレースケール画像の場合、ヒストグラムはビンの単一チャンネルを持ちます。RGB565 画像の場合、ヒストグラムは CIE-LAB の L、A、B 軸をカバーする3つのチャンネルを持ちます。いずれの場合も、各チャンネルはそのビンの合計が 1.0 になるように正規化されます。

チャンネルごとのビンのリストは、バインドメソッド（hist.bins()）と添字記法（hist[0]）の両方で公開されています。高水準のリダクションである get_percentile()、get_threshold()、get_statistics() は、対応する Percentile、Threshold、Statistics の attrtuple を返します。

class image.histogram

このオブジェクトを作成するには Image.get_histogram() を呼び出してください。これには公開コンストラクタがありません。

bins() → list[float]

グレースケールヒストグラムのビンのリストを返します。各エントリは 0.0 から 1.0 の範囲で、エントリの合計は 1.0 になります。

histogram[0] と等価です。

l_bins() → list[float]

RGB565 ヒストグラムの LAB L チャンネルのビンのリストを返します。各エントリは 0.0 から 1.0 の範囲で、エントリの合計は 1.0 になります。

histogram[0] と等価です。

a_bins() → list[float]

RGB565 ヒストグラムの LAB A チャンネルのビンのリストを返します。各エントリは 0.0 から 1.0 の範囲で、エントリの合計は 1.0 になります。

histogram[1] と等価です。

b_bins() → list[float]

RGB565 ヒストグラムの LAB B チャンネルのビンのリストを返します。各エントリは 0.0 から 1.0 の範囲で、エントリの合計は 1.0 になります。

histogram[2] と等価です。

get_percentile(percentile: float) → image.percentile

すべてのヒストグラムチャンネルの CDF を計算し、要求された percentile（0.0 -- 1.0 の範囲の浮動小数点数）でのビン値を返します。

外れ値を無視しながらカラー分布の最小値/最大値を求めるのに便利です（get_percentile(0.05) と get_percentile(0.95) でロバストな最小値/最大値が得られます）。

Percentile の attrtuple を返します。

get_threshold() → image.threshold

すべてのチャンネルに対して大津の手法を使用し、各チャンネルの分布を「背景」と「前景」の半分に最もよく分割するしきい値を求めます。返されるしきい値は、Image.binary() や LAB L/A/B カラーしきい値を取るその他のメソッドに直接渡すのに適しています。

Threshold の attrtuple を返します。

get_statistics() → image.statistics

すべてのヒストグラムチャンネルの平均値、中央値、最頻値、標準偏差、最小値、最大値、第1四分位数、第3四分位数を計算します。

Statistics の attrtuple を返します。

get_stats() → image.statistics

get_statistics() のエイリアスです。

statistics() → image.statistics

get_statistics() のエイリアスです。