Histogram On Line

This function block analyzes pixel values along a single defined line in a grayscale or binary image. It detects segments where pixel values exceed a threshold and visualizes the line and found segments on an output image.

📥 المدخلات

Input Image (Binary Image) صورة ثنائية أو رمادية اللون تُستخدم لتحليل الخط.

📤 المخرجات

Output Image الصورة المصدر مع تعليمات توضح الخط والمناطق المكتشفة.

Peak Count عدد المقاطع المكتشفة على طول الخط التي تتجاوز العتبة.

Peak Start Locations قائمة بإحداثيات نقاط بداية كل مقطع مكتشف.

Peak End Locations قائمة بإحداثيات نقاط نهاية كل مقطع مكتشف.

Peak Mean Locations قائمة بإحداثيات المركز (المتوسط) لكل مقطع مكتشف.

🕹️ عناصر التحكم

Relation قائمة منسدلة لاختيار اتجاه الخط (عمودي أو أفقي).

Line Location شريط تمرير / إدخال لتحديد موقع الخط بالبكسل (قيمة مفردة). يتم التحقق من القيمة بالنسبة لأبعاد الصورة.

Pixel Threshold شريط تمرير / إدخال لقيمة عتبة البكسل (0–255) المستخدمة لتحديد المقاطع النشطة.

🎨 الميزات

• تغذية بصرية تُظهر خطًا أحمر وعلامات ملونة لبداية المقطع ونهايته وموقع المتوسط.

• يقبل خطوطًا رأسية أو أفقية ويتحقق من صلاحية موقع الخط مقابل أبعاد الصورة.

• يتجاهل المقاطع التي تلامس حواف الصورة (سلوك داخلي قابل للتكوين) لتجنب تأثير الحواف.

• يعيد مخرجات بصرية ومهيكلة للاستخدام في خطوات لاحقة.

📝 تعليمات الاستخدام

1. قدّم صورة رمادية أو ثنائية إلى مدخل Input Image (Binary Image).

2. اختر اتجاه الخط باستخدام Relation.

3. اضبط Line Location (مؤشر البكسل) داخل حدود الصورة.

4. اضبط Pixel Threshold بين 0 و255 للتحكم في الحساسية.

5. شغّل البلوك للحصول على صورة معلمة وقوائم بإحداثيات المقاطع المكتشفة.

📊 التقييم

عند التنفيذ، يأخذ البلوك عينات من قيم البكسل على طول الخط المختار، يجد المقاطع المتجاورة التي تفي أو تتجاوز العتبة، يعلمها على الصورة المخرجة، ويُرجع عدد المقاطع وقوائم الإحداثيات.

💡 نصائح وحيل

• قم بعمل معالجة مسبقة للمدخلات المزعجة باستخدام Blur لتقليل الاكتشافات العشوائية وImage Threshold لإنشاء صورة ثنائية نظيفة قبل تحليل الخط.

• استخدم Image ROI Select أو Image ROI لاقتصاص منطقة الاهتمام بحيث تكون إحداثيات الخط أبسط وأكثر معنى.

• ادمجه مع Draw Line إذا رغبت في وضع تفاعلي للخط على الصورة المعروضة، ثم انسخ موقع البكسل إلى Line Location.

• استخدم HSV Filter لعزل قنوات اللون أو الميزات قبل التحويل إلى تدرج الرمادي للحصول على اكتشاف ذروة أكثر موثوقية.

• افحص النتائج بصريًا بربط Output Image إلى Show Image لفتح عرض أكبر والتحقق من المقاطع المكتشفة.

• إذا كان تدفقك قد يُنتج صورًا فارغة، ففكّر في استخدام Is None لحماية المنطق اللاحق من النتائج المفقودة.

🛠️ استكشاف الأخطاء وإصلاحها

• إذا لم يتم العثور على أي قمم، جرّب خفض Pixel Threshold أو قم بالمعالجة المسبقة باستخدام Image Threshold / Blur.

• إذا تسببت موضع الخط في أخطاء، تأكد أن Line Location ضمن عرض الصورة (للخط العمودي) أو ارتفاع الصورة (للخط الأفقي). سيُبلغ البلوك عن القيم خارج النطاق وسيقوم بقصها.

• إذا ظهرت العديد من المقاطع الصغيرة، زد العتبة أو قم بتنعيم الصورة أولًا باستخدام Blur.