OpenFaceの導入手順

OpenFaceのインストール方法を、OSごとに説明する。

table:

OS 所要時間作業内容

Windows10 10分実行可能ファイルが同梱されているので、ダウンロードするだけで使える

Linux 30～60分ビルド作業は必要だが、ビルド用スクリプトが同梱されており、手間はかからない

Mac 1時間～手作業でのビルドが必要なので、順調に進んでも1時間くらいはかかってしまう

Dockerも使える →　Quickstart usage of OpenFace with Docker

Raspberry Piでも動くが重すぎる →　Compiling for an ARM architecture #86 （480pの動画で高々2fps）

OpenFaceのインストール作業は手間がかかるものの、視線トリガー（TriggEye）のインストールで面倒なのは唯一ここだけなので、ここさえ乗り越えれば、後は楽。

https://github.com/TadasBaltrusaitis/OpenFace/raw/master/imgs/gaze_ex.png https://github.com/TadasBaltrusaitis/OpenFace

（画像の出典：視線追跡中の画面 TadasBaltrusaitis/OpenFace - GitHub）

インストール先のディレクトリ

説明の都合上、どのOSでも、視線トリガー（TriggEye）の「インストール手順」で作った ~/TriggEye ディレクトリに、OpenFaceをインストールする。

Windows10へのインストール手順

【所要時間 10分】 WSL2 で動作を確認済み。WSLでも問題ないはず

リリース一覧から最新版のZIPファイルをダウンロードして、Windows側のDownloadsフォルダ内に展開

展開したフォルダを、WSL（Windows Subsystem for Linux）側のディレクトリ~/TriggEyeに移す

code:sh

% cd ~/TriggEye

% mv /mnt/c/Users/$WINDOWS_USERNAME/Downloads/OpenFace_2.2.0_win_x64/OpenFace_2.2.0_win_x64 .

モデルデータをダウンロード（約400MB）

code:sh

% cd OpenFace_2.2.0_win_x64/model/patch_experts/

% wget -O - https://raw.githubusercontent.com/TadasBaltrusaitis/OpenFace/master/download_models.sh | bash

% cd ../..

ここでは、Ubuntu用のダウンロードスクリプト（download_models.sh）を流用している

Windows用にもPowerShellスクリプトが用意されているが、少し面倒なので、ここでは使わない

動作確認

Ubuntuへのインストール手順

【所要時間 30～60分】 Ubuntu 18.04 LTS で動作を確認済み。19.04では動かないかも

ビルド用スクリプトが用意されているので手間はかからないが、ビルドには時間がかかる

TriggEyeの材料費で例に挙げたパソコンで全行程に約25分かかった

code:sh

% cd ~/TriggEye

% wget -O - https://github.com/TadasBaltrusaitis/OpenFace/archive/OpenFace_2.2.0.tar.gz | tar zxvf -

% cd OpenFace-OpenFace_2.2.0

% bash download_models.sh # モデルデータのダウンロード（約400MB）

% sudo bash install.sh # ビルドには数十分かかる

動作確認

Macへのインストール手順

【所要時間 1時間～】古いMacだと動かない場合もあるので注意

難しければ、仮想マシンにUbuntuをインストールした方が楽かも、、、

code:sh

% cd ~/TriggEye

% wget -O - https://github.com/TadasBaltrusaitis/OpenFace/archive/OpenFace_2.2.0.tar.gz | tar zxvf -

% cd OpenFace-OpenFace_2.2.0

% bash download_models.sh # モデルデータのダウンロード（約400MB）

ここから先のインストール作業は、公式のインストール手順の通りに、手作業で進める。

動作確認

パソコンにWebカメラを接続してから、以下を実行

Window % ./FeatureExtraction.exe -device 0

Linux、Mac % build/bin/FeatureExtraction -device 0

-device 0の値 0（カメラのID）は、環境によって異なるので注意

終了するには、ターミナルでCtrl + C、または、OpenFaceの画面上で q

このページの冒頭の画像のような画面が表示されれば、インストール成功

うまく行かない場合は、公式のインストール手順を参照　→　Windows、 Linux、 Mac

2019/8/21