|
1 | | -# OpenCV-Object-Tracker-Sample |
| 1 | +# OpenCV-Object-Tracker-Sample |
| 2 | +Python版OpenCVのTracking APIのサンプルです。<br> |
| 3 | +<img src="https://user-images.githubusercontent.com/37477845/125820844-4956a881-0d6c-4519-93dd-8c47b80268ed.gif" loading="lazy" width="40%"> |
| 4 | +<img src="https://user-images.githubusercontent.com/37477845/125820883-d1b08355-258f-4fcd-a59e-19dbd6fb4c2a.gif" loading="lazy" width="40%"> |
| 5 | + |
| 6 | +# Requirement |
| 7 | +* opencv-contrib-python 4.5.3.56 or later |
| 8 | + |
| 9 | +# Algorithm |
| 10 | +2021年07月16日時点でOpenCVには以下9アルゴリズムが実装されています。 |
| 11 | +* DaSiamRPN |
| 12 | +* MIL |
| 13 | +* GOTURN |
| 14 | +* CSRT |
| 15 | +* KCF |
| 16 | +* Boosting(Legacy API) |
| 17 | +* MOSSE(Legacy API) |
| 18 | +* MedianFlow(Legacy API) |
| 19 | +* TLD(Legacy API) |
| 20 | + |
| 21 | +# Usage |
| 22 | +DaSiamRPNトラッカーのみのサンプルと、各アルゴリズムを比較するサンプルの2種類を用意しています。 |
| 23 | +#### DaSiamRPNトラッカーサンプル |
| 24 | +以下コマンドでデモを起動してください。<br> |
| 25 | +最初のフレーム表示時にROI選択を行い追跡対象を指定します。<br> |
| 26 | +ESCキー押下でプログラム終了、スペースキー押下で追跡対象の再指定を行います。<br> |
| 27 | +``` |
| 28 | +python DaSiamRPN_sample.py |
| 29 | +``` |
| 30 | +* --device<br> |
| 31 | +動画ファイル、もしくはカメラデバイス番号の指定<br> |
| 32 | +デフォルト:"sample_movie/bird.mp4" |
| 33 | +* --width<br> |
| 34 | +カメラキャプチャ時の横幅<br> |
| 35 | +デフォルト:960 |
| 36 | +* --height<br> |
| 37 | +カメラキャプチャ時の縦幅<br> |
| 38 | +デフォルト:540 |
| 39 | + |
| 40 | + |
| 41 | +#### 各アルゴリズム比較サンプル |
| 42 | +以下コマンドでデモを起動してください。<br> |
| 43 | +最初のフレーム表示時にROI選択を行い追跡対象を指定します。<br> |
| 44 | +ESCキー押下でプログラム終了、スペースキー押下で追跡対象の再指定を行います。<br> |
| 45 | +--use_xxxxを指定することで使用アルゴリズムを追加できます。 ※(注記)何も指定していない場合はDaSiamRPNのみで動作<br> |
| 46 | +``` |
| 47 | +python performance_comparison_sample.py |
| 48 | +``` |
| 49 | +* --device<br> |
| 50 | +動画ファイル、もしくはカメラデバイス番号の指定<br> |
| 51 | +デフォルト:"sample_movie/bird.mp4" |
| 52 | +* --width<br> |
| 53 | +カメラキャプチャ時の横幅<br> |
| 54 | +デフォルト:960 |
| 55 | +* --height<br> |
| 56 | +カメラキャプチャ時の縦幅<br> |
| 57 | +デフォルト:540 |
| 58 | +* --use_mil<br> |
| 59 | +MILトラッカーの使用有無<br> |
| 60 | +デフォルト:指定なし |
| 61 | +* --use_goturn<br> |
| 62 | +GOTURNトラッカーの使用有無 ※(注記)model/GOTURN配下のzip要解凍<br> |
| 63 | +デフォルト:指定なし |
| 64 | +* --use_dasiamrpn<br> |
| 65 | +DaSiamRPNトラッカーの使用有無<br> |
| 66 | +デフォルト:指定なし |
| 67 | +* --use_csrt<br> |
| 68 | +CSRTトラッカーの使用有無<br> |
| 69 | +デフォルト:指定なし |
| 70 | +* --use_kcf<br> |
| 71 | +KCFトラッカーの使用有無<br> |
| 72 | +デフォルト:指定なし |
| 73 | +* --use_boosting<br> |
| 74 | +Boostingトラッカーの使用有無<br> |
| 75 | +デフォルト:指定なし |
| 76 | +* --use_mosse<br> |
| 77 | +MOSSEトラッカーの使用有無<br> |
| 78 | +デフォルト:指定なし |
| 79 | +* --use_medianflow<br> |
| 80 | +MedianFlowトラッカーの使用有無<br> |
| 81 | +デフォルト:指定なし |
| 82 | +* --use_tld<br> |
| 83 | +TLDトラッカーの使用有無<br> |
| 84 | +デフォルト:指定なし |
| 85 | + |
| 86 | +#ToDo |
| 87 | +- [ ] GOTURNトラッカーのモデル読み込みに失敗する問題の調査 |
| 88 | + |
| 89 | +# Author |
| 90 | +高橋かずひと(https://twitter.com/KzhtTkhs) |
| 91 | + |
| 92 | +# License |
| 93 | +OpenCV-Object-Tracker-Sample is under [Apache-2.0 License](LICENSE). |
| 94 | + |
| 95 | +# License(Image) |
| 96 | +サンプル動画は[NHKクリエイティブ・ライブラリー](https://www.nhk.or.jp/archives/creative/)の[ハクセキレイ エサをついばみながら歩く](https://www2.nhk.or.jp/archives/creative/material/view.cgi?m=D0002161295_00000)を使用しています。 |
0 commit comments