For the complete documentation index, see llms.txt. This page is also available as Markdown.

Hull Convex

يقوم هذا البلوك الوظيفي بحساب محيط محدب (convex hull) يحيط بالـ contour المُزوَّد ويعيد نتائج بصرية ورقمية مفيدة لتحليل الشكل.

📥 المدخلات

Image الصورة المصدرية المستخدمة للعرض والقياسات.

Contour الكنتور (الشكل) المدخل الذي سيتم حساب المحيط المحدب له.

📤 المخرجات

Image الصورة المصدرية بعد وضع التعليقات التوضيحية (annotated) التي تُظهر الكنتور الأصلي والمحيط المحدب.

Contour الكنتور الناتج للمحيط المحدب معاد كشكّل (shape).

Center مركز الكتلة (centroid) للمحيط المحدب (x, y).

Area مساحة المحيط المحدب.

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

لا يحتوي هذا البلوك على عناصر تحكم تفاعلية. يعمل تلقائيًا عند توفير المدخلات.

🎯 ماذا يفعل

  • يحسب محيطًا محدبًا يغطي الكنتور المزوَّد.

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

  • يحسب مساحة الـ hull وإحداثيات مركز الكتلة لاستخدامها في قياسات لاحقة أو منطق تحكم.

  • يُرجع مخرجات بصرية مع التعليقات التوضيحية بالإضافة إلى المخرجات المهيكلة للشكل والقياسات للمعالجة اللاحقة.

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

  1. أدخل الصورة الأصلية في مدخل Image ليتمكن البلوك من إنتاج نتيجة بصرية مع التعليقات التوضيحية.

  2. أدخل كانتور مكتشف في مدخل Contour لحساب المحيط المحدب الخاص به.

  3. استخدم Image المُعلّم لمعاينة الفرق بين الكنتور والمحيط المحدب، واستعن بـ Contour و Center و Area للقياسات أو الفلترة أو التقارير.

📊 التقييم

عند التشغيل، يقوم البلوك بفحص الكنتور المزوَّد، ينتج كنتور المحيط المحدب، يعلّم الصورة بكلتا الشكلين، يحسب مركز الكتلة والمساحة، ويُخرج هذه النتائج الأربعة: صورة معنونة، كنتور الـ hull، نقطة المركز، والمساحة.

💡 نصائح وحيل

  • إذا لم يكن لديك كانتور بعد، استخدم البلوك Find Contour أو Find Object للحصول على كنتورات من الصورة قبل تمريرها لهذا البلوك.

  • لتبسيط الكنتورات المعقدة قبل حساب الـ hull، فكر في استخدام Approximate Contour لتقليل عدد النقاط وتحسين الأداء.

  • استخدم Minimum Rectangle، Minimum Circle أو Minimum Ellipse بعد هذا البلوك إذا احتجت أشكال احتوائية بديلة أو واصفات هندسية إضافية.

  • حضّر الصورة مسبقًا باستخدام Image Threshold أو Image Adaptive Threshold أو Blur للحصول على كنتورات أنظف وزيادة موثوقية حساب الـ hull.

  • ركّز التحليل أو اقتطع المنطقة باستخدام Image ROI، Image ROI Select أو Image ROI Polygon بحيث يستهدف استخراج الكنتور وحساب الـ hull المنطقة ذات الاهتمام.

  • اعرض النتائج في نافذة أكبر باستخدام Show Image واحفظ الإطارات المهمة باستخدام Image Logger أو Image Write للتوثيق أو المراجعة لاحقًا.

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

  • إذا كان الإخراج Contour فارغًا أو كانت الـ Area صفرًا: تأكد من أن مدخل Contour صالح ويحتوي على نقاط كافية. استخدم بلوكات توليد الكنتور (Find Contour, Find Object) وتحقق من مخرجاتها.

  • إذا بدت التعليقات التوضيحية غير متوافقة بعد تغيير قياس الصورة: تأكد من استخدام نفس أبعاد الصورة عبر كامل المسار (استخدم Image Resize أو Image Resizer بشكل متسق).

  • إذا كانت أشكال الخلفية غير المرغوب فيها تنتج محيطات محدبة كبيرة: جرّب المعالجة المسبقة (thresholding, blurring) واستخدم بلوكات ROI للتركيز على الكائن المطلوب.

آخر تحديث