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 (غير عدد صحيح)، تأكد من إدخال عدد صحيح صالح؛ وإلا قد يُفسَّر الضابط بطريقة غير متوقعة.