> 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/structural-similarity.md).

# Structural Similarity

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

## 📥 Inputs (sockets)

`Image Any` الصورة الأولى للمقارنة.\
`Image Any` الصورة الثانية للمقارنة.

ملاحظة: يجب أن يكون كلا الصورتين بنفس الدقة وعدد القنوات لإجراء مقارنة صحيحة.

## 📤 Outputs (sockets)

`Similarity Percentage` قيمة رقمية بين 0 و100 تمثل التشابه البنيوي بين المدخلين.

## 🕹️ Controls

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

## 🎯 Features

* يعيد قيمة تشابه رقمية واحدة سهلة الاستخدام في العتبات ومنطق اتخاذ القرار.
* يعمل مباشرة مع الصور الملونة أو الرمادية (بشرط تطابق الأبعاد).
* سهل الدمج في سير عمل الفحص الآلي لعمليات قبول/رفض.

## ⚙️ Running mechanism

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

## 📝 Usage

1. أوصل صورتين إلى مقابس الإدخال.
2. تأكد أن كلا الصورتين لهما نفس الأبعاد وعدد القنوات.
3. اقرأ مخرج `Similarity Percentage` واستخدمه في السجلات، اتخاذ القرار، أو المنطق اللاحق.

## 💡 Tips and Tricks

* للتأكد من تطابق الأحجام، استخدم `Image Resize` أو `Image Resizer` قبل هذا البلوك.
* إذا كانت الصور قد تكون مدورة أو مزاحة، أضف `Auto Alignment` لمحاذاتها أولًا للحصول على مقارنة أكثر معنوية.
* للتركيز على منطقة محددة، اقتطع باستخدام `Image ROI Select` ومرّر الصور المقتطعة إلى هذا البلوك.
* عيّن الفروقات في الشدة أو التباين باستخدام `Normalize Image` أو `Contrast-Brightness-Gamma` لتقليل الاختلافات الكاذبة الناتجة عن الإضاءة.
* استخدم `Image AutoRotator` إذا اختلفت اتجاهات المدخلات بين المصادر.
* اعرض المدخلات عبر `Show Image` لتفقد ما الذي تتم مقارنته.
* سجّل أو احفظ صور المقارنة والنتائج باستخدام `Image Logger` أو `Image Write` لتتبع الإجراءات.
* افحص السطوع والحجم بسرعة باستخدام `Mean Value of Image` أو `Image Resolution and Channel Value` قبل المقارنة.

## 🛠️ Troubleshooting

* إذا ظهر خطأ متعلقًا بحجم الصورة، تأكد أن كلا المدخلين لهما نفس العرض والارتفاع وعدد القنوات. فكّر باستخدام `Image Resize`.
* تشابه منخفض بشكل غير متوقع رغم أن الصور تبدو متشابهة قد يدل على سوء محاذاة، اختلاف نطاق الألوان، أو اختلاف مناطق القص — جرّب `Auto Alignment`، `Normalize Image`، أو القص بـ `Image ROI Select`.
* إذا لم يظهر مخرج، تحقق من توصيل كلا المقابس وأنهما لا يرسلان قيمة `None`. استخدم `Show Image` أو بلوكات تصحيح الأخطاء للتحقق من البيانات الواردة.