class Histogram -- كائن Histogram¶

كائن المدرج التكراري يُعيده Image.get_histogram(). اسم الفئة الأساسية هو histogram.

بالنسبة لصور تدرج الرمادي يملك المدرج التكراري قناة واحدة من الفئات. وبالنسبة لصور RGB565 يملك المدرج التكراري ثلاث قنوات تغطي محاور CIE-LAB وهي L وA وB. في كلتا الحالتين تُطبَّع كل قناة بحيث يكون مجموع فئاتها 1.0.

تُعرَض قوائم الفئات لكل قناة كطرق مرتبطة (hist.bins()) ومن خلال تدوين الفهرسة (hist[0]). تُعيد الاختزالات عالية المستوى get_percentile() وget_threshold() وget_statistics() الـ attrtuples المقابلة Percentile وThreshold وStatistics.

class image.histogram¶

يرجى استدعاء Image.get_histogram() لإنشاء هذا الكائن. لا يملك مُنشئًا عامًا.

bins() → list[float]¶

إعادة قائمة الفئات لمدرج تكراري بتدرج الرمادي. كل مدخل في المدى 0.0 إلى 1.0 ومجموع المدخلات يساوي 1.0.

مكافئ لـ histogram[0].

l_bins() → list[float]¶

إعادة قائمة الفئات لقناة LAB L لمدرج تكراري بصيغة RGB565. كل مدخل في المدى 0.0 إلى 1.0 ومجموع المدخلات يساوي 1.0.

مكافئ لـ histogram[0].

a_bins() → list[float]¶

إعادة قائمة الفئات لقناة LAB A لمدرج تكراري بصيغة RGB565. كل مدخل في المدى 0.0 إلى 1.0 ومجموع المدخلات يساوي 1.0.

مكافئ لـ histogram[1].

b_bins() → list[float]¶

إعادة قائمة الفئات لقناة LAB B لمدرج تكراري بصيغة 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() أو أي طريقة أخرى تأخذ عتبات لون LAB L/A/B.

يُعيد attrtuple من نوع Threshold.

get_statistics() → image.statistics¶

حساب المتوسط والوسيط والمنوال والانحراف المعياري والقيمة الدنيا والقصوى والربيع الأدنى والربيع الأعلى لكل قناة من قنوات المدرج التكراري.

يُعيد attrtuple من نوع Statistics.

get_stats() → image.statistics¶: اسم بديل لـ get_statistics().

statistics() → image.statistics¶: اسم بديل لـ get_statistics().