---
title: 'NTUT_VoTT 工具教學'
disqus: hackmd
---

NTUT_VoTT 工具教學
===

## Table of Contents

[TOC]
## 1. 版本資訊

最新版本: NUTU_VoTT_v0.0.5_stable

v0.0.5_stable更新項目:
#### NTUT_VoTT:

根據使用者設定的 FPS 進行追蹤寫入 vott_source_info.json  
產生的資訊檔案變更為json格式(修改後為 vott_source_info.json 和vott_target_path.json)

#### CVTRK:

新增檢查使用者標註重複的 ID 和相同人物標註 1 個以上的 ID 
使用多核心追蹤(multi-core tracker) 替代 multi-thread tracker,以加快 tracking 時間
新增追蹤完成時間
將版本顯示在追蹤物件視窗上
根據使用者設定的 FPS 進行追蹤
NTUT_VOTT 產生的資訊檔案變更為json格式(修改後為 vott_source_info.json 和vott_target_path.json),CVTRK process 相應變更去讀取json檔案

## 2. 工具介紹

NTUT_VoTT 工具是修改在 [Microsoft VoTT](https://github.com/microsoft/VoTT#run-as-web-application) (based on version:v2.2.0) 開源標註軟體的版本，其新增功能如下：
標註後自動追蹤，以減少每幀需重新標註之繁瑣工作

工具教學影片如下連結：
[教學影片](https://youtu.be/b4hVkVEcoGA)

開始到 0:00:19 為開啟 NTUT_VoTT 工具
0:00:23~0:00:26 為開啟專案
0:00:33~0:00:46 為使用者標註
0:00:47~0:01:19 為NTUT_VoTT 開發的輔助追蹤功能
0:01:20 後為回到 VoTT 操作,按下 d(往下幀) 和 a (往上幀)

## 3. 版本更新項目說明
### v0.0.5 stable
#### (1) auto track 按鈕輸入數值解說
Track Time 可針對要追的時間輸入
FPS: 可設定成建立專案時設定的 FPS 或是 15 、6 、5幀

若以下在VoTT專案設定frameRate=5
(1) 輸入0可追1幀
ex:
在第3幀時按下auto track即會自動將第4幀追完

(2) 輸入0以上的數字可追相對應幀數
ex:
若是輸入1在第3幀時按下 auto track 即會自動將第4、5幀追完
若是輸入2在第3幀時按下 auto track 即會自動將第4、5幀和下一秒的1~5幀追完

#### (2) 多核心追蹤
以下為是與 v0.0.5_unstable 版本的追蹤時間比較

v0.0.5_unstable: 
單核心 multi-thread tracker

v0.0.5_stable: 
多核心 multi-core tracker(使用邏輯核心數-2,並在每個核心執行multi-thread tracker)

追蹤人數:15人
測試筆電規格如下圖
追蹤時間:2 秒(使用29 fps進行追蹤)



追蹤結果:

v0.0.5_unstable: 69.642855 sec.
v0.0.5_stable: 58.369137 sec.
平均差異約為 10 秒

#### (3) 使用者標註重複 ID 檢查

若是使用者標註了相同 ID ,如下圖兩人物均標註為 id_001 ,程式會進行提醒


重複標註提醒

#### (3) 使用者在相同人物下標註了1個以上的 ID 檢查

若是使用者在同一人標註了1個以上的ID ,如下圖人物標註多了id_004 ,程式會進行提醒


## 4.工具下載與安裝
---
### (1) 請至以下連結下載 NTUT_VoTT_v0.0.5_stable.zip


[下載位址](https://drive.google.com/drive/u/0/folders/1itcrh_g4PfrYRhOaKfQV85gd5g9w7cSa)

### (2) 放置檔案
請將檔案解壓縮後放置在C:\


完整路徑:
C:\NTUT_VoTT\WIN10\


### (3) 製作捷徑
請至下列位置將 NTUT_VoTT_v0.0.5_stable.exe 新增捷徑到桌面
C\NTUT_VoTT\WIN10\


### (4) 確認 target 與 source 位址
必須要放置如下位置並且名稱要與下列相同

下列以Drone_027當範例

Source:
C:\Drone_Source\Drone_027.mp4


Target:
C:\Drone_Target\Drone_027\Drone_027.vott

:::info
以上設置完成即可點開桌面 NTUT_VoTT_v0.0.5_stable.exe捷徑
如上面的工具測試影片一樣開始使用工具進行標註
如有任何問題請與學長聯繫,並將 log 檔案回傳給學長
log path: C:\NTUT_VoTT\WIN10\NTUT\log\log.txt
小馬學長 Line ID: Philip_Chiang
俊賢學長 Line ID: gun123kk
:::

###### tags: `tool`, `VoTT`