> 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/minimum-ellipse.md).

# Minimum Ellipse

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

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

`Image Any` الصورة التي سيُرسم عليها القطع الناقص (مقبس الإدخال). زود نسخة قابلة للنسخ من الصورة للحفاظ على الإخراج المرئي.

`Contour` الـ contour (الشكل) الذي سيُحتوى داخل القطع الناقص الأصغر (مقبس الإدخال).

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

`Image` الصورة مع القطع الناقص الملائم مرسومًا عليها للاطلاع البصري (مقبس الإخراج).

`Center` موضع مركز القطع الناقص كنقطة (مقبس الإخراج).

`Radius1` أحد أنصاف أقطار القطع الناقص (مقبس الإخراج).

`Radius2` القطر/نصف القطر الآخر للقطع الناقص (مقبس الإخراج).

`Angle` زاوية دوران القطع الناقص بالدرجات (مقبس الإخراج).

## 🕹️ الضوابط <a href="#controls" id="controls"></a>

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

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

* تنتج تراكبًا مرئيًا يعرض القطع الناقص الملائم على الصورة المدخلة للتحقق السريع.
* تُرجع معلمات هندسية (Center، واثنان من الأنصاف أقطار، وAngle) مفيدة للقياسات أو التصنيف أو المنطق اللاحق.
* تعمل مع أي contour صالح مستخرج من خطوة معالجة سابقة.

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

1. زود صورة في `Image Any`.
2. زود الـ `Contour` الذي تريد تحليله. تأتي أشكال الـ contour عادةً من كتل استخراج الكونتور.
3. اطلع على النتيجة البصرية من `Image` والقيم العددية من `Center` و`Radius1` و`Radius2` و`Angle` للاستخدام اللاحق.

## ⚙️ ما الذي تفعله عند التشغيل <a href="#evaluation" id="evaluation"></a>

تقوم الكتلة بملائمة قطع ناقص يغطي أقل مساحة ممكنة حول الـ contour المزوّد، ترسم القطع الناقص على نسخة من الصورة المدخلة، وتُخرج الصورة إلى جانب المعلمات العددية للقطع الناقص.

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

* إذا كنت بحاجة إلى contours من صورة، استخدم `Find Contour` أو `Find Object` قبل هذه الكتلة لتوليد مدخل `Contour` صالح.
* استخدم `Approximate Contour` لتبسيط contours المعقدة قبل ملائمة القطع الناقص — غالبًا ما يعطي ذلك معلمات أنظف وأكثر استقرارًا.
* استخدم `Image Threshold` أو `Image Adaptive Threshold` أو `Blur` كمعالجة مسبقة لتحسين استخراج الكونتور من الصور المزعجة.
* استخدم `Fill Contour` لتوليد أشكال صلبة من الكونتور المستند للحواف عندما يساعد ذلك في المعالجة اللاحقة.
* قارن الأشكال باستخدام `Minimum Circle` أو `Minimum Rotated Rectangle` إذا أردت بدائل هندسية أبسط كحدود محيطة.
* قم بتصوير النتائج باستخدام `Show Image` أو احفظها باستخدام `Image Write` / `Image Logger` للسجلات والتقارير.
* ادمج مع `Measure Position Distance` إذا كنت بحاجة لحساب المسافات بين مراكز القطع الناقص أو نقاط مرجعية أخرى.

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

* إذا بدا القطع الناقص غير صحيح، تأكد من أن الـ `Contour` المزوّد صالح (مغلق وبنقاط كافية). جرّب تبسيط الكونتور باستخدام `Approximate Contour`.
* إذا لم يُنتج أي كونتور في الخطوات السابقة، تأكد من تطبيق خطوات المعالجة المسبقة مثل العتبة أو التمويه حتى تتمكن كتل العثور على الكونتور من اكتشاف الأشكال.
* إذا بدت القيم المعادة لأنصاف الأقطار أو الزاوية غير مستقرة بين الإطارات، طبق تسهيلًا (smoothing) أو استخدم كتل الذاكرة لتثبيت القياسات عبر الزمن.