How to Use DeepLabCut

　DeepLabCut (DLC)の使い方は、大きく分けて3つあります。

１，Standalone GUIで実行する方法　　　　　　　　　　　　　　　　　　２，Jupyter notebookや COLAB notebookで実行する方法　　　　　　　３，Terminalから実行する方法

　ここでは、初心者向けの「１，Standalone GUI」で実行する方法を解説します。

デモファイルのダウンロード

　まずは、動画ファイルをダウンロードします。こちらのリンク先で、「Code」ボタンをクリックすると現れる「Download ZIP」をクリック。.zip形式でダウンロードされるので、ファイルを右クリックして「すべて展開」を選択します。その中のexamplesフォルダ内のopenfield-Pranav-2018-10-30\videos\m3v1mp4.mp4を使って解説していきます。ご自分の動画でももちろん可能です。

Standalone GUIの起動

　まず、Command Promptを起動、DLCの仮想環境に入ってみましょう（方法はこちら）。　Command Promptの表示が、

(DLC-CPU) C:\Users\(YourUserName)>

あるいは、

(DLC-GPU) C:\Users\(YourUserName)>

のように左端に「(DLC-C(G)PU)」と表示されていれば、成功です。

　以下の3行のコードを入力しましょう。

ipython
import deeplabcut
deeplabcut.launch_dlc()

あるいは、以下のコードでも構いません。

python -m deeplabcut

　するとStandalone GUIが起動します（下図）。

Step 1. Manage Project

　新しいプロジェクトを作成します。Manage Projectのタブを選択、プロジェクト名、実験者を記入し、解析する動画を選択します（下図）。動画は先程ダウンロードしたデモファイルの

DeepLabCut-master\DeepLabCut-master\DeepLabCut-master\examples\openfield-Pranav-2018-10-30\videos\m3v1mp4.mp4

を選択します。Copy the videosもチェックします。Okをクリックすると新プロジェクトの.yamlファイルが作成されます。新プロジェクトの一連のファイルは

C:\Users\(YourUserName)\(Name of the Project) - (Name of the experimenter)  - (Date)

のフォルダの中に保存されています。

　.yamlファイルを編集できるように設定しましょう。新たに作成された.yamlファイルはPCの

C:\Users\(UserName)\(Name of the Project) - (Name of the experimenter)  - (Date)\config.yaml

config.yamlファイルを右クリックして「Open with」でメモ帳（notepad）を選択します。Standalone GUIのManage Projectの右下、Edit config fileをクリックして、config.yamlファイルがメモ帳で起動すれば成功です。

　Edit config fileをクリックして、今回のデモファイル向けにconfig.yamlファイルを編集しましょう。.yamlファイルの前半の方に、

bodyparts:
- bodypart1
- bodypart2
- bodypart3
- objectA

と書かれている箇所があると思います。ここを、

bodyparts:
- nose
- leftear
- rightear
- tailbase

と編集し、保存しましょう。自前の動画の場合、自分が追跡したいポイントのリストを書き出します。

　もし、新しいプロジェクトを作るのではなく、以前のプロジェクトの続きをしたい場合は、「Load existing project」を選択し、「Select the config file」から、再開したいプロジェクトの.yamlファイルを選びます。DeeplabcutのGUIは不安定です。フリーズすることが頻繁にあります。そのようなときも「Load existing project」から以前のプロジェクトを選んで再ロードしましょう。

DeepLabCut - Standalone GUI - 2に続きます。

参考サイト・文献