コマンドラインインターフェイスの使用法
YOLO コマンドラインインターフェイス(CLI)は、Python 環境を必要とせず、シンプルなシングルラインコマンドを可能にする。CLI カスタマイズやPython コードは必要ない。単純にターミナルから yolo
コマンドを使用している。
見るんだ: MasteringUltralytics YOLOv8 :CLI
例
Ultralytics yolo
コマンドは以下の構文を使う:
yolo TASK MODE ARGS
Where TASK (optional) is one of [detect, segment, classify, pose, obb]
MODE (required) is one of [train, val, predict, export, track, benchmark]
ARGS (optional) are any number of custom 'arg=value' pairs like 'imgsz=320' that override defaults.
yolo cfg
事前に学習させたセグメンテーションモデルを使って、画像サイズ320のYouTube動画を予測する:
YOLOv8n 分類モデルを、画像サイズ 224 x 128 でONNX フォーマットにエクスポートする(TASK は不要)。
どこでだ:
TASK
(オプション) は次のいずれかです。[detect, segment, classify, pose, obb]
.明示的に渡されていない場合、YOLOv8 はその値を推測しようとします。TASK
モデルタイプからMODE
(必須) は次のいずれかである。[train, val, predict, export, track, benchmark]
ARGS
(オプション) は、任意の数のカスタムarg=value
のようなペア。imgsz=320
デフォルトを上書きする。利用可能なARGS
を参照のこと。 構成 ページとdefaults.yaml
警告
引数は arg=val
ペア、イコールで分割 =
記号とスペースで区切られる ペアの間にを使用しないでください。
--
引数の接頭辞またはコンマ ,
引数間の
yolo predict model=yolov8n.pt imgsz=640 conf=0.25
✅yolo predict model yolov8n.pt imgsz 640 conf 0.25
❌yolo predict --model yolov8n.pt --imgsz 640 --conf 0.25
❌
電車
COCO8データセットでYOLOv8n 、画像サイズ640で100エポック学習します。利用可能な引数の全リストは設定ページを参照。
例
バル
COCO8 データセットで学習済みYOLOv8n モデルの精度を検証する。として引数を渡す必要はない。 model
トレーニング data
と引数をモデル属性として使用する。
例
予測する
学習済みのYOLOv8n モデルを使って、画像の予測を実行する。
例
輸出
YOLOv8n 、ONNX 、CoreML などの異なるフォーマットにエクスポートします。
例
利用可能なYOLOv8 エクスポート形式は以下の表の通りです。どのフォーマットでも format
引数、すなわち format='onnx'
または format='engine'
.
フォーマット | format 議論 |
モデル | メタデータ | 論争 |
---|---|---|---|---|
PyTorch | - | yolov8n.pt |
✅ | - |
TorchScript | torchscript |
yolov8n.torchscript |
✅ | imgsz , optimize , batch |
ONNX | onnx |
yolov8n.onnx |
✅ | imgsz , half , dynamic , simplify , opset , batch |
OpenVINO | openvino |
yolov8n_openvino_model/ |
✅ | imgsz , half , int8 , batch |
TensorRT | engine |
yolov8n.engine |
✅ | imgsz , half , dynamic , simplify , workspace , int8 , batch |
CoreML | coreml |
yolov8n.mlpackage |
✅ | imgsz , half , int8 , nms , batch |
TF SavedModel | saved_model |
yolov8n_saved_model/ |
✅ | imgsz , keras , int8 , batch |
TF GraphDef | pb |
yolov8n.pb |
❌ | imgsz , batch |
TF ライト | tflite |
yolov8n.tflite |
✅ | imgsz , half , int8 , batch |
TF エッジTPU | edgetpu |
yolov8n_edgetpu.tflite |
✅ | imgsz |
TF.js | tfjs |
yolov8n_web_model/ |
✅ | imgsz , half , int8 , batch |
PaddlePaddle | paddle |
yolov8n_paddle_model/ |
✅ | imgsz , batch |
NCNN | ncnn |
yolov8n_ncnn_model/ |
✅ | imgsz , half , batch |
詳細を見る export
詳細は 輸出 ページを参照されたい。
デフォルト引数の上書き
デフォルトの引数は、CLI で引数として渡すだけでオーバーライドできる。 arg=value
組。
の検出モデルを訓練する。 10 epochs
と learning_rate
の 0.01
事前に学習させたセグメンテーションモデルを使って、画像サイズ320のYouTube動画を予測する:
デフォルトの設定ファイルを上書きする
をオーバーライドできます。 default.yaml
を持つ新しいファイルを渡すことで、コンフィグファイル全体を変更できる。 cfg
すなわち cfg=custom.yaml
.
これを行うには、まず default.yaml
現在の作業ディレクトリに yolo copy-cfg
コマンドを使用している。
これによって default_copy.yaml
として渡すことができる。 cfg=default_copy.yaml
のような追加引数とともに imgsz=320
この例では
よくあるご質問
モデルトレーニングにUltralytics YOLOv8 コマンドラインインターフェイス (CLI) を使用するにはどうすればよいですか?
CLI を使ってYOLOv8 モデルを訓練するには、ターミナルで単純な1行コマンドを実行すればよい。例えば、検出モデルを学習率0.01で10エポック訓練するには、次のように実行する:
このコマンドは train
モードに特定の引数を指定する。利用可能な引数の一覧は 設定ガイド.
Ultralytics YOLOv8 CLI ではどのような作業ができますか?
Ultralytics YOLOv8 CLI 検出、セグメンテーション、分類、検証、予測、エクスポート、トラッキングなど、さまざまなタスクをサポートする。例えば
- モデルを訓練する:走る
yolo train data=<data.yaml> model=<model.pt> epochs=<num>
. - ラン予想:使う
yolo predict model=<model.pt> source=<data_source> imgsz=<image_size>
. - モデルのエクスポート:実行
yolo export model=<model.pt> format=<export_format>
.
各タスクは様々な引数でカスタマイズできる。詳細な構文と例については、Train、Predict、Exportなどの各セクションを参照してください。
CLI を使って学習させたYOLOv8 モデルの精度を検証するにはどうすればよいですか?
YOLOv8 、モデルの精度を検証する。 val
モードを使用する。たとえば、バッチサイズ1、画像サイズ640の事前学習済み検出モデルを検証するには、次のように実行する:
このコマンドは、指定されたデータセット上でモデルを評価し、パフォーマンス・メトリクスを提供します。詳細については、Valセクションを参照してください。
CLI を使って、YOLOv8 のモデルをどのようなフォーマットでエクスポートできますか?
YOLOv8 モデルは、ONNX 、CoreML 、TensorRT など、さまざまな形式にエクスポートすることができます。例えば、モデルをONNX フォーマットにエクスポートするには、次のように実行します:
詳細は輸出のページをご覧ください。
YOLOv8 CLI コマンドをカスタマイズしてデフォルトの引数を上書きするには?
YOLOv8 CLI コマンドのデフォルト引数を上書きするには、次のように渡します。 arg=value
のペアである。例えば、カスタム引数を使ってモデルをトレーニングするには、次のようにする:
使用可能な引数の全リストとその説明については、コンフィギュレーション・ガイドを参照してください。デフォルト引数の上書き」のセクションにあるように、引数が正しくフォーマットされていることを確認してください。