Math Operations

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

📥 المدخلات

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

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

📤 المخرجات

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

🕹️ عناصر التحكم

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

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

⚙️ آلية التشغيل

• يقرأ البلوك جميع المدخلات الرقمية المتصلة عند تشغيله.

• يطبق الطريقة المختارة عبر تلك القيم:

  • ADD: يجمع جميع المدخلات.

  • SUBTRACT: يطرح مجموع جميع المدخلات التالية من المدخل الأول.

  • MULTIPLY: يضرب جميع المدخلات معًا.

  • DIVIDE: يقوم بقسمة متتابعة بدءًا من المدخل الأول على كل مدخل تالٍ.

• تُعرض النتيجة الرقمية المفردة المحسوبة على مخرج Number.

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

🎯 الميزات

• عدد مدخلات قابل للتوسيع (2–20) لحسابات مرنة.

• عناصر تحكم واجهة بسيطة لتبديل طريقة الحساب فورًا.

• يتجاهل المدخلات غير المتصلة لتجنب الأخطاء عند توصيل أنظمة ديناميكية.

• مصمم للتجميع البصري مع بلوكات القياس والمنطق الأخرى.

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

1. اضبط Input size على عدد القيم التي تريد دمجها.

2. قم بتوصيل بلوكات توليد الأرقام (حساسات، عدادات، نواتج قياس، إدخالات يدوية) بمآخذ الإدخال الرقمية.

3. اختر العملية المطلوبة باستخدام Select a method.

4. اقرأ النتيجة من المخرج Number وقم بتغذيتها إلى البلوكات التالية (التسجيل، العتبات، أو المحركات).

💡 نصائح وحيل

• اجمع مع Number Input عندما تحتاج إلى قيمة يدوية كجزء من الحساب (للتعويض أو العتبات).

• استخدم مع Counter أو Get Batch Size لحساب المتوسطات، المعدلات، أو النسب من القيم المحسوبة.

• قم بتغذية نواتج بلوكات القياس مثل Measure Position Distance أو Image Resolution and Channel Value إلى هذا البلوك لاشتقاق مقاييس مشتقة (مثل المسافة لكل بكسل أو الأحجام المعيارية).

• بعد العملية الحسابية، استخدم Round أو Absolute لتنسيق النتيجة قبل العرض أو التسجيل.

• لحساب قيم عنصر-إلى-عنصر أو مجمعة من قوائم، قم بالإقران مع Get Element أو بلوكات التحكم في الدُفعات لاستخراج الأرقام الفردية أولاً.

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

• إذا كانت النتيجة غير متوقعة، فتأكد من أن جميع المدخلات المطلوبة متصلة وتحتوي على قيم رقمية (استخدم Number Input أو بلوكات التصحيح للتحقق).

• بالنسبة للقسمة، تأكد من أن أي من مآخذ المقسوم عليه ليست صفرًا لتجنب نتائج غير صالحة.

• إذا قمت بتغيير Input size وظهرت وصلات غير متوقعة، فأعد التحقق من الاتصالات — إضافة/إزالة المآخذ قد يغيّر ترتيب الإدخال.

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