> 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/image-transformations/analysis/histogram-on-curve.md).

# Histogram On Curve

هذا البلوك الوظيفي يقوم بتحليل قيم البكسل على طول خط منحني مكتشف ضمن صورة رمادية أو ثنائية. يكتشف نقاط الخط، يركب منحنى ناعم، يقيم قيم البكسل على طول هذا المنحنى مقابل عتبة محددة، ويعيد تصورات وصيغًا رقمية لمساعدتك على فحص جودة الخط والكشف عن فجوات أو قمم.

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

`Input Image (Binary Image)` الصورة الرمادية أو الثنائية التي ستتم تحليلها. يفضّل استخدام صورة ذات تباين قوي بين المقدّم والخلفية.

`Line Location (pixel)` عدد خطوط العينات المستخدم عند الكشف عن المنحنى (البلوك يأخذ عينات من عدة خطوط مستقيمة ويستخرج نقاط المنحنى).

`Line detection threshold` عتبة شدة البكسل المستخدمة أثناء كشف بكسلات الخط (النطاق الصالح 0–255).

`Pixel Value Threshold` عتبة شدة البكسل المستخدمة عند تقييم قيم البكسل على طول المنحنى المكتشف (النطاق الصالح 0–255).

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

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

`Plot Image` مخطط تصوري يظهر ملف تعريف البكسل ومعلومات التدرج المستخدمة أثناء الكشف.

`Curve Image` تصور للمنحنى المكتشف وقيم البكسل على طوله.

`Line Angle` زاوية المنحنى المركّب المقدرة (مفيدة لفحوصات الهندسة).

`Is Line Valid?` علامة منطقية تشير ما إذا كان المنحنى المكتشف يجتاز اختبارات الصلاحية الداخلية (مفيدة لتحديد ما إذا كان يجب متابعة المعالجة).

## 🕹️ أدوات التحكم <a href="#controls" id="controls"></a>

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

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

* يكتشف نقاط المنحنى عبر أخذ عينات لعدة خطوط مستقيمة عبر الصورة ومن ثم تركيب كثير حدٍّ ناعم عبر تلك النقاط.
* ينتج تعليقات مرئية على الصورة ورسومات تشخيصية لمساعدة المستخدم في التحقق من جودة الكشف.
* فحص صلاحية يُعلّم الاكتشافات غير الموثوقة حتى تتمكن كتل المعالجة التالية من التعامل مع الفشل.
* إمكانية ضبط العتبات وعدد خطوط العينة عبر المدخلات للتحكم الدقيق في الحساسية.

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

1. زوّد `Input Image (Binary Image)` بصورة رمادية أو ثنائية واضحة.
2. عيّن قيمة `Line Location (pixel)` لعدد خطوط العينات (قيمة أكبر تزيد من المتانة لكنها تبطئ الأداء).
3. اضبط `Line detection threshold` لتحديد بكسلات الخط بشكل موثوق على خطوط العينة.
4. اضبط `Pixel Value Threshold` لتمييز مناطق البكسل المهمة على طول المنحنى المركّب.
5. افحص `Output Image`, `Plot Image` و`Curve Image` للتحقق من الاكتشاف. استخدم `Is Line Valid?` لاتخاذ قرار بشأن استمرار المعالجة.

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

عند التنفيذ، يقوم البلوك بـ:

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

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

* قم بعمل معالجة مسبقة للصور ذات الضوضاء باستخدام `Blur` لتقليل القمم العشوائية قبل كشف المنحنى.
* استخدم `Image Threshold` لتحويل الصورة إلى ثنائية إذا كان تباين المنحنى منخفضًا — هذا يحسّن غالبًا موثوقية كشف الخط.
* قصر منطقة الاهتمام باستخدام `Image ROI Select` لكي يركز البلوك على المنطقة ذات الصلة ويتجنب الحواف غير المرغوب فيها.
* أرسل المخرجات المرئية إلى `Show Image` لفحص `Output Image` / `Plot Image` / `Curve Image` تفاعليًا أثناء ضبط المعاملات.
* إذا رغبت في حفظ نتائج التحليل للمراجعة لاحقًا، استخدم `Image Logger` أو `Image Write` مع الصور المعادة من هذا البلوك.

(تلميح: اجمع كتل المعالجة المسبقة مثل `Blur` و`Image Threshold` قبل هذا البلوك، ثم أدخل النتائج إلى هذا البلوك؛ صوّر النتائج باستخدام `Show Image` واحتفظ بها اختياريًا عبر `Image Logger` أو `Image Write`.)

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

* إذا ظهرت لك رسالة خطأ حول كشف خط غير صالح، جرّب زيادة عدد خطوط العينة (قيمة `Line Location (pixel)`) أو قم بالمعالجة المسبقة باستخدام `Blur` و`Image Threshold`.
* إذا لم تظهر قمم في المخططات، قلّل العتبات أو حسّن تباين `Input Image (Binary Image)`.
* إذا كان المنحنى المكتشف مُزاحًا أو مُزعجًا، قم بقص الصورة باستخدام `Image ROI Select` لإزالة المناطق المشتتة وحاول مرة أخرى.