Get Element

تقوم هذه دالة الكتلة باستخراج عنصر واحد من قائمة (Batch) مُقدمة باستخدام قيمة فهرس (Index). تكون مفيدة عندما تحتاج لاختيار عنصر واحد من مجموعة وتمريره إلى الكتل التالية في التدفق.

📥 المدخلات

Batch قائمة أو مجموعة من القيم (صور، أرقام، نصوص، إلخ) التي سيتم استخراج عنصر منها.

Index موقع العنصر (صفر-مبني) الذي يحدد أي عنصر يتم إرجاعه من الـ Batch.

📤 المخرجات

Generic العنصر المحدد من الـ Batch. نوع القيمة المرجعة يتوافق مع نوع العنصر الموجود داخل الدفعة.

🕹️ الضوابط

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

🎨 الميزات

• استخراج بسيط ومباشر لعنصر واحد من قائمة أو دفعة.

• يعمل مع أي نوع بيانات عام داخل الدفعة (صور، أرقام، سلاسل، أشكال، إلخ).

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

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

1. مرّر قائمة أو دفعة إلى مدخل Batch.

2. مرّر موضع العنصر (بالبدايات من صفر) إلى مدخل Index.

3. تُخرج الكتلة العنصر الموجود في الموضع المطلوب عبر خرج Generic.

4. إذا كانت الدفعة ذات طول متغير، تأكد من أن قيمة الفهرس صالحة لتجنب نتائج غير متوقعة.

📊 التقييم

في كل تشغيل، تقرأ الكتلة قيم Batch و Index الحالية، ثم تُمرّر العنصر الموجود في ذلك الفهرس إلى المخرج. إذا أشار الفهرس إلى قيمة مفردة، فسيُعاد عنصر واحد؛ وعند دمجها مع تحكم تدفق التجميع (batching)، يمكن استخدامها لاختيار عناصر محددة للمعالجة اللاحقة.

💡 نصائح وحيل

• استخدم Batch Processing قبل هذه الكتلة عندما تريد تمرير بيانات مجمعة أو متدفقة وتقليل استهلاك الذاكرة.

• اجمعها مع Debatch لتحويل الدفعة إلى عناصر فردية ثم استخدم Get Element لاختيار عنصر محدد من ذلك التدفق.

• استخدم Get Batch Size للتحقق من طول الدفعة قبل اختيار فهرس؛ هذا يمنع الوصول خارج النطاق.

• استخدم Is None و Replace None بعد هذه الكتلة للتعامل مع القيم المفقودة بسلاسة.

• استخدم Data Memory لتجميد أو تخزين الدفعة مؤقتًا والحفاظ على نفس البيانات أثناء تجربة قيم فهرس مختلفة.

• استخدم Debug Input لفحص الـ Batch أو Index عندما تكون النتائج غير متوقعة.

• عند بناء خطوط معالجة صور مفهرسة، اجمعها مع كتل عرض مثل Show Image لمعاينة العنصر المحدد من الصورة.

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

• إذا حصلت على مخرج غير متوقع أو فارغ، فتأكّد أن الـ Batch يحتوي فعلاً على عناصر وأن Index ضمن النطاق الصالح (0..length-1).

• إذا كانت الحزمة أحيانًا توفر قيم None، فاستخدم Is None أو Replace None لحماية المعالجة اللاحقة.

• في تدفقات العمل ذات أحجام دفعات متغيرة، افحص دائمًا Get Batch Size قبل استخدام Index لتجنب الوصول غير الصالح.