> 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/data-logic/mathmetical-operations/math-operations.md).

# Math Operations

هذا بلوك دالّة يقوم بإجراء عمليات حسابية على عدد قابل للتحديد من المدخلات الرقمية. استخدمه لجمع القياسات، حساب النسب، المجاميع، الضرب أو الفرق في سير عمل بصري بسيط — دون حاجة للبرمجة.

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

`Number` أحد أو أكثر من مآخذ الإدخال الرقمية. يبدأ البلوك افتراضيًا بمدخلين رقميين ويمكن توسيع عددها حتى 20 مدخلاً باستخدام التحكم أدناه.

ملاحظة: يتم تجاهل المآخذ غير المتصلة عند تشغيل البلوك. تُستخدم فقط القيم الرقمية المتصلة في الحساب.

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

`Number` النتيجة الرقمية للحساب الذي تم تطبيقه على المدخلات المقدمة.

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

`Input size` اختر عدد مآخذ الإدخال الرقمية المراد توفيرها (2–20). سيضيف أو يزيل البلوك مآخذ الإدخال لتوافق هذا الإعداد.

`Select a method` اختر طريقة الحساب التي سيتم تطبيقها عبر المدخلات المقدمة. الطرق المتاحة: ADD, SUBTRACT, MULTIPLY, DIVIDE.

## ⚙️ آلية التشغيل <a href="#running-mechanism" id="running-mechanism"></a>

* يقرأ البلوك جميع المدخلات الرقمية المتصلة عند تشغيله.
* يطبق الطريقة المختارة عبر تلك القيم:
  * ADD: يجمع جميع المدخلات.
  * SUBTRACT: يطرح مجموع جميع المدخلات التالية من المدخل الأول.
  * MULTIPLY: يضرب جميع المدخلات معًا.
  * DIVIDE: يقوم بقسمة متتابعة بدءًا من المدخل الأول على كل مدخل تالٍ.
* تُعرض النتيجة الرقمية المفردة المحسوبة على مخرج `Number`.

يقوم هذا البلوك بتخطي المآخذ الفارغة/غير المتصلة تلقائيًا بحيث يمكنك تغيير عدد المدخلات دون إعادة تكوين الأسلاك.

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

* عدد مدخلات قابل للتوسيع (2–20) لحسابات مرنة.
* عناصر تحكم واجهة بسيطة لتبديل طريقة الحساب فورًا.
* يتجاهل المدخلات غير المتصلة لتجنب الأخطاء عند توصيل أنظمة ديناميكية.
* مصمم للتجميع البصري مع بلوكات القياس والمنطق الأخرى.

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

1. اضبط `Input size` على عدد القيم التي تريد دمجها.
2. قم بتوصيل بلوكات توليد الأرقام (حساسات، عدادات، نواتج قياس، إدخالات يدوية) بمآخذ الإدخال الرقمية.
3. اختر العملية المطلوبة باستخدام `Select a method`.
4. اقرأ النتيجة من المخرج `Number` وقم بتغذيتها إلى البلوكات التالية (التسجيل، العتبات، أو المحركات).

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

* اجمع مع `Number Input` عندما تحتاج إلى قيمة يدوية كجزء من الحساب (للتعويض أو العتبات).
* استخدم مع `Counter` أو `Get Batch Size` لحساب المتوسطات، المعدلات، أو النسب من القيم المحسوبة.
* قم بتغذية نواتج بلوكات القياس مثل `Measure Position Distance` أو `Image Resolution and Channel Value` إلى هذا البلوك لاشتقاق مقاييس مشتقة (مثل المسافة لكل بكسل أو الأحجام المعيارية).
* بعد العملية الحسابية، استخدم `Round` أو `Absolute` لتنسيق النتيجة قبل العرض أو التسجيل.
* لحساب قيم عنصر-إلى-عنصر أو مجمعة من قوائم، قم بالإقران مع `Get Element` أو بلوكات التحكم في الدُفعات لاستخراج الأرقام الفردية أولاً.

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

* إذا كانت النتيجة غير متوقعة، فتأكد من أن جميع المدخلات المطلوبة متصلة وتحتوي على قيم رقمية (استخدم `Number Input` أو بلوكات التصحيح للتحقق).
* بالنسبة للقسمة، تأكد من أن أي من مآخذ المقسوم عليه ليست صفرًا لتجنب نتائج غير صالحة.
* إذا قمت بتغيير `Input size` وظهرت وصلات غير متوقعة، فأعد التحقق من الاتصالات — إضافة/إزالة المآخذ قد يغيّر ترتيب الإدخال.

استخدم هذا البلوك للحفاظ على العمليات الحسابية بسيطة وبصرية عند بناء أنابيب القياس أو اتخاذ القرار.