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
Copyright (C) 2019 Tak Jaga