إضافة Ultralytics لـ VS Code
شاهد: كيفية استخدام إضافة Ultralytics في Visual Studio Code | مقتطفات شيفرة جاهزة للاستخدام | Ultralytics YOLO 🎉
الميزات والفوائد#
✅ هل أنت عالم بيانات أو مهندس تعلم آلة تطوّر تطبيقات رؤية حاسوبية باستخدام Ultralytics؟
✅ هل سئمت كتابة كتل الشيفرة نفسها مرارًا وتكرارًا؟
✅ هل تنسى دائمًا الوسائط أو القيم الافتراضية لأساليب train أو val أو predict أو export أو track؟
✅ هل ترغب في البدء باستخدام Ultralytics وتتمنى لو كانت لديك طريقة أسهل للرجوع إلى أمثلة التعليمات البرمجية أو تشغيلها؟
✅ هل تريد تسريع دورة التطوير عند العمل باستخدام Ultralytics؟
إذا كنت تستخدم Visual Studio Code وأجبت بـ«نعم» عن أي مما سبق، فقد تساعدك إضافة Ultralytics-snippets لـ VS Code. تتناول الأقسام أدناه وظيفة الإضافة وكيفية تثبيتها واستخدامها.
شغّل شيفرة مثال باستخدام Ultralytics YOLO في أقل من 20 ثانية.
مستوحاة من مجتمع Ultralytics#
جاءت فكرة إنشاء هذه الإضافة من مجتمع Ultralytics. وأسهمت أسئلة المجتمع حول موضوعات وأمثلة مشابهة في تطوير هذا المشروع. إضافةً إلى ذلك، يستخدم كثير من أعضاء فريق Ultralytics برنامج VS Code في أعمالهم.
لماذا VS Code؟#
يستخدم المطورون حول العالم Visual Studio Code على نطاق واسع، وقد تصدّر تصنيف البرامج الأكثر شعبية في استطلاع Stack Overflow للمطورين في 2021 و2022 و2023 و2024. وتعود شعبيته إلى إمكانات التخصيص الواسعة والميزات المضمنة والتوافق الكبير وقابلية التوسعة. ونظرًا إلى شعبيته في أوساط المطورين عمومًا وداخل مجتمعات Ultralytics على Discord وDiscourse وReddit وGitHub، كان من المنطقي إنشاء إضافة لـ VS Code للمساعدة في تبسيط سير عملك.
للمشاركة بالأدوات التي تستخدمها لتطوير الشيفرات، صوّت في استطلاع المجتمع على Discourse.
تثبيت الإضافة#
التثبيت في VS Code#
-
انتقل إلى قائمة الإضافات في VS Code أو استخدم الاختصار Ctrl+Shift ⇑+x، ثم ابحث عن Ultralytics-snippets.
-
انقر على الزر Install.
التثبيت من سوق إضافات VS Code#
-
تفضل بزيارة سوق إضافات VS Code وابحث عن Ultralytics-snippets، أو انتقل مباشرةً إلى صفحة الإضافة في سوق VS Code.
-
انقر على الزر Install واسمح لمتصفحك بفتح جلسة VS Code.
-
اتبع أي مطالبات لتثبيت الإضافة.
صفحة سوق إضافات Visual Studio Code الخاصة بـUltralytics-Snippets
استخدام إضافة Ultralytics-Snippets#
-
إكمال الشيفرة الذكي: اكتب الشيفرة بسرعة ودقة أكبر باستخدام اقتراحات متقدمة لإكمال الشيفرة، مصممة خصيصًا لـ API الخاص بـ Ultralytics.
-
زيادة سرعة التطوير: وفّر الوقت بإلغاء مهام البرمجة المتكررة باستخدام مقتطفات كتل شيفرة جاهزة.
-
تحسين جودة الشيفرة: اكتب شيفرة أوضح وأكثر اتساقًا وبأخطاء أقل.
-
تبسيط سير العمل: حافظ على تركيزك على المنطق الأساسي لمشروعك من خلال أتمتة المهام الشائعة.
نظرة عامة#
لن تعمل الإضافة إلا عند ضبط وضع اللغة على Python. ويمنع ذلك إدراج المقتطفات عند العمل على أي نوع آخر من الملفات. تبدأ بادئة جميع المقتطفات بـ ultra؛ اكتب ultra في المحرر بعد تثبيت الإضافة لعرض قائمة بالمقتطفات المتاحة. ويمكنك أيضًا فتح لوحة الأوامر في VS Code باستخدام Ctrl+Shift ⇑+p وتشغيل الأمر Snippets: Insert Snippet.
حقول مقاطع التعليمات البرمجية#
تتضمن مقاطع كثيرة «حقولًا» تحتوي على قيم أو أسماء افتراضية مؤقتة. على سبيل المثال، يمكن حفظ ناتج الأسلوب predict في متغير Python باسم r أو results أو detections أو preds أو أي اسم آخر يختاره المطور، ولذلك تتضمن المقاطع «حقولًا». عند استخدام Tab ⇥ على لوحة المفاتيح بعد إدراج المقطع، ينتقل المؤشر سريعًا بين الحقول. وبعد تحديد حقل، يؤدي إدخال اسم متغير جديد إلى تغييره في ذلك الموضع وفي كل موضع آخر له في تعليمات المقطع البرمجية!
بعد إدراج المقتطف، يؤدي تغيير اسم model إلى world_model إلى تحديث جميع النسخ. يؤدي الضغط على Tab ⇥ إلى الانتقال إلى الحقل التالي، حيث تفتح قائمة منسدلة تتيح اختيار مقياس النموذج، ويؤدي الانتقال إلى الحقل التالي إلى إظهار قائمة منسدلة أخرى لاختيار أحد نوعي النموذج: world أو worldv2.
إكمال مقاطع التعليمات البرمجية#
ليس من الضروري كتابة البادئة الكاملة للمقطع، أو حتى البدء بالكتابة من بدايته. انظر المثال في الصورة أدناه.
صُممت أسماء المقاطع لتكون وصفية قدر الإمكان، لكن هذا يعني أن كتابتها قد تتطلب وقتًا طويلًا، وهو ما يناقض هدف إنجاز العمل بسرعة أكبر. لحسن الحظ، يتيح VS Code للمستخدمين كتابة ultra.example-yolo-predict أو example-yolo-predict أو yolo-predict أو حتى ex-yolo-p والوصول مع ذلك إلى خيار المقطع المطلوب! وإذا كان المقطع المقصود هو فعلًا ultra.example-yolo-predict-kwords، فما عليك سوى استخدام سهمي لوحة المفاتيح ↑ أو ↓ لتحديد المقطع المطلوب، ثم الضغط على Enter ↵ أو Tab ⇥ لإدراج كتلة التعليمات البرمجية الصحيحة.
ستظل كتابة ex-yolo-p تؤدي إلى الوصول إلى المقتطف الصحيح.
فئات المقاطع#
هذه هي فئات المقتطفات المتاحة حاليًا في إضافة Ultralytics-snippets. ستُضاف المزيد مستقبلًا، لذا احرص على التحقق من وجود تحديثات وتفعيل التحديث التلقائي للإضافة. يمكنك أيضًا طلب إضافة مقتطفات أخرى إذا كانت هناك مقتطفات مفقودة.
| الفئة | البادئة الابتدائية | الوصف |
|---|---|---|
| أمثلة | ultra.examples | أمثلة تعليمات برمجية للمساعدة في التعلّم أو البدء باستخدام Ultralytics. وهي نسخ من التعليمات البرمجية الواردة في صفحات الوثائق أو أمثلة مشابهة لها. |
| وسائط الكلمات المفتاحية | ultra.kwargs | سرّع التطوير بإضافة مقاطع لأساليب train وval وpredict وtrack، مع جميع وسائط الكلمات المفتاحية وقيمها الافتراضية. |
| عبارات الاستيراد | ultra.imports | مقاطع لاستيراد عناصر Ultralytics الشائعة بسرعة. |
| النماذج | ultra.yolo | أدرج كتلًا برمجية لتهيئة نماذج متنوعة (yolo وsam وrtdetr، وغير ذلك)، بما في ذلك خيارات إعداد القائمة المنسدلة. |
| النتائج | ultra.result | كتل برمجية للعمليات الشائعة عند العمل مع نتائج الاستدلال. |
| أدوات مساعدة | ultra.util | تتيح وصولًا سريعًا إلى الأدوات المساعدة الشائعة المضمنة في حزمة Ultralytics. تعرّف على المزيد عنها في صفحة الأدوات المساعدة البسيطة. |
التعلّم من خلال الأمثلة#
تُعد مقتطفات ultra.examples مفيدة جدًا لكل من يرغب في تعلم أساسيات البدء باستخدام Ultralytics YOLO. صُممت أمثلة المقتطفات لتعمل فور إدراجها (ويحتوي بعضها أيضًا على خيارات منسدلة). ويوضح الرسم المتحرك في أعلى هذه الصفحة مثالًا على ذلك؛ فبعد إدراج المقتطف، يُحدد كل الشيفرة وتُشغّل تفاعليًا باستخدام Shift ⇑+Enter ↵.
كما توضح الرسوم المتحركة في أعلى هذه الصفحة، يمكنك استخدام المقطع ultra.example-yolo-predict لإدراج مثال التعليمات البرمجية التالي. وبعد إدراجه، يكون خيار الإعداد الوحيد هو مقياس النموذج، ويمكن أن يكون أيًا من الآتي: n أو s أو m أو l أو x.
from ultralytics import ASSETS, YOLO
model = YOLO("yolo26n.pt", task="detect")
results = model(source=ASSETS / "bus.jpg")
for result in results:
print(result.boxes.data)
# result.show() # أزل التعليق لعرض صورة كل نتيجةتسريع التطوير#
تهدف المقتطفات بخلاف ultra.examples إلى تسهيل التطوير وتسريعه عند العمل باستخدام Ultralytics. ومن كتل الشيفرة الشائعة في العديد من المشاريع التكرار على قائمة Results التي تُرجعها طريقة التنبؤ الخاصة بالنموذج. ويمكن لمقتطف ultra.result-loop المساعدة في ذلك.
سيؤدي استخدام ultra.result-loop إلى إدراج التعليمات البرمجية الافتراضية التالية (بما في ذلك التعليقات).
# reference https://docs.ultralytics.com/modes/predict#working-with-results
for result in results:
result.boxes.data # torch.Tensor arrayلكن بما أن Ultralytics يدعم مهامًا عديدة، فهناك سمات أخرى من Results قد ترغب في الوصول إليها عند العمل مع نتائج الاستدلال، وهنا تكون حقول المقتطفات مفيدة.
بعد الانتقال باستخدام مفتاح Tab إلى الحقل boxes، تظهر قائمة منسدلة تتيح اختيار سمة أخرى حسب الحاجة.
وسائط الكلمات المفتاحية#
هناك أكثر من 100 وسيط من وسائط الكلمات المفتاحية لمختلف المهام والأنماط في Ultralytics! يصعب تذكّر هذا العدد الكبير، وقد يسهل نسيان ما إذا كان الوسيط هو save_frame أم save_frames (إنه save_frames). وهنا يمكن أن تساعد مقتطفات ultra.kwargs!
لإدراج أسلوب predict مع جميع وسائط الاستدلال، استخدم ultra.kwargs-predict، إذ سيُدرج التعليمات البرمجية التالية (بما في ذلك التعليقات).
model.predict(
source=src, # (str, optional) دليل المصدر للصور أو مقاطع الفيديو
imgsz=640, # (int | list) حجم صور الإدخال كعدد صحيح أو كقائمة [h,w] للتنبؤ
conf=0.25, # (float) الحد الأدنى لعتبة الثقة
iou=0.7, # (float) عتبة التقاطع على الاتحاد (IoU) لعملية NMS
vid_stride=1, # (int) خطوة معدل إطارات الفيديو
stream_buffer=False, # (bool) تخزين الإطارات الواردة في قائمة انتظار مؤقتة (True)، أو الاحتفاظ بأحدث إطار فقط (False)
visualize=False, # (bool) حفظ الخرائط الحرارية لتنشيط الفئات
augment=False, # (bool) تطبيق زيادة بيانات الصور على مصادر التنبؤ
agnostic_nms=False, # (bool) إجراء NMS دون اعتبار للفئة
classes=None, # (int | list[int], optional) تصفية النتائج حسب الفئة، مثل classes=0 أو classes=[0,2,3]
retina_masks=False, # (bool) استخدام أقنعة تجزئة عالية الدقة
embed=None, # (list[int], optional) إرجاع متجهات السمات/التضمينات من طبقات محددة
show=False, # (bool) عرض الصور ومقاطع الفيديو المتنبأ بها إذا سمحت البيئة بذلك
save=True, # (bool) حفظ نتائج التنبؤ
save_frames=False, # (bool) حفظ إطارات الفيديو المتنبأ بها كلٌّ على حدة
save_txt=False, # (bool) حفظ النتائج في ملف .txt
save_conf=False, # (bool) حفظ النتائج مع درجات الثقة
save_crop=False, # (bool) حفظ الصور المقصوصة مع النتائج
stream=False, # (bool) معالجة مقاطع الفيديو الطويلة أو أعداد كبيرة من الصور مع تقليل استخدام الذاكرة، وذلك بإرجاع مولّد
verbose=True, # (bool) تمكين/تعطيل سجلات الاستدلال التفصيلية في الطرفية
)يتضمن هذا المقطع حقولًا لجميع وسائط الكلمات المفتاحية، وكذلك للمتغيرين model وsrc في حال استخدمت متغيرًا مختلفًا في التعليمات البرمجية. ويتضمن كل سطر يحتوي على وسيطة كلمة مفتاحية وصفًا موجزًا للرجوع إليه.
جميع مقاطع التعليمات البرمجية#
أفضل طريقة لمعرفة المقاطع المتاحة هي تنزيل الإضافة وتثبيتها وتجربتها! وإذا كنت مهتمًا وتريد الاطلاع على القائمة مسبقًا، فتفضل بزيارة المستودع أو صفحة الإضافة في سوق VS Code لعرض جداول جميع المقاطع المتاحة.
الخلاصة#
تساعد إضافة Ultralytics-Snippets لـ VS Code علماء البيانات ومهندسي تعلم الآلة على إنشاء تطبيقات الرؤية الحاسوبية باستخدام Ultralytics YOLO بكفاءة أكبر. وتتيح لك مقتطفات الشيفرة والأمثلة الجاهزة قضاء وقت أقل في كتابة الشيفرة التمهيدية ووقت أطول في منطق مشروعك. يُرجى مشاركة ملاحظاتك بزيارة صفحة الإضافة في سوق VS Code وكتابة مراجعة.
الأسئلة الشائعة#
يمكن طلب مقاطع جديدة من خلال قسم Issues في مستودع Ultralytics-Snippets.
الإضافة مجانية.
يستخدم VS Code مجموعة المفاتيح Ctrl+Space لإظهار مزيد من المعلومات أو إخفائها في نافذة المعاينة. إذا لم تظهر لك معاينة المقتطف عند كتابة بادئة مقتطف شفرة، فمن المفترض أن تؤدي مجموعة المفاتيح هذه إلى استعادة المعاينة.
إذا كنت تستخدم VS Code وبدأت تظهر لك رسالة تطالبك بتثبيت امتداد Ultralytics-snippets، ولا تريد رؤية الرسالة بعد الآن، فهناك طريقتان لتعطيلها.
-
ثبّت Ultralytics-snippets ولن تظهر الرسالة بعد ذلك.
-
يمكنك استخدام
yolo settings vscode_msg=Falseلمنع ظهور الرسالة من دون الحاجة إلى تثبيت الامتداد. يمكنك معرفة المزيد في صفحة إعدادات Ultralytics إذا لم تكن على دراية بها.
-
زُر مستودع Ultralytics-snippets وافتح Issue أو Pull Request!
كما هو الحال مع أي امتداد آخر في VS Code، يمكنك إلغاء تثبيته بالانتقال إلى قائمة Extensions في VS Code. ابحث عن امتداد Ultralytics-snippets في القائمة، وانقر على رمز الترس (⚙)، ثم انقر على "Uninstall" لإزالة الامتداد.
التعليقات3
اطرح سؤالًا، وشارك نتائجك، أو ساعد شخصًا آخر.
Hugofox07
Hi, I'm new to YOLO, but I'd like to know how to program it directly from VS Code instead of Google Colab. Does anyone have any videos with simple examples of how to display an image, or even a video on YOLO detection? Thanks for the help.
Glenn JocherUltralyticsThanks for posting here—yes, you can run Ultralytics YOLO locally in VS Code; install the package, then use these minimal examples, and the VS Code Snippets extension lets you insert
ultra.example-yolo-predictto get a runnable template (the extension page linked above has a short walkthrough video); for setup see the Install Ultralytics guide and for options see the Predict mode guide.pip install ultralyticsfrom ultralytics import YOLO # Image model = YOLO("yolo11n.pt", task="detect") model.predict(source="path/to/image.jpg", show=True) # Video model.predict(source="path/to/video.mp4", show=True, save=True)See Install Ultralytics and the Predict mode guide; drop any follow-ups here so the team can see them.
1Hugofox07
Thanks very much , for your help. thanks dude.