> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/detections-shapes/shape-analysis/most-similar-shape.md).

# Most Similar Shape

تقوم هذه الدالة بمقارنة محيط مرجعي مع قائمة من المحيطات المرشحة وتختار الأكثر تشابهًا. تعيد المحيط الأفضل تطابقًا، ودرجة تشابه (0-1)، وصورة مشروحة تُظهر المحيط المختار.

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

* `Contour` المحيط المرجعي المستخدم للمقارنة
* `Contour(s)` قائمة المحيطات المرشحة للمقارنة
* `Image` صورة اختيارية تُستخدم للإخراج المرئي/التعليق

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

* `Most Similar` المحيط من القائمة المرشحة الذي يطابق المرجع بأفضل شكل
* `Score (0-1)` درجة التشابه (1.0 تعني متطابق تمامًا، والقيم الأقل تعني تشابهًا أقل)
* `Image Any` صورة مشروحة اختيارية تُبرز المحيط المحدد

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

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

## 🎨 الميزات <a href="#features" id="features"></a>

* مقارنة سريعة للأشكال لإيجاد أقرب تطابق ضمن قائمة.
* يُنتج درجة تشابه رقمية بالإضافة إلى نتيجة مرئية للتحقق.
* يعمل مع أي صيغة محيط يدعمها النظام.

## 📝 طريقة الاستخدام <a href="#usage" id="usage"></a>

1. زوّد مدخل `Contour` بالمحيط المرجعي.
2. زوّد مدخل `Contour(s)` بمحيط واحد أو أكثر من المرشحين.
3. اختياريًا، أدخل صورة في `Image` للحصول على نتيجة مرئية مشروحة تُظهر المحيط المختار.
4. شغّل السيناريو؛ ستتضمن المخرجات المحيط المُختار، درجة التشابه، والصورة المشروحة إن وُفِّرت.

## 📊 التقييم <a href="#evaluation" id="evaluation"></a>

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

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* لاستخراج المحيطات من صورة ثنائية أولًا، استخدم `Find Contour` للحصول على محيطات مناسبة للمقارنة.
* استخدم `Approximate Contour` لتبسيط المحيطات (تقليل عدد النقاط) قبل المقارنة عندما تكون الأشكال بها ضوضاء أو تفاصيل زائدة.
* ادمج مع `Hull Convex` لمقارنة الأصداف المحدبة بدلًا من المحيطات الخام عندما يكون التشابه في الشكل الخارجي هو المطلوب.
* استخدم `Minimum Rectangle` أو `Minimum Ellipse` أو `Minimum Circle` لتحويل المحيطات إلى أوصاف هندسية بسيطة كاستراتيجية مقارنة بديلة.
* قم بعمليات ما قبل المعالجة مثل `Blur` أو `Denoising` أو `Image Threshold` لتقليل الضوضاء وتحسين استخراج المحيط.
* إذا رغبت في معاينة النتيجة بصريًا، صِل مخرج الصورة المشروحة إلى `Show Image`.
* استخدم `Contour to Image` لقص أو عزل المنطقة حول محيط لمزيد من الفحص أو المعالجة لاحقًا.
* ارسم المحيط المختار على الإخراج الحي باستخدام `Draw Result On Image` أو `Draw Detections` لعرض أوضح في لوحات المراقبة.
* إذا كنت تحتاج مقارنة داخل منطقة فرعية فقط، اقص الصورة أولًا باستخدام `Image ROI` أو `Image ROI Select` لتقليل المرشحين وتسريع المعالجة.
* للمقارنات على دفعات عبر مناطق متعددة، استخدم `Image ROI Polygon` أو `Image ROI Polygon Multi` لتوليد مناطق متعددة وإدخال محيطاتها في هذا البلوك.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* إذا كانت درجات التشابه منخفضة بشكل غير متوقع، تأكد من استخراج المحيطات من صورة ثنائية نظيفة (استخدم `Image Threshold` و`Blur` عند الحاجة).
* إذا حصلت على عدة مرشحين بدرجات متقاربة، بسط المحيطات باستخدام `Approximate Contour` أو قارن الأشكال المحيطة (`Minimum Rectangle`, `Minimum Ellipse`) لتقليل الحساسية للفروقات الصغيرة.
* إذا لم تظهر النتيجة المرئية للمحيط المحدد، فتأكد من تزويد مدخل `Image` بصورة أو ربط مخرج البلوك إلى `Show Image` للمعاينة.