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

# Square Root

بلاطة دالة حسابية بسيطة تحسب الجذر التربيعي لقيمة رقمية. استخدم هذا البلوك عندما تحتاج إلى الجذر الموجب لعدد غير سالب داخل السيناريو الخاص بك.

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

`Number` القيمة الرقمية التي تريد حساب الجذر التربيعي لها. قدّم قيمة غير سالبة للحصول على نتائج صالحة.

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

`Number` قيمة الجذر التربيعي الناتجة.

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

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

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

عند استلام البلوك لقيمة رقمية، ينتج في كل دورة تقييم الجذر التربيعي لتلك القيمة في مخرجه. إذا كانت القيمة مفقودة أو غير صالحة للجذر التربيعي (مثلاً قيمة سالبة)، فلن يعطي البلوك نتيجة رقمية مفيدة — لذلك من الأفضل التحقق من المدخلات قبل تمريرها.

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

* عملية حسابية فورية مناسبة لسير العمل الحي.
* واجهة مستخدم بسيطة وموفرة للمساحة — مصمم ليتم دمجه مع بلوكات رياضية ومنطقية أخرى.
* يعمل بسلاسة ضمن سلاسل حسابية (مثلاً دمجه مع بلوكات `Multiply` أو `Divide`).

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

1. أدخل قيمة رقمية في مقبس `Number` (مثلاً من بلوك `Number Input` أو مخرج بلوك حسابي آخر).
2. اقرأ النتيجة من مقبس المخرج `Number`.
3. إذا كنت تتوقع مدخلات سالبة، قم بالتحقق أولاً (انظر النصائح أدناه).

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

* استخدم `Number Input` لإدخال القيم يدويًا أثناء الاختبار أو ضبط المعاملات.
* تحقق من عدم سلبية المدخل باستخدام بلوك `Greater` قبل الاتصال لتجنّب القيم غير الصالحة.
* إذا أردت حساب الجذر التربيعي للقيمة المطلقة، استخدم بلوك `Absolute` قبل هذا البلوك.
* قرّب النتائج للعرض باستخدام بلوك `Round` إذا احتجت إلى عدد أقل من الأرقام العشرية.
* استخدم بلوكات `Multiply` أو `Divide` قبل/بعد لتغيير نطاق القيم حسب الحاجة.
* تصوّر اتجاهات الأرقام باستخدام `Scope` أو سجّل القيم باستخدام `CSV Export` أو `Data to JSON` للمراقبة.

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

* إذا بدت النتيجة غير صحيحة، تأكد أن قيمة المدخل غير سالبة.
* إذا لم يظهر أي قيمة، تأكد من أن مقبس المدخل متصل (مثلاً من `Number Input` أو بلوك حسابي آخر).
* استخدم سلسلة فحص بسيطة (مثل `Greater` → تيار شرطي) لمنع المدخلات غير الصالحة من الوصول إلى هذا البلوك.