class Histogram – אובייקט Histogram

אובייקט ההיסטוגרמה מוחזר על ידי Image.get_histogram(). שם המחלקה הבסיסית הוא histogram.

עבור תמונות בגווני אפור להיסטוגרמה יש ערוץ יחיד של תאים. עבור תמונות RGB565 להיסטוגרמה יש שלושה ערוצים המכסים את צירי L, A ו-B של CIE-LAB. בשני המקרים כל ערוץ מנורמל כך שסכום התאים שלו הוא 1.0.

רשימות התאים לכל ערוץ נחשפות הן כמתודות מאוגדות (hist.bins()) והן באמצעות סימון מינדקס (hist[0]). הצמצומים ברמה הגבוהה get_percentile(), get_threshold() ו-get_statistics() מחזירים את ה-attrtuple המתאימים Percentile, Threshold ו-Statistics.

class image.histogram

אנא קרא ל-Image.get_histogram() כדי ליצור אובייקט זה. אין לו בנאי ציבורי.

bins() → list[float]

מחזיר את רשימת התאים עבור היסטוגרמה בגווני אפור. כל ערך נמצא בטווח 0.0 עד 1.0 וסכום הערכים הוא 1.0.

שקול ל-histogram[0].

l_bins() → list[float]

מחזיר את רשימת התאים עבור ערוץ L של LAB בהיסטוגרמת RGB565. כל ערך נמצא בטווח 0.0 עד 1.0 וסכום הערכים הוא 1.0.

שקול ל-histogram[0].

a_bins() → list[float]

מחזיר את רשימת התאים עבור ערוץ A של LAB בהיסטוגרמת RGB565. כל ערך נמצא בטווח 0.0 עד 1.0 וסכום הערכים הוא 1.0.

שקול ל-histogram[1].

b_bins() → list[float]

מחזיר את רשימת התאים עבור ערוץ B של LAB בהיסטוגרמת RGB565. כל ערך נמצא בטווח 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) נותנים מינימום/מקסימום עמיד).

מחזיר attrtuple מסוג Percentile.

get_threshold() → image.threshold

משתמש בשיטת Otsu על כל ערוץ כדי למצוא את ערך הסף המפצל בצורה הטובה ביותר את התפלגות כל ערוץ לחצי ”רקע“ וחצי ”חזית“. ערכי הסף המוחזרים מתאימים היטב להזנה ישירה ל-Image.binary() או לכל מתודה אחרת המקבלת ספי צבע L/A/B של LAB.

מחזיר attrtuple מסוג Threshold.

get_statistics() → image.statistics

מחשב את הממוצע, החציון, השכיח, סטיית התקן, המינימום, המקסימום, הרבעון התחתון והרבעון העליון של כל ערוץ היסטוגרמה.

מחזיר attrtuple מסוג Statistics.

get_stats() → image.statistics

כינוי ל-get_statistics().

statistics() → image.statistics

כינוי ל-get_statistics().