Debug Input

هذا البلوك يكتب محتوى مدخله إلى نافذة السجل (log) حتى تتمكن من فحص القيم أثناء زمن التشغيل. مفيد لإجراء فحوصات سريعة أثناء تصميم السيناريو ولأغراض استكشاف الأخطاء وإصلاحها.

📥 المدخلات

Input بيانات عامة للفحص. إذا كان المدخل صورة، سيعرض السجل ملخصًا للصورة (min, max, std, size). بالنسبة لأنواع البيانات الأخرى، يعرض السجل تمثيلًا قابلاً للقراءة.

📤 المخرجات

هذا البلوك لا ينتج أية مخرجات.

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

Controls لا شيء — هذا البلوك لا يحتوي على عناصر تفاعلية.

🎯 الميزات

• فحص بسيط أثناء التشغيل لأي بيانات متصلة.

• تلخيص تلقائي للصور عند استلام مصفوفات الصور (يعرض min، max، standard deviation والأبعاد).

• خفيف الوزن: مخصص للفحوصات السريعة وتصحيح الأخطاء أثناء بناء سير العمل.

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

1. قم بتوصيل البيانات التي تريد فحصها بمقبس Input.

2. شغّل السيناريو. سيُطبع محتوى Input في نافذة السجل في كل مرة يتم فيها تقييم البلوك.

3. استخدم مخرجات السجل للتحقق من القيم المتوقعة، أشكال البيانات، أو لاكتشاف قيم None/فارغة غير متوقعة.

📊 التقييم

عند التقييم، يقرأ هذا البلوك المدخل الحالي وينشر رسالة وصفية في السجل. تُلخّص الصور؛ وتُحوّل أنواع البيانات الأخرى إلى نص قابل للقراءة قبل التسجيل.

💡 نصائح وحيل

• استخدم Is None قبل هذا البلوك لتجنب تسجيل قيم None المتكررة ولتصفية البيانات ذات المغزى فقط.

• اجمعه مع Rising Edge أو Logic Input لتسجيل الدخول فقط عند أحداث محددة (مثل عندما تصبح حالة ما true) ليبقى السجل قابلاً للقراءة.

• عند فحص تدفقات الصور، اجمعه مع Show Image للتأكد بصريًا مما تشير إليه ملخصات الصورة.

• لحفظ القيم المفحوصة للتحليل لاحقًا، قم بتوجيه البيانات إلى Data Write Local أو Data Write Global واطلع عليها عبر Data Read Local / Data Read Global.

• إذا رغبت في تسجيل مصفوفات رقمية أو بيانات جدولة، ففكّر أيضًا في توصيل المخرجات إلى CSV Export للتسجيل الدائم.

• مجموعات مفيدة للفحوصات الشائعة:

  • فحوصات الكائنات البصرية: وصل المخرجات من Object Detection أو Find Object أو Mask Detection إلى هذا البلوك لفحص قوائم الاكتشاف والأعداد.

  • فحوصات OCR والنص: مرّر مخرجات من OCR أو OCR (EasyOCR) هنا للتحقق من النص المعترف به قبل التصدير.

  • تصحيح خطوات ما قبل المعالجة: ضع هذا البلوك بعد Blur أو Image Threshold أو HSV Filter لفحص النتائج الوسيطة.

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

• لا يوجد خرج في السجل: تأكد من توصيل البلوك وأن السيناريو قيد التشغيل. إذا لم يتم تقييم المدخل، جرّب إضافة مُشَغّل من الأعلى (مثل Logic Input أو Rising Edge).

• السجل يعرض هياكل كبيرة غير قابلة للقراءة: بالنسبة للصور الكبيرة أو القوائم الطويلة، استخدم Show Image أو احفظ البيانات باستخدام Image Logger / CSV Export بدلاً من الاعتماد فقط على السجل.

• رسائل متكررة ومطابقة تغمر السجل: استخدم بلوكات بوابة الأحداث مثل Rising Edge، All True، أو منطق البوابة (And / Or) لتقليل تكرار تقييم هذا البلوك.