Skip to content

Commit fc9526f

Browse files
authored
Update README.md
1 parent 51653cc commit fc9526f

File tree

1 file changed

+96
-1
lines changed

1 file changed

+96
-1
lines changed

README.md

+96-1
Original file line numberDiff line numberDiff line change
@@ -1 +1,96 @@
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

Comments
 (0)