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

# Add

هذه الدالة تقوم بجمع عدة قيم رقمية وإنتاج نتيجة رقمية واحدة. وهي مثالية لتجميع العدادات، قراءات الحساسات، أو الأرقام المحسوبة من دوال أخرى.

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

`Number` واحد أو أكثر من المدخلات الرقمية. الإعداد الافتراضي يوفر مدخلين، لكن يمكنك تغيير عدد المدخلات باستخدام التحكم الموضح أدناه.\
(كل مدخل يقبل أي قيمة رقمية تنتجها وظائف أخرى.)

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

`Number` مجموع جميع المدخلات الرقمية المتصلة.

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

`Input size` قائمة منسدلة لاختيار عدد مقابس المدخلات الرقمية التي يوفرها البلوك. تغيير هذه القيمة سيضيف أو يزيل مقابس بحيث يمكنك جمع قيم أكثر أو أقل.

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

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

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

1. استخدم تحكم `Input size` لتعيين عدد المدخلات الرقمية التي تحتاجها.
2. وصل المخرجات الرقمية من الكتل الأخرى بمداخل `Number` الموجودة.
3. اقرأ النتيجة المجمعة من مخرج `Number` للبلوك ومرّرها إلى الكتل التالية.

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

عند التشغيل، يقوم هذا البلوك بجمع جميع القيم الرقمية المتصلة بمداخله حالياً ويخرج المجموع كقيمة رقمية واحدة.

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

* اجمع القيم اليدوية باستخدام بلوك `Number Input` لإنشاء نقاط ضبط أو تعويضات قبل المعالجة اللاحقة.
* اجمع العدادات من عدة كواشف عن طريق توصيل مخرجات `Object Count` الخاصة بهم (على سبيل المثال من `Object Detection`) إلى هذا البلوك للحصول على إجمالي عدد الأجسام.
* استخدمه مع `Counter` لتجميع الأحداث ومع `Get Batch Size` عند معالجة دفعات لحساب الإجمالي لكل دفعة.
* اربطه مع `Divide` لحساب المتوسط (sum ÷ count) أو مع `Round` لتنسيق النتائج الرقمية للعرض/التصدير.
* استخدمه إلى جانب بلوكات التحليل مثل `Mean Value of Image` أو `Measure Position Distance` لدمج نتائج القياس في قيمة ملخّصة واحدة.

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

* إذا كان المخرج أقل مما تتوقع، تحقق من أن جميع المصادر الرقمية المقصودة متصلة بالبلوك.
* إذا غيرت `Input size` ولم يظهر عدد المقابس المتوقع، أعد فتح التخطيط أو أعد اختيار خيار `Input size` لتحديث عرض المقابس.
* يتم تجاهل المدخلات غير الرقمية أو المفقودة؛ تأكد أن الكتل العليا تنتج قيماً رقمية قبل الاتصال.