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

# Maximum

هذا البلوك الوظيفي يقوم بإيجاد أكبر قيمة بين مجموعة قابلة للتكوين من المدخلات الرقمية ويعيد كلًا من تلك القيمة وموقعها.

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

`Values`\
قيمة أو أكثر من القيم الرقمية (موفرة كمدخلات فردية أو كقائمة). يمكن تعديل عدد مقابس الإدخال المتاحة باستخدام التحكم أدناه.

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

`Number`\
أعلى قيمة رقمية مُعثر عليها بين المدخلات المزودة.

`Index`\
موقع (فهرس يبدأ من الصفر) القيمة العليا داخل مجموعة المدخلات المزودة.

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

`Input size`\
اختر عدد المدخلات الرقمية المتاحة (مثلاً من 2 وحتى الحد الأقصى المكوّن). تغيير هذا الإعداد يضبط عدد القيم التي يمكنك توصيلها بالبلوك.

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

* تغيير ديناميكي لحجم المدخلات — غيّر بسهولة عدد المدخلات الرقمية التي يقبلها البلوك لتتناسب مع هيكل بياناتك.
* مخرجات مزدوجة — يعيد كلًا من القيمة العظمى والفهرس المقابل لها بحيث يمكنك استخدام أيٍ منهما في المنطق اللاحق.
* يعمل مع القوائم أو مقابس القيم الفردية عندما تكون متاحة.

## 📊 آلية التشغيل <a href="#evaluation" id="evaluation"></a>

عند تشغيل التدفق، يقوم البلوك بفحص المدخلات الرقمية المتصلة ويحدد القيمة العظمى وموقعها. يُؤخذ في الحسبان فقط المدخلات النشطة/المتصلة. إذا كانت هناك قيم متساوية متعددة تشكل القيمة العظمى، فسيتم إرجاع فهرس الظهور الأول.

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

1. اضبط عدد المدخلات باستخدام التحكم `Input size` ليتوافق مع عدد القيم التي ستزوّدها.
2. وصل مصادر رقمية (أو قائمة أرقام) بمداخل `Values`.
3. اقرأ مخرج `Number` للحصول على القيمة العظمى و`Index` للحصول على موضعها.
4. قم بتغذية تلك المخرجات إلى بلوكات أخرى لتشغيل المنطق أو العرض أو التسجيل.

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

* استخدم `Get Element` لاستخراج قيمة محددة من قائمة قبل أو بعد بلوك `Maximum` عند العمل ببيانات مجمعة.
* اكمل مع `Batch Processing` و`Get Batch Size` عند التعامل مع قوائم كبيرة أو بيانات متدفقة لتقليل استهلاك الذاكرة والتحكم بكيفية تغذية القيم إلى البلوك.
* أرسل المخرجات الرقمية إلى `Scope` لتصور تدفقات القيم الحية وملاحظة الاتجاهات أو القفزات بسهولة.
* لحساب النطاق، استخدم `Minimum` بجانب هذا البلوك ثم `Subtract` لاحتساب max−min.
* خزّن النتائج باستخدام `Data Memory` إذا احتجت لتجميد أو الاحتفاظ بقيمة عظمى للمقارنة لاحقًا.

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

* لا توجد نتيجة صالحة: تأكد من توصيل مدخل رقمي واحد على الأقل.
* فهرس غير متوقع عند تساوي القيم: `Index` المرجع يعود لحدوث القيمة الأولى.
* المدخلات غير الرقمية ستمنع الحصول على نتائج مفيدة — تحقق من أن البلوكات المصدرية توفر أرقامًا.