Ultralytics VS Code拡張機能
見る: Ultralytics Visual Studio Code拡張機能の使用方法 | すぐに使えるコードスニペット | Ultralytics YOLO 🎉
機能と利点
✅ Ultralyticsでコンピュータビジョンアプリケーションを構築しているデータサイエンティストまたは機械学習エンジニアですか?
✅ 同じようなコードを何度も書くのが嫌になりますか?
✅ export、predict、train、track、valメソッドの引数やデフォルト値をいつも忘れてしまいますか?
✅ Ultralyticsを使い始めたいけれど、コード例をもっと簡単に参照したり実行したりする方法が欲しいですか?
✅ Ultralyticsを使用する際の開発サイクルをスピードアップしたいですか?
Visual Studio Codeをご利用で、上記いずれかに「はい」と答えた場合、VS Code用のUltralytics-snippets拡張機能がお役に立ちます!拡張機能の詳細、インストール方法、使用方法についてお読みください。
Ultralytics YOLO を使用したサンプルコードを 20 秒以内で実行しましょう! 🚀
Ultralyticsコミュニティからインスピレーションを得ています
この拡張機能を構築するきっかけは、Ultralytics コミュニティからのものでした。同様のトピックや例に関するコミュニティからの質問が、このプロジェクトの開発を促進しました。さらに、Ultralytics チームの一部も VS Code を使用しているため、作業を加速するためのツールとしても使用しています⚡。
VS Codeを選ぶ理由
Visual Studio Codeは、世界中の開発者に非常に人気があり、Stack Overflow Developer Surveyで2021年、2022年、2023年、そして2024年に最も人気のある開発環境としてランク付けされています。VS Codeの高いカスタマイズ性、組み込み機能、幅広い互換性、および拡張性により、非常に多くの開発者が使用しているのも不思議ではありません。より広範な開発者コミュニティ、およびUltralyticsのDiscord、Discourse、Reddit、およびGitHubコミュニティでの人気を考えると、ワークフローを効率化し、生産性を向上させるのに役立つVS Code拡張機能を構築することは理にかなっています。
コード開発に何を使用しているか教えていただけませんか?Discourseのコミュニティ投票に参加して、教えてください!ついでに、私たちのお気に入りのコンピュータビジョン、機械学習、AI、および開発者ミームをチェックしたり、お気に入りのミームを投稿したりすることもできます!
拡張機能のインストール
注
VS Code拡張機能をインストールできる任意のコード環境 する必要があります Ultralytics-snippets 拡張機能との互換性があります。拡張機能を公開した後、 neovim VS Code拡張機能と互換性を持たせることができます。詳細については、こちらをご覧ください。 neovim
インストールセクション のReadme Ultralytics-Snippetsリポジトリ.
VS Codeにインストール
-
VS Codeの拡張機能メニューに移動するか、ショートカットCtrl+Shift ⇑+xを使用し、Ultralytics-snippetsを検索します。
-
Installボタンをクリックします。
VS Code拡張機能マーケットプレイスからインストール
-
VS Code Extension MarketplaceにアクセスしてUltralytics-snippetsを検索するか、VS Code Marketplaceの拡張機能ページに直接アクセスしてください。
-
Installボタンをクリックして、ブラウザでVS Codeセッションを開始できるようにします。
-
プロンプトに従って拡張機能をインストールします。
Visual Studio Code Extension Marketplaceページ( Ultralytics-Snippets
Ultralytics-Snippets 拡張機能の使用
-
インテリジェントなコード補完:Ultralytics APIに合わせて調整された高度なコード補完候補を使用して、より速く、より正確にコードを作成します。
-
⌛ 開発スピードの向上: 反復的なコーディング作業を排除し、構築済みのコードブロックのスニペットを活用することで、時間を節約できます。
-
改善されたコード品質:インテリジェントなコード補完により、よりクリーンで一貫性のある、エラーのないコードを作成します。
-
効率化されたワークフロー:一般的なタスクを自動化することで、プロジェクトのコアロジックに集中できます。
概要
この拡張機能は、以下の場合にのみ動作します。 言語モード は、python 🐍用に構成されています。これは、他のファイルタイプを操作する際に、スニペットが挿入されるのを防ぐためです。すべてのスニペットには、接頭辞として以下が付きます。 ultra
)、と入力するだけです。 ultra
拡張機能をインストールした後、エディターに、使用可能なスニペットのリストが表示されます。VS Codeを開くこともできます。 コマンドパレット 使用 Ctrl+シフト⇑+p そして、コマンドを実行します。 Snippets: Insert Snippet
.
コードスニペットフィールド
多くのスニペットには、デフォルトのプレースホルダー値または名前を持つ「フィールド」があります。たとえば、からの出力 予測 メソッドは、python変数に保存できます。 r
, results
, detections
, preds
または開発者が選択するその他のもの。そのため、スニペットには「fields」が含まれています。使用 タブ ⇥ スニペットが挿入された後、キーボードのタブキーを押すと、カーソルがフィールド間をすばやく移動します。フィールドを選択すると、新しい変数名を入力すると、そのインスタンスだけでなく、スニペットコード内の他のすべてのインスタンスもその変数の名前が変わります。
スニペットを挿入した後、名前を変更します。 model
として world_model
すべてのインスタンスを更新します。押すと タブ ⇥ 次のフィールドに移動すると、ドロップダウンメニューが開き、モデルスケールを選択できます。次のフィールドに移動すると、別のドロップダウンが表示され、いずれかを選択できます world
または worldv2
モデルのバリアント。
コードスニペット補完
さらに短いショートカット
スニペットの完全なプレフィックスを入力したり、スニペットの先頭から入力を開始したりする必要はありません。下の画像の例をご覧ください。
スニペットには可能な限り最も記述的な名前が付けられていますが、これは入力するものが多くなる可能性があることを意味し、目的が移動することである場合は逆効果になります。 より高速。幸いなことに、VS Codeではユーザーが入力できます。 ultra.example-yolo-predict
, example-yolo-predict
, yolo-predict
、または ex-yolo-p
そして、目的のスニペットオプションに到達できます!目的のスニペットが 実際には ultra.example-yolo-predict-kwords
、キーボードの矢印キーを使用するだけで ↑ または ↓ 目的のスニペットを強調表示して、 Enter ↵ または タブ ⇥ 正しいコードブロックが挿入されます。
タイピング ex-yolo-p
〜でしょう still 正しいスニペットにたどり着きます。
スニペットのカテゴリ
これらは、Ultralytics-snippets 拡張機能で利用できる現在のスニペットカテゴリです。今後さらに追加される予定ですので、アップデートを確認し、拡張機能の自動更新を有効にしてください。追加してほしいスニペットがあれば、request additional snippets からリクエストすることもできます。
カテゴリー | 開始プレフィックス | 説明 |
---|---|---|
例 | ultra.examples |
Ultralyticsの学習や入門に役立つサンプルコード。サンプルは、ドキュメントページのコードのコピーまたは類似のものです。 |
Kwargs | ultra.kwargs |
すべてのキーワード引数とデフォルト値を持つtrain、track、predict、およびvalメソッドのスニペットを追加して、開発をスピードアップします。 |
インポート | ultra.imports |
一般的なUltralyticsオブジェクトをすばやくインポートするためのスニペット。 |
モデル | ultra.yolo |
各種初期化のためのコードブロックを挿入 モデル (yolo , sam , rtdetr など)、ドロップダウン構成オプションを含みます。 |
結果 | ultra.result |
推論結果の操作に関する一般的な操作のコードブロック。 |
ユーティリティ | ultra.util |
Ultralytics パッケージに組み込まれている一般的なユーティリティへのクイックアクセスを提供します。詳細については、シンプルなユーティリティのページをご覧ください。 |
事例を用いた学習
The ultra.examples
スニペットは、Ultralytics YOLOの基本的な使い方を学びたい人にとって非常に役立ちます。スニペットの例は、挿入後に一度実行することを目的としています(ドロップダウンオプションがあるものもあります)。この例は、アニメーションで示されています。 top このページの。スニペットが挿入された後、すべてのコードが選択され、を使用してインタラクティブに実行されます。 シフト⇑+Enter ↵.
例
アニメーションが示すように top このページの、スニペットを使用できます ultra.example-yolo-predict
次のコード例を挿入するには。挿入すると、設定可能なオプションはモデル スケールのみになり、次のいずれかになります。 n
, s
, m
, l
、または x
.
from ultralytics import ASSETS, YOLO
model = YOLO("yolo11n.pt", task="detect")
results = model(source=ASSETS / "bus.jpg")
for result in results:
print(result.boxes.data)
# result.show() # uncomment to view each result image
開発の加速
以外のスニペットの目的は 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
アクセスしたい属性、つまり スニペットのフィールド 強力になるでしょう。
タブで boxes
」フィールドでは、必要に応じて別の属性を選択できるドロップダウンメニューが表示されます。
キーワード引数
様々な Ultralytics のキーワード引数は💯個以上あります。 タスク および モード!覚えることがたくさんあり、引数がどうなっているか忘れがちです。 save_frame
または save_frames
(間違いなく save_frames
ちなみに)。ここは ultra.kwargs
スニペットがお役に立ちます!
例
挿入するには 予測 メソッド(すべてを含む) 推論の引数、を使用します。 ultra.kwargs-predict
、これにより、次のコード(コメントを含む)が挿入されます。
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
)
このスニペットには、すべてのキーワード引数のフィールドがありますが、 model
および src
コード内で別の変数を使用した場合に備えて、キーワード引数を含む各行には、参考のために簡単な説明が含まれています。
すべてのコードスニペット
利用可能なスニペットを見つける最良の方法は、拡張機能をダウンロードしてインストールし、試してみることです。もし興味があり、事前にリストを確認したい場合は、repoまたはVS Code marketplaceの拡張機能ページにアクセスして、利用可能なすべてのスニペットの表を表示できます。
結論
VS Code用のUltralytics-Snippets拡張機能は、データサイエンティストや機械学習エンジニアがUltralytics YOLOを使用してコンピュータービジョンアプリケーションをより効率的に構築できるように設計されています。構築済みのコードスニペットと役立つ例を提供することで、革新的なソリューションの作成という最も重要なことに集中できるよう支援します。VS Code Marketplaceの拡張機能ページにアクセスしてレビューを残し、フィードバックをお寄せください。⭐
よくある質問
新しいスニペットをリクエストするにはどうすればよいですか?
新しいスニペットは、Ultralytics-Snippets repoのIssuesを使用してリクエストできます。
Ultralytics-Extensionの費用はいくらですか?
100%無料です!
コードスニペットのプレビューが表示されないのはなぜですか?
VS Codeでは、プレビューウィンドウで詳細情報を表示/非表示するために、キーの組み合わせCtrl+Spaceを使用します。コードスニペットのプレフィックスを入力してもスニペットのプレビューが表示されない場合は、このキーの組み合わせを使用するとプレビューが復元されます。
Ultralyticsで拡張機能の推奨を無効にするにはどうすればよいですか?
VS Codeをご利用で、Ultralytics-snippets拡張機能をインストールするように促すメッセージが表示されるようになったが、このメッセージを非表示にしたい場合は、2つの方法があります。
-
Ultralytics-snippetsをインストールすると、メッセージは表示されなくなります 😆!
-
使用できます。
yolo settings vscode_msg False
拡張機能をインストールしなくてもメッセージが表示されないようにするには。詳細については、こちらをご覧ください。 Ultralyticsの設定 以下の クイックスタート 詳細については、こちらのページをご覧ください。
新しいUltralyticsのコードスニペットのアイデアがありますが、どのように追加できますか?
Ultralytics-snippetsのリポジトリにアクセスして、IssueまたはPull Requestを作成してください。
Ultralytics-Snippets Extensionをアンインストールするにはどうすればよいですか?
他のVS Code拡張機能と同様に、VS Codeの拡張機能メニューからアンインストールできます。メニューでUltralytics-snippets拡張機能を見つけ、歯車アイコン(⚙)をクリックし、次に「アンインストール」をクリックして拡張機能を削除します。