Subsystem

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

📥 المدخلات

No default inputs هذا البلوك لا يعرّف مدخلات بشكل افتراضي. يمكن إنشاء المدخلات بإضافة مقابس إدخال داخل مساحة عمل النظام الفرعي ثم كشفها على حد البلوك لتمكين تدفق البيانات من المخطط الرئيسي.

📤 المخرجات

No default outputs هذا البلوك لا يعرّف مخرجات بشكل افتراضي. تُعرّف المخرجات بواسطة البلوكات التابعة الموضوعّة داخل النظام الفرعي ويتم كشفها كمخرجات للبلوك عند حدّ النظام الفرعي.

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

• Open Subsystem Editor افتح مساحة عمل النظام الفرعي لإضافة أو تعديل تدفق العمل المحتوى. (عادة متاحة بالنقر المزدوج على البلوك أو عبر قائمة السياق الخاصة بالبلوك.)

• Expose Input أنشئ مقبس إدخال داخل النظام الفرعي وكشفه على حد البلوك حتى يستطيع المخطط الرئيسي إرسال بيانات إليه.

• Expose Output أنشئ مقبس إخراج داخل النظام الفرعي وكشفه على حد البلوك لإرجاع النتائج إلى المخطط الرئيسي.

• Run / Debug Inside قم بتشغيل وتصحيح تدفق العمل المحتوى بشكل مستقل عن السيناريو الرئيسي للتحقق من سلوكه.

🎯 الميزات الرئيسية

• تغليف: جمع خطوات ما قبل المعالجة، الكشف، التتبع والتصدير في وحدة قابلة لإعادة الاستخدام.

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

• حدود واضحة: كشف المدخلات والمخرجات الضرورية فقط للحفاظ على بساطة المخطط الرئيسي.

• اختبار معزول: افتح وشغّل النظام الفرعي لتصحيح أو التحقق من التدفقات الفرعية بشكل مستقل.

• قابلية إعادة الاستخدام: أنشئ نظامًا فرعيًا مُختبرًا مرة واحدة ثم أعد استخدامه عبر مشاريع مختلفة.

⚙️ كيفية التشغيل

• عند تنفيذ السيناريو، يقوم النظام الفرعي بتشغيل تدفق العمل الداخلي الخاص به.

• تتدفق البيانات إلى النظام الفرعي عبر مقابس الإدخال التي كشفتها بداخله.

• تحسب البلوكات الداخلية نتائجها بالتتابع داخل النظام الفرعي.

• تُجمع المخرجات التي كشفتها داخل النظام الفرعي وتُعاد إلى المخطط الأب كمخرجات للبلوك.

• إذا أبلغ أي بلوك داخلي عن خطأ أو حالة غير صالحة، سيعكس النظام الفرعي تلك الحالة بحيث يمكنك تحديد المشكلة وإصلاحها داخل مساحة العمل.

📝 إرشادات الاستخدام

1. أضف بلوك Subsystem إلى المخطط الرئيسي لاحتواء سلسلة معقدة (الاستحواذ → المعالجة → التصدير).

2. افتح مساحة عمل النظام الفرعي (Open Subsystem Editor) وأضف البلوكات اللازمة.

3. داخل النظام الفرعي، اكشف فقط المدخلات والمخرجات التي يحتاجها المخطط الأب.

4. اختبر النظام الفرعي بشكل مستقل باستخدام أدوات التشغيل/التصحيح الداخلية قبل دمجه في السيناريو الرئيسي.

5. كرّر واعد استخدام الأنظمة الفرعية لمهام متشابهة لتسريع التطوير.

💡 نصائح وحيل

• اجمع خط أنابيب كاميرا كامل داخل نظام فرعي: استخدم Camera USB أو Camera IP (ONVIF) → بلوكات ما قبل المعالجة مثل Image Resize / Blur → كاشفات مثل Object Detection أو Find Object → عرض باستخدام Draw Detections → تخزين مع Image Logger أو Image Write.

• لتدفقات التتبع، ضع Object Detection (أو Object Detection - Custom) و Object_Detection_Tracker داخل نظام فرعي واحد حتى يبقى منطق التتبع وما بعد المعالجة معًا.

• ضع خطوات AI الثقيلة مثل Super Resolution، Depth Estimation (DepthAny. V2)، أو Background Removal (RMBG-1.4) داخل أنظمة فرعية لتسهيل تفعيل/تعطيل أو استبدال النماذج دون تعطيل المخطط الرئيسي.

• استخدم الأنظمة الفرعية لتنفيذ تحليلات متعددة المراحل: مثلاً ROI عبر Image ROI Select → تحليل الأشكال مع Find Contour / Measure Position Distance → تنسيق النتائج مع Data to JSON.

• عند بناء تحليلات تقاطعات أو مرور، احتفظ بالكشف والتتبع في نظام فرعي واحد والتجميع/التصدير (مثل بلوك Traffic Intersection Analysis أو CSV Export) في آخر لفصل الاهتمامات.

• لتمرير البيانات والحالة المحلية، اجمع الأنظمة الفرعية مع Data Write Local و Data Read Local للحفاظ على ذاكرة محلية دون تلويث المخطط العام.

• عند استكشاف الأخطاء، افتح النظام الفرعي وشغّل محتوياته فقط لتحديد أي بلوك داخلي يسبب مخرجات غير صالحة أو غير متوقعة بسرعة.

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

• No outputs appearing تأكد من أنك كشفت مخرجات داخل النظام الفرعي. إن لم يتم كشف أي شيء، فلن يعيد البلوك بيانات إلى المخطط الأب.

• Inputs not received تأكد من إنشاء وكشف مقابس الإدخال داخل النظام الفرعي وأن المخطط الأب متصل بتلك المدخلات المكشوفة.

• Child block reports invalid افتح مساحة عمل النظام الفرعي وافحص البلوكات الفرعية. ستظهر الأخطاء داخل النظام الفرعي—قم بتعديل إعدادات البلوك الفرعي أو استبداله إذا لزم الأمر.

• Performance issues إذا احتوى النظام الفرعي على معالجة ثقيلة (نماذج AI، super-resolution، عمليات دفعات كبيرة)، فكّر في إجراء بروفايل داخل النظام الفرعي ونقل المعالجات غير الأساسية إلى أنظمة فرعية منفصلة عند الطلب.

• Need to reuse or version انسخ النظام الفرعي واحتفظ بنسخة قابلة للاختبار. هذا يجعل تجربة معلمات أو نماذج مختلفة آمنة دون التأثير على المخطط الإنتاجي.