English version (README.en.md) is also available.
Windows上にMMD自動トレースの環境を(わりと簡単に)構築するインストーラです。 下記のプログラム群をインストールします。
miuさんが開発されたローカル版MMD自動トレースをベースにしていますが、OpenPoseの代わりに tf-pose-estimation を採用することでインストールを簡単にしています。
MMD自動トレースについて詳しくはMMDモーショントレース自動化への挑戦を参照してください。
64bit版 Windows 10 で動作します(32bit版Windowsは非サポート)。 4GB以上のVRAMを搭載したNVIDIA GPU が必要です。NVIDIA GPUを搭載していないPCをお使いの場合は クラウド版をお勧めします。
ディスクの空き容量は約20GB程度必要になります。 また、ツールやデータを大量にダウンロードしてインストールするため、定額制で通信量に制限のないインターネット回線が必要です。
（もし旧バージョンがインストール済の場合、本プログラムを旧バージョンに上書きしてアップデートする ことも可能です。新規インストールよりアップデートのほうが短時間で完了する可能性があります。 詳しくは本ドキュメントの「アップデート」の節を参照してください。）
GitHubから本プログラムのZIPファイルをダウンロードして適当なフォルダ(例: C:\App)に展開します。 以下の説明では、この展開されたフォルダが C:\App\mmdmatic だとします。 別のフォルダに置いた場合は適宜読み替えてください。
https://www.anaconda.com/products/individual からAnacondaのWindows用インストーラをダウンロードします。このインストーラにはPythonも同梱されています。必ず Python 3.7 版の 64-Bit Graphical Installer を選びましょう。
ダウンロードしたインストーラを実行します。途中の Advanced Options で、"Add Anaconda3 to my PATH environment variable" にチェックを入れます。それ以外はデフォルト設定のまま Next をクリックしていきます。
Setting up the package cache ... と表示された後しばらく時間がかかりますが、止まったように見えても Show details をクリックすると動いているのが分かります。最後に Finish をクリックして終了です。
まずはサンプル動画で試し、 正常にVMDファイルが作られるのを確認することをお勧めします。 なお、動画の解像度によってはエラーが起こることがあります。1280x720や1920x1080が無難です。
自動トレース実行時に、下記のオプションを指定できます。
tf-pose-estimationが人の正面と背面を誤認識していることがあるので、このリストで指定して向きを反転させます。
反転させるフレーム番号(0始まり)、人物INDEX、反転の内容を指定してください。
人物INDEX: tf-pose-estimationが第0フレームで人物を認識した順に0, 1, ...とINDEXが割り当てられます。
フォーマット: [フレーム番号:反転を指定したい人物INDEX,反転内容]
反転内容: R: 全身反転, U: 上半身反転, L: 下半身反転, N: 反転なし
例: [10:1,R] -> 第10フレームの1番目の人物を全身反転します。
message.logに上記フォーマットで、反転出力した場合にその内容を出力しているので、それを参考にしてください。[10:1,R][30:0,U]のように、カッコ単位で複数件指定可能です。
複数人数トレースで、交差後の人物INDEX順番を指定してください。
1人トレースの場合は空欄のままで大丈夫です。
tf-pose-estimationが第0フレームで認識した順番に0, 1, ...とINDEXが割り当てられます。
フォーマット: [フレーム番号:0番目に推定された人物のインデックス,1番目に推定された人物のインデックス, ...]
例: [10:1,0] -> 第10フレームは、左から1番目の人物、0番目の人物の順番に並べ替えます。
message.logに上記フォーマットで、どのような順番で出力したかを残しているので、それを参考にしてください。 [10:1,0][30:0,1]のように、カッコ単位で複数件指定可能です。
また、output_XXX.aviでは、推定された順番に人物に色が割り当てられています。体の右半分は赤、左半分は以下の色になります。 0:緑, 1:青, 2:白, 3:黄, 4:桃, 5:水色, 6:濃緑, 7:濃青, 8:灰色, 9:濃黄, 10:濃桃, 11:濃水色
uninstall.bat を実行することでPythonパッケージおよび仮想環境を削除します。
最初の質問にYと答えると削除が実行されます。Nと答えるとキャンセルできます。
完了したら、本プログラムを展開したフォルダ(例: C:\App\mmdmatic)を削除してください。
もし Anaconda も不要な場合は、「コントロールパネル」 - 「プログラムと機能」
から、それぞれアンインストールしてください。
もし旧バージョンがインストール済の場合、下記の手順でアップデートすることが可能です。
下記の各フォルダ内にインストールされる各ツールのREADMEおよびライセンスファイルを参照してください。 なお、これらのツールが使っているデータセットに商用利用不可のもの(Human 3.6M)が含まれることに注意してください。
本プログラム自体はMITライセンスです。詳しくは LICENSE ファイルを参照してください。
Q. 何故かVMDファイルが作られない。
A. 何かエラーが起きているはずです。エラーメッセージを確認してください。
エラーメッセージでググったり(できれば各ツールのGitHubリポジトリのissueを検索したり)すると解決法が見つかることがあります。
また、全ての動画でモーション作成が成功するとは限りません。まずサンプル動画で正しく動作するか確認しましょう。
Q. Anacondaはインストール済みなのに "Anaconda is not installed appropriately" のエラーが出る。
A. Anacondaのインストーラーで "Add Anaconda to my PATH environment variable" を選ばなかった
のではありませんか？
Anacondaを一度アンインストールしてインストールし直すほうが簡単だと思いますが、
この状態でも Anaconda Prompt から各バッチファイルを実行することは可能です。
スタートメニューの「Anaconda3 (64-bit)」にある「Anaconda Prompt」を起動し、
インストール先フォルダに移動してから(例: cd C:\App\mmdmatic)、
setup.bat や autotracevmd.bat を実行してみてください。
Q. 何も表示されずにバッチファイルが終了する。
A. 上に書かれた方法で Anaconda Prompt から実行して、エラーメッセージを確認してください。
Q. 古いGPUでも使えますか？ A. あまり古いGPUだと、機械学習ライブラリTensorFlowが対応していない可能性があります。 詳しくは https://www.tensorflow.org/install/gpu?hl=ja を参照してください。
Q. "CUDA driver version is insufficient for CUDA runtime version" というエラーが出る。 A. GPUのドライバが古いので、アップデートしましょう。
Q. "CUDA out of memory" というエラーが出る。 A. GPUのメモリ(VRAM)容量が不足しています。4GB以上のVRAMを搭載したGPUが必要です。 もし十分なVRAMが有るのにこのエラーが出る場合、他にGPUを使うプログラムが動いていないか確認してください。
バグ報告は下記のいずれかにどうぞ(上のほうが推奨)。 表示されたメッセージと、本プログラムのバージョンを併せてご連絡ください。 エラーメッセージはコピー＆ペーストでそのままの内容を貼り付けてください。 Twitterの場合は文字数が限られるのでスクリーンショットでも構いません。 （必要な情報が書かれていなかったり、FAQにある内容だったり、あるいは単に忙しかったりすると放置するかもしれませんがご了承ください）