Batch Concatenation

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

📥 المدخلات

• Batch مدخل واحد أو أكثر من نوع دفعة/قائمة. كل مدخل يمكن أن يحتوي على قائمة من العناصر (صور، نتائج كشف، قيم عامة). يتم قبول المداخل كمقابس batch.

• Batch مدخل دفعة/قائمة إضافي (البلوك يقبل عدة مداخل batch عند إضافتها).

📤 المخرجات

• Batch مخرج واحد من نوع دفعة/قائمة يحتوي على دمج كل القوائم المدخلة بترتيب عناصرها الأصلي محفوظًا.

🕹️ الضوابط

لا يحتوي هذا البلوك على عناصر تحكم مرئية للمستخدم. يعمل تلقائيًا باستخدام المداخل المقدمة.

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

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

🎯 الميزات

• دمج بسيط للقوائم: يربط عدة قوائم في قائمة واحدة.

• يحافظ على الترتيب الأصلي للعناصر من كل مدخل.

• يقبل عناصر batch/قائمة عامة (صور، أرقام، قواميس، إلخ).

📝 كيفية الاستخدام

1. قم بتوصيل مخرج دفعة/قائمة واحد أو أكثر إلى مداخل Batch الخاصة بالبلوك.

2. اربط مخرج الدفعة المفرد لهذا البلوك إلى البلوكات التالية التي تتوقع قائمة أو دفعة.

3. استخدمه عندما تحتاج إلى جمع فروع متوازية (مثل مخارج كاميرات منفصلة أو كواشف متوازية) مرة أخرى في تدفق معالجة واحد.

💡 نصائح وحيل

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

• استخدم Get Batch Size لمعرفة عدد العناصر في الدفعة المدمجة.

• استخدم Get Element لاستخراج عناصر محددة من الدفعة المدمجة بواسطة الفهرس.

• لمعالجة قوائم كبيرة بكفاءة في الذاكرة، اقترن مع Batch Processing لمعالجة العناصر على دفعات أصغر.

• للتصفية من القيم المفقودة أو غير الصالحة قبل الدمج، استخدم Exclude Nones أو Replace None على القوائم الواردة.

• مستهلكو الدُفعات الشائعة للصور المدمجة يشملون: Collage Images, Image Concatenate, Image Logger، أو أي بلوك كشف/تحليل يقبل قوائم صور.

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

• إذا بدت الدُفعة المدمجة فارغة: تحقق من أن كل مدخل يحتوي على عناصر وأن المداخل متصلة فعلاً.

• إذا كان الترتيب مهمًا: تأكد من تقديم المداخل بالترتيب المرغوب لأن البلوك يحافظ على ترتيب المدخلات عند الدمج.

• إذا ظهرت عناصر غير متوقعة (مثل None): استخدم بلوكات التصفية مثل Exclude Nones قبل الدمج.