Markdownで表示

libreyolo track

動画ファイル、画像ディレクトリ、画像リストに対してmodel.track()を実行し、各フレームのトラックIDを1フレームにつき1行で出力します。1.8.0の新機能で、チェックポイントでもエクスポートした成果物でも同じように動作します。

コマンド
libreyolo track
必須
source
出力
stdoutに1フレームにつき1行。save=trueのときはアノテーション済みの動画をruns/track/の下に出力

書式

bash
libreyolo track source=<video|directory|image|a.jpg,b.jpg> [model=<name|path>] [key=value ...]

引数はkey=valueの組で指定し、POSIX形式も使えるため、tracker=botsortと--tracker botsortは同じ引数です。

引数

引数デフォルト意味
source動画ファイル、画像ディレクトリ、画像パス、またはカンマ区切りのa.jpg,b.jpg形式の画像リスト。必須
modelyolox-sモデル名またはパス。エクスポートした成果物も使えます
trackerbytetrackbytetrack、botsort、ocsort、deepocsortのいずれか。.yamlの表記でも同じ組み込みトラッカーが選ばれます
track_conf0.25トラッカーの第1段階の対応付けにおける信頼度のしきい値
conf検出のしきい値。未設定の場合、検出器はトラッカー自身の低いしきい値で実行され、弱いボックスも復帰用に残ります
iou0.45NMSのIoUしきい値
imgsz入力画像サイズ:640(正方形)または480x640(HxW)。未設定ならモデル自身の入力サイズ
classesクラスIDで絞り込みます(例:[0,2,5])。整数1つだけでも受け付けます
max_det3001フレームあたりの最大検出数
savefalseアノテーション済みの動画を保存
showfalse追跡したフレームを表示。qで停止
vid_stride1Nフレームごとに処理
fps30画像シーケンスで想定するフレームレート。動画では無視されます
output_path出力動画のパス。デフォルトはruns/track/<name>.mp4で、実行が別の実行を上書きしないよう番号が付きます
color_formatauto入力の色形式:auto、rgb、bgr
deviceautoデバイス:0、cpu、mps、auto
jsonfalsestdoutへのJSON出力。1フレームにつき1オブジェクト
quietfalsestderrを抑制
verbosefalsestderrへの詳細出力
help_jsonfalseコマンドのスキーマをJSONで出力して終了

例

基本
libreyolo track model=LibreYOLO9s.pt source=video.mp4
別のトラッカー、動画を保存
libreyolo track model=LibreYOLO9s.pt source=video.mp4 \  tracker=botsort classes="[0]" save=true
エクスポートしたモデル、フレームごとのJSON
libreyolo track model=weights/LibreYOLO9s.onnx source=frames/ fps=25 \  json=true quiet=true

注意事項

各実行は1つのソースを最初のフレームから追跡するため、persistオプションはありません:トラックIDがコマンド間で引き継がれることはありません。ライブソースはconfig_unsupportedで拒否されます:Webカメラとストリームです。動画ファイル、画像ディレクトリ、画像リストを使ってください。

人が読む形式の出力は1フレームにつき1行で、たとえばframe 12 video.mp4: 1920x1080 3 tracks (ids 1, 2, 5)のようになり、stderrの最後にはフレーム数と一意なトラックIDの数が出ます。json=trueでは、各フレームが1つのJSONオブジェクトになり、tracker、frame_index、detectionsリストを持ちます。このリストの各ボックスはtrack_id、class、class_id、confidence、bbox_xyxyを持ちます。

関連付けるボックスを持たないタスクのモデルや、track()を持たないモデルタイプはconfig_unsupportedで終了します。終了コードはlibreyolo predictに従います:成功時は0、使い方または設定のエラーは2、ソースが見つからない場合は3、モデルを読み込めない場合は4、その他の実行時エラーは1です。

トラッカー、その設定、Pythonのtrack()呼び出しについては物体追跡で説明しています。

LibreYOLO v1.8.0で検証済みです。