Ultralytics Extension du code VS
Regarder : Comment utiliser Ultralytics Visual Studio Code Extension | Extraits de code prêts à l'emploi | Ultralytics YOLO 🎉
Caractéristiques et avantages
✅ Vous êtes un scientifique des données ou un ingénieur en apprentissage automatique qui construit des applications de vision par ordinateur avec Ultralytics?
✅ Vous détestez écrire les mêmes blocs de code à plusieurs reprises ?
Vous oubliez toujours les arguments ou les valeurs par défaut des méthodes export, predict, train, track ou val?
✅ Vous souhaitez commencer à utiliser Ultralytics et vous aimeriez avoir un moyen plus facile de référencer ou d'exécuter des exemples de code ?
✅ Vous voulez accélérer votre cycle de développement lorsque vous travaillez avec Ultralytics?
Si vous utilisez Visual Studio Code et que vous avez répondu "oui" à l'une des questions ci-dessus, l'extension Ultralytics-snippets pour VS Code est là pour vous aider ! Lisez la suite pour en savoir plus sur cette extension, comment l'installer et comment l'utiliser.
Exécutez un exemple de code en utilisant Ultralytics YOLO en moins de 20 secondes ! 🚀
Inspiré par la communauté Ultralytics
L'inspiration pour construire cette extension est venue de la communauté Ultralytics . Les questions de la communauté sur des sujets et des exemples similaires ont alimenté le développement de ce projet. De plus, comme certains membres de l'équipe Ultralytics utilisent également VS Code, nous l'utilisons aussi comme outil pour accélérer notre travail ⚡.
Pourquoi VS Code ?
Visual Studio Code est extrêmement populaire auprès des développeurs du monde entier et a été classé comme le plus populaire par l'enquête Stack Overflow Developer Survey en 2021, 2022, 2023 et 2024. En raison du haut niveau de personnalisation, des fonctionnalités intégrées, de la large compatibilité et de l'extensibilité de VS Code, il n'est pas surprenant qu'un si grand nombre de développeurs l'utilisent. Compte tenu de la popularité de VS Code auprès de la communauté des développeurs et des communautésDiscord, Discourse, Reddit et GitHub( Ultralytics ), il était logique de créer une extension VS Code pour vous aider à rationaliser votre flux de travail et à augmenter votre productivité.
Vous voulez nous dire ce que vous utilisez pour développer du code ? Rendez-vous sur notre sondage communautaire Discourse et faites-le nous savoir ! Pendant que vous y êtes, jetez un coup d'œil à nos mèmes préférés sur la vision artificielle, l'apprentissage automatique, l'IA et les développeurs, ou même publiez vos mèmes préférés !
Installation de l'extension
Note
Tout environnement de code permettant d'installer des extensions VS Code devrait être compatible avec l'extension Ultralytics-snippets. Après la publication de l'extension, il a été découvert que neovim peut être rendu compatible avec les extensions VS Code. Pour en savoir plus, voir la page neovim
section d'installation du Readme dans le Ultralytics-Dépôt de snippets.
Installation dans VS Code
-
Accédez au menu Extensions dans VS Code ou utilisez le raccourci Ctrl+Shift⇑+x, et recherchez Ultralytics-snippets.
-
Cliquez sur le bouton Installer.
Installation à partir de la place de marché des extensions VS Code
-
Visitez le VS Code Extension Marketplace et recherchez Ultralytics-snippets ou allez directement à la page de l'extension sur le VS Code Marketplace.
-
Cliquez sur le bouton Installer et laissez votre navigateur lancer une session VS Code.
-
Suivez les instructions pour installer l'extension.
Page du marché des extensions de Visual Studio Code pour Ultralytics-Bribes
Utilisation de l'extension Ultralytics-Snippets
-
🧠 Complétion intelligente du code : Écrivez du code plus rapidement et avec plus de précision grâce à des suggestions de complétion de code avancées adaptées à l'API Ultralytics .
-
⌛ Accroissement de la vitesse de développement : gagnez du temps en éliminant les tâches de codage répétitives et en tirant parti d'extraits de blocs de code préconstruits.
-
🔬 Amélioration de la qualité du code : Rédigez un code plus propre, plus cohérent et sans erreur grâce à la complétion intelligente du code.
-
💎 Flux de travail rationalisé : Restez concentré sur la logique centrale de votre projet en automatisant les tâches courantes.
Vue d'ensemble
L'extension ne fonctionnera que lorsque le Mode langue est configuré pour Python 🐍. Ceci afin d'éviter que les snippets ne soient insérés lorsque l'on travaille sur un autre type de fichier. Tous les snippets ont un préfixe commençant par ultra
et en tapant simplement ultra
dans votre éditeur après avoir installé l'extension, affichera une liste de snippets possibles à utiliser. Vous pouvez également ouvrir la fenêtre VS Code Palette de commandes en utilisant Ctrl+Majuscule ⇑+p et en exécutant la commande Snippets: Insert Snippet
.
Champs de l'extrait de code
De nombreux snippets ont des "champs" avec des valeurs ou des noms par défaut. Par exemple, la sortie de l'outil prévoir pourrait être sauvegardée dans une variable Python nommée r
, results
, detections
, preds
ou tout autre élément choisi par le développeur, c'est pourquoi les snippets comprennent des "champs". L'utilisation de Onglet ⇥ sur votre clavier après l'insertion d'un extrait, votre curseur se déplacera rapidement d'un champ à l'autre. Une fois qu'un champ est sélectionné, la saisie d'un nouveau nom de variable modifie cette instance, mais aussi toutes les autres instances du code de l'extrait pour cette variable !
Après avoir inséré le snippet, renommer model
comme world_model
met à jour toutes les instances. En appuyant sur Onglet ⇥ permet de passer au champ suivant, qui ouvre un menu déroulant et permet de sélectionner une échelle de modèle, et en passant au champ suivant, on obtient un autre menu déroulant permettant de choisir l'une des deux options suivantes world
ou worldv2
variante du modèle.
Compléments d'information sur les extraits de code
Des raccourcis encore plus courts
Il n'est pas nécessaire de taper le préfixe complet de l'extrait, ni même de commencer à taper à partir du début de l'extrait. Voir l'exemple dans l'image ci-dessous.
Les extraits sont nommés de la manière la plus descriptive possible, mais cela signifie qu'il peut y avoir beaucoup de choses à taper, ce qui serait contre-productif si l'objectif est de faire bouger les choses. plus rapide. Heureusement, VS Code permet aux utilisateurs de taper ultra.example-yolo-predict
, example-yolo-predict
, yolo-predict
ou même ex-yolo-p
et atteindre l'option de l'extrait prévu ! Si l'extrait voulu était en fait ultra.example-yolo-predict-kwords
puis en utilisant simplement les flèches de votre clavier ↑ ou ↓ pour mettre en surbrillance l'extrait souhaité et en appuyant sur Entrer ↵ ou Onglet ⇥ insérera le bon bloc de code.
Dactylographie ex-yolo-p
volonté encore arriver à l'extrait correct.
Catégories d'extraits
Voici les catégories de snippets actuellement disponibles pour l'extension Ultralytics-snippets. D'autres seront ajoutées à l'avenir, alors assurez-vous de vérifier les mises à jour et d'activer les mises à jour automatiques pour l'extension. Vous pouvez également demander l' ajout de snippets supplémentaires si vous pensez qu'il en manque.
Catégorie | Préfixe de départ | Description |
---|---|---|
Exemples | ultra.examples |
Exemple de code pour aider à apprendre ou pour commencer à utiliser Ultralytics. Les exemples sont des copies ou des similitudes avec le code des pages de documentation. |
Kwargs | ultra.kwargs |
Accélérez le développement en ajoutant des extraits pour les méthodes train, track, predict et val avec tous les arguments des mots clés et les valeurs par défaut. |
Importations | ultra.imports |
Snippets pour importer rapidement des objets courants sur Ultralytics . |
Modèles | ultra.yolo |
Insérer des blocs de code pour l'initialisation des différents modèles (yolo , sam , rtdetr ), y compris les options de configuration de la liste déroulante. |
Résultats | ultra.result |
Blocs de code pour les opérations courantes lors de l'utilisation des résultats de l'inférence. |
Utilitaires | ultra.util |
Permet d'accéder rapidement aux utilitaires courants intégrés dans le paquetage Ultralytics . Pour en savoir plus sur ces utilitaires, consultez la page Utilitaires simples. |
Apprendre avec des exemples
Le ultra.examples
sont très utiles pour toute personne souhaitant apprendre les bases du travail avec Ultralytics YOLO . Les exemples d'extraits sont destinés à être exécutés une fois insérés (certains ont également des options déroulantes). Un exemple est donné par l'animation à la page sommet de cette page, où après l'insertion de l'extrait, tout le code est sélectionné et exécuté de manière interactive à l'aide de la fonction Majuscule ⇑+Entrer ↵.
Exemple
Tout comme les spectacles d'animation au sommet de cette page, vous pouvez utiliser le snippet ultra.example-yolo-predict
pour insérer l'exemple de code suivant. Une fois inséré, la seule option configurable est l'échelle du modèle, qui peut être l'une des suivantes : n
, s
, m
, l
ou x
.
Accélérer le développement
L'objectif pour les extraits autres que le ultra.examples
sont destinés à faciliter et à accélérer le développement lorsque l'on travaille avec Ultralytics. Un bloc de code commun utilisé dans de nombreux projets consiste à itérer la liste de Results
retournés à la suite de l'utilisation du modèle prévoir méthode. La méthode ultra.result-loop
peut vous aider.
Exemple
L'utilisation de la ultra.result-loop
insère le code par défaut suivant (y compris les commentaires).
Cependant, étant donné que Ultralytics prend en charge de nombreux tâches, lorsque travailler avec les résultats de l'inférence il existe d'autres Results
que vous pouvez souhaiter accéder, et c'est là que la fonction champs du snippet sera puissant.
Une fois que l'on a accédé à l'onglet boxes
un menu déroulant apparaît pour permettre la sélection d'un autre attribut.
Arguments sur les mots-clés
Il y a plus de 💯 arguments de mots clés pour tous les différents Ultralytics tâches et modes! Cela fait beaucoup à retenir, et il peut être facile de l'oublier si l'argument est save_frame
ou save_frames
(il s'agit bien d'un save_frames
d'ailleurs). C'est ici que le ultra.kwargs
Les snippets peuvent vous aider !
Exemple
Pour insérer le prévoir y compris tous les arguments de déduction, utiliser ultra.kwargs-predict
qui insérera le code suivant (y compris les commentaires).
model.predict(
source=src, # (str, optional) source directory for images or videos
imgsz=640, # (int | list) input images size as int or list[w,h] for predict
conf=0.25, # (float) minimum confidence threshold
iou=0.7, # (float) intersection over union (IoU) threshold for NMS
vid_stride=1, # (int) video frame-rate stride
stream_buffer=False, # (bool) buffer incoming frames in a queue (True) or only keep the most recent frame (False)
visualize=False, # (bool) visualize model features
augment=False, # (bool) apply image augmentation to prediction sources
agnostic_nms=False, # (bool) class-agnostic NMS
classes=None, # (int | list[int], optional) filter results by class, i.e. classes=0, or classes=[0,2,3]
retina_masks=False, # (bool) use high-resolution segmentation masks
embed=None, # (list[int], optional) return feature vectors/embeddings from given layers
show=False, # (bool) show predicted images and videos if environment allows
save=True, # (bool) save prediction results
save_frames=False, # (bool) save predicted individual video frames
save_txt=False, # (bool) save results as .txt file
save_conf=False, # (bool) save results with confidence scores
save_crop=False, # (bool) save cropped images with results
stream=False, # (bool) for processing long videos or numerous images with reduced memory usage by returning a generator
verbose=True, # (bool) enable/disable verbose inference logging in the terminal
)
Cet extrait contient des champs pour tous les arguments du mot-clé, mais aussi pour model
et src
au cas où vous auriez utilisé une variable différente dans votre code. Sur chaque ligne contenant un mot-clé argument, une brève description est incluse à titre de référence.
Tous les extraits de code
La meilleure façon de savoir quels sont les snippets disponibles est de télécharger et d'installer l'extension et de l'essayer ! Si vous êtes curieux et que vous voulez jeter un coup d'œil à la liste avant, vous pouvez visiter le repo ou la page de l'extension sur la place de marché VS Code pour voir les tableaux de tous les snippets disponibles.
Conclusion
L'extension Ultralytics-Snippets pour VS Code est conçue pour permettre aux scientifiques des données et aux ingénieurs en apprentissage automatique de créer des applications de vision par ordinateur utilisant Ultralytics YOLO plus efficacement. En fournissant des extraits de code préconstruits et des exemples utiles, nous vous aidons à vous concentrer sur ce qui compte le plus : créer des solutions innovantes. Veuillez partager vos commentaires en visitant la page de l'extension sur la place de marché VS Code et en laissant un avis. ⭐
FAQ
Comment demander un nouvel extrait ?
De nouveaux snippets peuvent être demandés en utilisant les Issues sur le repo Ultralytics-Snippets.
Combien coûte l'extension du site Ultralytics?
C'est 100% gratuit !
Pourquoi l'aperçu d'un extrait de code ne s'affiche-t-il pas ?
VS Code utilise la combinaison de touches Ctrl+Espace pour afficher plus ou moins d'informations dans la fenêtre de prévisualisation. Si vous ne voyez pas d'aperçu de l'extrait lorsque vous tapez le préfixe d'un extrait de code, l'utilisation de cette combinaison de touches devrait rétablir l'aperçu.
Comment désactiver la recommandation d'extension dans Ultralytics?
Si vous utilisez VS Code et que vous avez commencé à voir un message vous invitant à installer l'extension Ultralytics-snippets, et que vous ne voulez plus voir ce message, il y a deux façons de le désactiver.
-
Installez Ultralytics-snippets et le message ne s'affichera plus 😆 !
-
Vous pouvez utiliser
yolo settings vscode_msg False
pour désactiver l'affichage du message sans avoir à installer l'extension. Pour en savoir plus sur l'extension Ultralytics Paramètres sur le démarrage rapide si vous n'êtes pas familier avec le sujet.
J'ai une idée pour un nouvel extrait de code Ultralytics , comment puis-je le faire ajouter ?
Visitez le repo Ultralytics-snippets et ouvrez un problème ou une demande de pull !
Comment désinstaller l'extension Ultralytics-Snippets ?
Comme toute autre extension de VS Code, vous pouvez la désinstaller en vous rendant dans le menu Extensions de VS Code. Trouvez l'extension Ultralytics-snippets dans le menu et cliquez sur l'icône en forme de roue dentée (⚙), puis cliquez sur "Uninstall" pour supprimer l'extension.