class Histogram -- Objek Histogram¶

Objek histogram dikembalikan oleh Image.get_histogram(). Nama kelas dasarnya adalah histogram.

Untuk citra skala abu-abu, histogram memiliki satu saluran bin. Untuk citra RGB565, histogram memiliki tiga saluran yang mencakup sumbu CIE-LAB L, A, dan B. Dalam kedua kasus, setiap saluran dinormalisasi sehingga jumlah bin-nya adalah 1.0.

Daftar bin per saluran ditampilkan baik sebagai metode terikat (hist.bins()) maupun melalui notasi subskrip (hist[0]). Reduksi tingkat tinggi get_percentile(), get_threshold(), dan get_statistics() mengembalikan attrtuple Percentile, Threshold, dan Statistics yang sesuai.

class image.histogram¶

Panggil Image.get_histogram() untuk membuat objek ini. Objek ini tidak memiliki konstruktor publik.

bins() → list[float]¶

Kembalikan daftar bin untuk histogram skala abu-abu. Setiap entri berada dalam rentang 0.0 hingga 1.0 dan jumlah semua entri adalah 1.0.

Setara dengan histogram[0].

l_bins() → list[float]¶

Kembalikan daftar bin untuk saluran LAB L dari histogram RGB565. Setiap entri berada dalam rentang 0.0 hingga 1.0 dan jumlah semua entri adalah 1.0.

Setara dengan histogram[0].

a_bins() → list[float]¶

Kembalikan daftar bin untuk saluran LAB A dari histogram RGB565. Setiap entri berada dalam rentang 0.0 hingga 1.0 dan jumlah semua entri adalah 1.0.

Setara dengan histogram[1].

b_bins() → list[float]¶

Kembalikan daftar bin untuk saluran LAB B dari histogram RGB565. Setiap entri berada dalam rentang 0.0 hingga 1.0 dan jumlah semua entri adalah 1.0.

Setara dengan histogram[2].

get_percentile(percentile: float) → image.percentile¶

Hitung CDF dari setiap saluran histogram dan kembalikan nilai bin pada percentile yang diminta (float dalam 0.0 -- 1.0).

Berguna untuk menemukan nilai min/maks dari distribusi warna sambil mengabaikan pencilan (get_percentile(0.05) dan get_percentile(0.95) memberikan min/maks yang lebih andal).

Mengembalikan attrtuple Percentile.

get_threshold() → image.threshold¶

Gunakan Metode Otsu pada setiap saluran untuk menemukan nilai ambang batas yang paling baik memisahkan distribusi setiap saluran menjadi separuh "latar belakang" dan "latar depan". Ambang batas yang dikembalikan sangat cocok untuk dimasukkan langsung ke Image.binary() atau metode lain yang menerima ambang batas warna LAB L/A/B.

Mengembalikan attrtuple Threshold.

get_statistics() → image.statistics¶

Hitung rata-rata, median, modus, standar deviasi, min, maks, kuartil bawah, dan kuartil atas dari setiap saluran histogram.

Mengembalikan attrtuple Statistics.

get_stats() → image.statistics¶: Alias untuk get_statistics().

statistics() → image.statistics¶: Alias untuk get_statistics().