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

# Round

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

## 📥 المدخلات

`Number` القيمة الرقمية التي سيتم تقريبها. (Socket: Number)

## 📤 المخرجات

`Number` القيمة الرقمية بعد التقريب. (Socket: Number)

## 🕹️ الضوابط

`Decimals` يحدد عدد المنازل العشرية التي سيتم تقريب الرقم إليها. أدخل عددًا صحيحًا (مثل 0، 1، 2).

## 🎨 الميزات

* واجهة بسيطة للتحكم في دقة الأعداد عبر حقل نصي.
* يحول فورًا أي قيمة رقمية واردة من منفذ إلى قيمة مُنسقة للعرض أو الرسم أو التصدير.
* مفيد لتقليل الضوضاء في المقاييس المعروضة (مثل تقصير القيم العشرية الطويلة).

## 📝 تعليمات الاستخدام

1. أمدّ منفذ الإدخال `Number` بقيمة رقمية (مثال: نتيجة قياس أو عدّ).
2. اضبط الدقة المطلوبة باستخدام الضابط `Decimals`.
3. اقرأ النتيجة المقربة من منفذ الإخراج `Number` ومرّرها إلى كتل العرض أو السجلّات أو المعالجة اللاحقة.

## 📊 التقييم

عند التشغيل، تأخذ هذه الدالة القيمة الرقمية الواردة وتعيد نفس القيمة بعد تقريبها إلى عدد المنازل العشرية المحدّد في الضابط `Decimals`.

## 💡 نصائح وحيل

* عند عرض إحصاءات من معالجة الصور، قرب المخرجات الرقمية من كتل مثل `Mean Value of Image` أو `Std. of Image` لجعل اللوحات والتقارير أسهل للقراءة.
* قرب قيم المسافات من `Measure Position Distance` قبل إرسالها إلى الشاشات أو السجلات لتجنب الدقة المفرطة التي قد تكون صعبة الفهم.
* إذا رغبت في تخزين سجلات رقمية مضغوطة أو ملفات CSV، قرب القيم قبل تمريرها إلى `CSV Export` أو `Data to JSON`.
* للرسوم البيانية، مرّر أرقامًا مقربة إلى `Scope` لجعل تسميات المحاور والأساطير أوضح.
* إذا أعادت كتلة اكتشاف تعدادًا (مثل `Object Detection` أو `Object Detection - Custom`)، استخدم هذه الدالة لتنسيق الأرقام لواجهات المستخدم أو السجلات.

## 🛠️ استكشاف الأخطاء وإصلاحها

* إذا لم يتغير المخرج كما هو متوقع، تحقق أن منفذ الإدخال `Number` يستقبل قيمة رقمية صالحة. استخدم `Is None` أو `Replace None` للتعامل مع المدخلات المفقودة قبل التقريب.
* إذا أُدخلت قيمة غير صحيحة في ضابط `Decimals` (غير عدد صحيح)، تأكد من إدخال عدد صحيح صالح؛ وإلا قد يُفسَّر الضابط بطريقة غير متوقعة.