Link to this sectionتصدير النموذج باستخدام Ultralytics YOLO#

Link to this sectionمقدمة#

الهدف النهائي من تدريب النموذج هو نشره في تطبيقات العالم الحقيقي. يوفر وضع التصدير في Ultralytics YOLO26 مجموعة متنوعة من الخيارات لتصدير النموذج المدرب الخاص بك إلى صيغ مختلفة، مما يجعله قابلاً للنشر عبر منصات وأجهزة متعددة. يهدف هذا الدليل الشامل إلى إرشادك خلال تفاصيل تصدير النموذج، مع توضيح كيفية تحقيق أقصى قدر من التوافق والأداء.

Link to this sectionلماذا تختار وضع التصدير في YOLO26؟#

• تعدد الاستخدامات: التصدير إلى صيغ متعددة بما في ذلك ONNX و TensorRT و CoreML والمزيد.
• الأداء: احصل على زيادة في سرعة GPU تصل إلى 5 أضعاف مع TensorRT وزيادة في سرعة CPU تصل إلى 3 أضعاف مع ONNX أو OpenVINO.
• التوافق: اجعل نموذجك قابلاً للنشر عالمياً عبر العديد من بيئات الأجهزة والبرمجيات.
• سهولة الاستخدام: واجهة سطر أوامر (CLI) بسيطة وواجهة برمجة تطبيقات (API) بلغة Python لتصدير النموذج بسرعة وسهولة.

Link to this sectionالميزات الرئيسية لوضع التصدير#

إليك بعض الوظائف البارزة:

• تصدير بنقرة واحدة: أوامر بسيطة للتصدير إلى صيغ مختلفة.
• تصدير الدفعات (Batch Export): تصدير نماذج قادرة على الاستدلال بالدفعات.
• استدلال محسّن: يتم تحسين النماذج المصدرة للحصول على أوقات استدلال أسرع.
• فيديوهات تعليمية: أدلة ودروس متعمقة للحصول على تجربة تصدير سلسة.

Link to this sectionأمثلة الاستخدام#

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

from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n.pt")  # load an official model
model = YOLO("path/to/best.pt")  # load a custom-trained model

# Export the model
model.export(format="onnx")

Link to this sectionالوسائط (Arguments)#

يفصل هذا الجدول التكوينات والخيارات المتاحة لتصدير نماذج YOLO إلى صيغ مختلفة. تعتبر هذه الإعدادات حاسمة لتحسين أداء النموذج المصدر وحجمه وتوافقه عبر مختلف المنصات والبيئات. يضمن التكوين الصحيح أن النموذج جاهز للنشر في التطبيق المقصود بأعلى كفاءة.

يسمح تعديل هذه المعلمات بتخصيص عملية التصدير لتناسب متطلبات محددة، مثل بيئة النشر، وقيود الأجهزة، وأهداف الأداء. إن اختيار التنسيق والإعدادات المناسبة أمر ضروري لتحقيق أفضل توازن بين حجم النموذج، والسرعة، والدقة.

Link to this sectionتنسيقات التصدير#

تتوفر صيغ تصدير YOLO26 في الجدول أدناه. يمكنك التصدير إلى أي صيغة باستخدام وسيط format، مثل format='onnx' أو format='engine'. يمكنك التنبؤ أو التحقق مباشرة من النماذج المصدرة، مثل yolo predict model=yolo26n.onnx. يتم عرض أمثلة الاستخدام لنموذجك بعد اكتمال التصدير. يمكن أيضاً تصدير النماذج مباشرة من المتصفح على منصة Ultralytics دون أي إعداد محلي.

Link to this sectionخيارات التكميم (Quantization Options)#

استخدم المعامل quantize لطلب دقة التصدير. قيم السلسلة النصية غير حساسة لحالة الأحرف، وتقوم Ultralytics بتحويل الأسماء المستعارة المقبولة إلى صيغتها القياسية قبل التصدير:

لا تزال العلامات القديمة half=True و int8=True مقبولة مع إصدار تحذيرات الإهمال، ويتم توجيهها إلى quantize=16 و quantize=8.

لا تدعم كل تنسيقات التصدير كل مستويات الدقة. تؤدي طلبات quantize الصريحة إما إلى إنتاج تلك الدقة أو الفشل قبل التصدير:

بالنسبة لتصديرات INT8 و W8A16، قدم بيانات معايرة تمثيلية باستخدام data، مثل data="coco8.yaml"، ما لم توثق الجهة المتكاملة المستهدفة سلوكاً افتراضياً أو مفعلاً تلقائياً.

Link to this sectionالأسئلة الشائعة#

Link to this sectionكيف يمكنني تصدير نموذج YOLO26 إلى صيغة ONNX؟#

تصدير نموذج YOLO26 إلى صيغة ONNX أمر مباشر مع Ultralytics. فهو يوفر كلاً من طرق Python و CLI لتصدير النماذج.

from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n.pt")  # load an official model
model = YOLO("path/to/best.pt")  # load a custom-trained model

# Export the model
model.export(format="onnx")

لمزيد من التفاصيل حول العملية، بما في ذلك الخيارات المتقدمة مثل التعامل مع أحجام مدخلات مختلفة، راجع دليل تكامل ONNX.

Link to this sectionما هي فوائد استخدام TensorRT لتصدير النموذج؟#

يوفر استخدام TensorRT لتصدير النموذج تحسينات كبيرة في الأداء. يمكن لنماذج YOLO26 المصدرة إلى TensorRT تحقيق زيادة في سرعة GPU تصل إلى 5 أضعاف، مما يجعلها مثالية لتطبيقات الاستدلال في الوقت الفعلي.

• تعدد الاستخدامات: تحسين النماذج لإعدادات أجهزة محددة.
• السرعة: تحقيق استدلال أسرع من خلال تحسينات متقدمة.
• التوافق: التكامل بسلاسة مع أجهزة NVIDIA.

لمعرفة المزيد حول دمج TensorRT، راجع دليل تكامل TensorRT.

Link to this sectionكيف يمكنني تمكين تكميم INT8 عند تصدير نموذج YOLO26 الخاص بي؟#

يعد تكميم INT8 طريقة ممتازة لضغط النموذج وتسريع الاستدلال، خاصة على أجهزة الحافة. إليك كيفية تمكين تكميم INT8:

from ultralytics import YOLO

model = YOLO("yolo26n.pt")  # Load a model
model.export(format="onnx", quantize=8, data="coco8.yaml")

يمكن تطبيق تكميم INT8 على تنسيقات مثل ONNX و TensorRT و OpenVINO و CoreML و Rockchip RKNN. للحصول على نتائج تكميم مثالية، قدم مجموعة بيانات تمثيلية باستخدام المعامل data. راجع خيارات التكميم للاطلاع على قيم quantize المقبولة والتنسيقات المدعومة.

Link to this sectionلماذا يعد حجم المدخلات الديناميكي مهماً عند تصدير النماذج؟#

يسمح حجم المدخلات الديناميكي للنموذج المصدر بالتعامل مع أبعاد صور متغيرة، مما يوفر المرونة ويحسن كفاءة المعالجة لحالات الاستخدام المختلفة. عند التصدير إلى صيغ مثل ONNX أو TensorRT، يضمن تمكين حجم المدخلات الديناميكي أن النموذج يمكنه التكيف مع أشكال المدخلات المختلفة بسلاسة.

لتمكين هذه الميزة، استخدم علامة dynamic=True أثناء التصدير:

from ultralytics import YOLO

model = YOLO("yolo26n.pt")
model.export(format="onnx", dynamic=True)

تعد ميزة تغيير حجم المدخلات ديناميكياً مفيدة بشكل خاص للتطبيقات التي قد تختلف فيها أبعاد المدخلات، مثل معالجة الفيديو أو عند التعامل مع صور من مصادر مختلفة.

Link to this sectionما هي أهم وسائط التصدير التي يجب مراعاتها لتحسين أداء النموذج؟#

يعد فهم وسائط التصدير وتكوينها أمراً بالغ الأهمية لتحسين أداء النموذج:

• format: الصيغة المستهدفة للنموذج المصدر (مثلاً onnx, torchscript, tensorflow).
• imgsz: حجم الصورة المطلوب لمدخلات النموذج (مثلاً 640 أو (height, width)).
• quantize: دقة التكميم، مثل 8/"int8" أو 16/"fp16" أو 32/"fp32" أو "w8a16" لتصديرات دقة الأوزان/التفعيلات المختلطة المدعومة. راجع خيارات التكميم.
• optimize: يطبق تحسينات محددة للأجهزة المحمولة أو البيئات المقيدة.

للنشر على منصات أجهزة محددة، ضع في اعتبارك استخدام صيغ تصدير متخصصة مثل TensorRT لوحدات معالجة الرسومات NVIDIA، أو CoreML لأجهزة Apple، أو Edge TPU لأجهزة Google Coral.

Link to this sectionما الذي تمثله مصفوفات الإخراج (output tensors) في نماذج YOLO المصدرة؟#

عند تصدير نموذج YOLO إلى صيغ مثل ONNX أو TensorRT، يعتمد هيكل مصفوفة الإخراج على مهمة النموذج. يعد فهم هذه المخرجات مهماً لتنفيذات الاستدلال المخصصة.

بالنسبة لـ YOLO26 detection models (على سبيل المثال yolo26n.pt)، يتم تمكين التصدير من طرف إلى طرف (end-to-end) افتراضياً في التنسيقات التي تدعمه، بحيث يكون شكل المخرج (batch_size, max_detections, 6) مع قيم [x1, y1, x2, y2, confidence, class_id]. مع القيمة الافتراضية max_det=300، يكون الشكل عادةً (batch_size, 300, 6). تقوم بعض التنسيقات المقيدة بالرجوع تلقائياً إلى تخطيط المخرجات التقليدي عندما تكون مشغلات النهاية إلى طرف (end-to-end operators) غير مدعومة.

بالنسبة لنماذج الكشف التي لا تعمل من طرف إلى طرف، أو نماذج YOLO26 التي يتم تصديرها باستخدام end2end=False، عادة ما يكون المخرج عبارة عن موتر واحد (single tensor) بشكل (batch_size, 4 + num_classes, num_predictions) حيث تمثل القنوات إحداثيات الصندوق بالإضافة إلى درجات كل فئة، ويعتمد num_predictions على دقة إدخال التصدير (ويمكن أن يكون ديناميكياً).

بالنسبة لـ نماذج التجزئة (مثلاً yolo26n-seg.pt)، ستحصل عادةً على مخرجين: المصفوفة الأولى بشكل (batch_size, 4 + num_classes + mask_dim, num_predictions) (الصناديق، ودرجات الفئة، ومعاملات القناع)، والمصفوفة الثانية بشكل (batch_size, mask_dim, proto_h, proto_w) تحتوي على نماذج أولية للقناع تُستخدم مع المعاملات لإنشاء أقنعة المثيلات. تعتمد الأحجام على دقة إدخال التصدير (ويمكن أن تكون ديناميكية).

بالنسبة لـ نماذج الوضع (مثلاً yolo26n-pose.pt)، عادة ما تكون مصفوفة الإخراج بشكل (batch_size, 4 + num_classes + keypoint_dims, num_predictions)، حيث يعتمد keypoint_dims على مواصفات الوضع (مثلاً عدد النقاط الرئيسية وما إذا كانت الثقة مشمولة)، ويعتمد num_predictions على دقة إدخال التصدير (ويمكن أن يكون ديناميكياً).

توضح الأمثلة الموجودة في أمثلة استدلال ONNX كيفية معالجة هذه المخرجات لكل نوع من أنواع النماذج.

Link to this sectionلماذا يكون output0 بنمط FP32 عند تصدير النماذج المكممة مع تفعيل end2end=True؟#

عند التصدير باستخدام quantize=16 (FP16) أو quantize=8 (INT8)، يتم تحويل معظم الموترات إلى دقة أقل لتقليل حجم النموذج وتحسين الأداء. ومع ذلك، عند تفعيل end2end=True، يتم دمج المعالجة اللاحقة (بما في ذلك فهارس الفئات) مباشرة في الرسم البياني المُصدَّر.

تحتوي مصفوفة output0 على فهارس الفئات، والتي يتم تمثيلها داخلياً كقيم فاصلة عائمة. لا يمكن لـ FP16 تمثيل القيم الصحيحة فوق 2048 بشكل موثوق بسبب دقة mantissa المحدودة. لتجنب فقدان الدقة المحتمل أو معرفات الفئات غير الصحيحة، يتم الاحتفاظ بـ output0 عن عمد بصيغة FP32.

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

إذا كانت مخرجات FP16 الكاملة مطلوبة، قم بالتصدير مع end2end=False وقم بإجراء معالجة ما بعد الاستدلال خارجياً.