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().