---
# System prepended metadata

title: 使用 NTUT_VoTT 工具(版本v0.0.3_unstable)進行標圖
tags: [homework]

---

---
title: 使用 NTUT_VoTT 工具(版本v0.0.3_unstable)進行標圖
disqus: hackmd
---


使用 NTUT_VoTT Tracker工具(版本v0.0.3_unstable)進行標圖
===
[TOC]
## 一、影片與標注資料下載連結
請先下載影片與標註的專案
[Drone_Source 影片位址]( https://drive.google.com/drive/folders/1VCM0J8mkNEFt3fMp-v-T0JeXdgNTbjeX )
[之前學生標注的檔案](https://drive.google.com/drive/folders/1sY4H6FuHjiApWx4hw3MRyk3bl4waiodb/)


## 二、影片與專案路徑配置
影片請放在以下路徑:
C:\Drone_Source\Drone_00n.mp4
ex:
C:\Drone_Source\Drone_001.mp4

專案請放在以下路徑(依照名稱區分各資料夾):
C:\Drone_Target\Drone_00n\Drone_00n.vott
ex:
C:\Drone_Target\Drone_001\Drone_001.vott


## 三、下載最新版 NTUT_VoTT
[請先按照這份文件，但注意整包code下載位置請參考下方，安裝Cygwin,第一 二 三 四 六章](https://hackmd.io/XtVZMBxATqON13FfAolJ5g?both#1-%E5%89%B5%E5%BB%BA%E8%B3%87%E6%96%99%E5%A4%BE%E5%BE%8C%E4%BD%BF%E7%94%A8repo%E4%B8%8B%E8%BC%89%E5%B0%88%E6%A1%88)

![](https://i.imgur.com/aPGl56U.png)

C:\VoTT\



```gherkin=
若沒有申請KEY在遠端GITHUB,用HTTPS下載:
$ ~/bin/repo init -u https://github.com/masteree108/VoTT_NTUT_WIN10_repo.git -b master

若已經有申請KEY在遠端GITHUB,請選用SSH下載:
$ ~/bin/repo init -u git@github.com:masteree108/VoTT_NTUT_WIN10_repo.git -b master
```

:::warning
若是在下載時有出現
Permissions 0770 for '/home/xxxxx/.ssh/id_rsa' are too open.
可用下列指令修改權限,再重新下載即可
$  chmod 400 ~/.ssh/id_rsa
:::


```gherkin=
更新來源(等同於從遠端下載)
$ ~/bin/repo sync 

指定連結到遠端的主分支
$ ~/bin/repo start master --all
```

使用 NTUT_VoTT標圖 
===

## 一、EXE檔 從雲端下載 版本為" v0.0.3"的執行檔

 WINDOWS 10 vott_tracker.exe 各版本下載位址
[連結位址](https://drive.google.com/drive/u/0/folders/1itcrh_g4PfrYRhOaKfQV85gd5g9w7cSa)


下載完成後，請將檔案解壓縮後放至 

C:/VOTT/VoTT_NTUT/WIN10/NTUT/exe/ 這個資料夾


<!-- ***
已經更新成<0.0.3>版本
![](https://i.imgur.com/3i055AH.png) -->

## 二、vott_tracker.exe 製作方法

:::warning
若上面雲端連結無法下載，再進行這部分製作
:::
請先確認版本後再進行製作

如何確認呢?

Windows的同學請先打開Cygwin64

進入個專案資料夾

輸入tig即可

VOTT_NTUT版本必須與下圖相同位置
![](https://i.imgur.com/W6DvSjp.png)


CVTRK 版本必須與下圖相同位置
![](https://i.imgur.com/7VTPIam.png)


至下列位置執行指令以製作 vott_tracker.exe 
!!注意以下的操作必須在是以repo形式下載專案這樣的路徑才會正確！!
```gherkin=
$ cd VoTT/CVTRK/UBU18
$ ./build_exe.sh

此指令會自動將exe複製到
VoTT_NTUT/UBU18/NTUT/exe/vott_tracker.exe

```

## 三、開啟VoTT

[請先參照這份教學開啟VoTT](https://hackmd.io/@NTUTVOTT/BJ8aAaN8D)

:::warning
注意上述文件的路徑請依照 一、影片與專案路徑配置配置,下面也有解說
:::

本文使用Drone_002當作範例

動作標註注意事項:
```gherkin= 
動作 tag 以名詞為主:
一個目標可以包含多個動作
如果追蹤物體被遮蔽動作依然可以標註,如標註walk+block25
目前紀錄如下:
站立：stand
蹲著：crouch 
坐著：sitting
彎腰：bend_over
下跪：kneel
跳：jump
暖身：warm_up
走路：walk
跑步：running
打棒球：baseball
打籃球：basketball
踢足球：soccer
看手機：watch_phone
滑板：skateboard
遮擋25%：block25
遮擋50%：block50
遮擋75%：block75
遮擋100%：block100
騎機車 腳踏車：riding
釣魚：fishing
溜滑梯：slide
蹺蹺板：seesaw 
盪鞦韆：swing 
倒立：handstand
跳舞：dancce
```
載入剛下載的影片與檔案
###### PS: 注意檔案位置
![](https://i.imgur.com/maVuUUC.png)

開起來後
![](https://i.imgur.com/5czt5qy.jpg)

請先點選左側第三個icon![](https://i.imgur.com/tvSm4zf.png)

確認Drone_Source 跟Dron_Target位置是否正確

###### tags: 可以看到目前偵數為5~6
![](https://i.imgur.com/5mTjUrN.png)

這次標註新增 id 
id的tag命名為 id_00x 依此類推
標註時，人物框住後
tag選擇id即可
![](https://i.imgur.com/CiwipP5.png)


PS. id不要重複

id 標註注意事項:
```gherkin= 
(1) 格式為 id_00n ,n代表數字,如id_001
(2) 任何影片都從id_001開始標註
(3) 相同的frame不會有相同的id,即不能重複
(4) 若追蹤物消失達3秒則更新相同追蹤物id
```

標註完後，輸入1~3秒，再點選auto track進行追蹤
:::danger
注意 自動追完後一定要按下d鍵(next frame)才能將追蹤結果寫入VoTT內部記憶體,執行此動作也能順便確認追蹤情況
:::


## 四、關於錯誤提示訊息
#### 如果出現下圖代表此幀沒有id
![](https://i.imgur.com/Dzbu0XQ.png)

#### 如果出現下圖代表此幀有重複的id

![](https://i.imgur.com/wf7EDLI.png)

#### 如果出現下圖代表追蹤已經失敗(由系統錯誤引發),請參照下列步驟處理

![](https://i.imgur.com/KatAeG1.png)
關於錯誤請參照此路徑下的log
C:\VoTT\VoTT_NTUT\WIN10\NTUT\log\log.txt
若無法解決請將log.txt寄給學長以方便討論

#### 如果出現下圖代表追蹤已經失敗(但非系統錯誤引發),有以下兩種狀況
(1) 代表此追蹤框已經不再可視範圍，將追蹤框移除即可，如下圖為id_002已經不再可視範圍

![](https://i.imgur.com/yJ7S6V6.jpg)

(2) 代表此追蹤框可能太小或位置不對，可調整框的大小重新追蹤，若是一樣無法追蹤請直接刪除，如下圖id_002的追蹤框太小導致無法追蹤
![](https://i.imgur.com/VG9yQEU.jpg)



## 五、已經標注好的檔案
Drone_001: id_001~id_078,影片時間:15:55,設置的fps:6
Drone_002: id_001~id_050,影片時間:11:44,設置的fps:6
Drone_003: id_001~id_057,影片時間:4:47,設置的fps:6
Drone_006: id_001~id_063,影片時間:00:53,設置的fps:6
Drone_007: id_001~id_088,影片時間:01:16,設置的fps:6
Drone_009: id_001~id_045,影片時間:06:02,設置的fps:6
Drone_023: id_001~id_069,影片時間01:33設置的fps:6
Drone_024: id_001~id_073,影片時間:0:56,設置的fps:6
Drone_025: id_001~id_063,影片時間:01:10,設置的fps:6
Drone_027: id_001~id_066,影片時間00:58,設置的fps:6
Drone_028: id_001~id_088,影片時間00:58,設置的fps:6
Drone_038: id_001~id_095,影片時間:01:46,設置的fps:6
Drone_048: id_001~id_088,影片時間00:54,設置的fps:5


設置的fps請參考下圖(請勿更動)
![](https://i.imgur.com/7a7XZP6.png)


[連結](https://drive.google.com/drive/u/0/folders/1-YHyBnEydhWlfqufnXwdxyInmahalXkz)



## 六、分配的標注影片

目前有的標註檔案 共24個
```gherkin=
Drone_001(已完成:文揚)
Drone_002(已完成:文揚)
Drone_003(已完成:文揚)
Drone_006(已完成:品萱)
Drone_007(已完成:品萱)
Drone_009(已完成: 小馬)
Drone_013(標註中:仟)
Drone_014(典伍)
Drone_020(仟)
Drone_021(仟)
Drone_023(已完成:仟)
Drone_024(已完成: 小馬)
Drone_025(已完成:典伍)
Drone_027(已完成:余俊賢)
Drone_028(已完成:余俊賢)
Drone_030(人太多先跳過)
Drone_038(已完成:余俊賢,備註:攝影機過頻繁移動 人物小又密集交錯 導致追蹤框嚴重位移)
Drone_040(標註中:家弘)
Drone_041(已完成:家弘)
Drone_042(已完成:仟)
Drone_043(已完成: 小馬)
Drone_044(標註中:余俊賢)
Drone_048(已完成:子淇)
Drone_049(子淇)
```

請將完成的檔案上傳至[雲端](https://drive.google.com/drive/u/0/folders/1-YHyBnEydhWlfqufnXwdxyInmahalXkz)
並且依照一下格式把訊息丟到line群組，範例如下
```gherkin=
Drone_027: id_001~id_066,影片時間00:58,設置的fps
```

影片分配
```gherkin=
107360702_Qian    
107360731_劉品萱  
107360703_jimmy  
107360729_文揚    
107360727_甯典伍   
```

###### tags: `homework`