DECAプロジェクトのディレクトリ構造
DECA(Detailed Expression Capture and Animation)プロジェクトのディレクトリ構造は以下の通りです:
DECA/ ├── Doc/ # ドキュメントディレクトリ │ ├── images/ # ドキュメント内の画像を格納 │ └── Detailed_Expression_Capture_and_Animation.ipynb # プロジェクト紹介ノートブック ├── TestSamples/ # テストサンプルディレクトリ ├── configs/ # 設定ファイルディレクトリ │ └── release_version/ # リリースバージョンの設定ファイル ├── data/ # データファイルを格納 ├── decalib/ # データローダーその他ライブラリを含むモジュール ├── demos/ # デモスクリプトディレクトリ ├── logs/ # ログファイルディレクトリ ├── .gitignore # gitで無視するファイルを指定 ├── Dockerfile # Docker設定ファイル ├── LICENSE # プロジェクトライセンスファイル ├── README.md # プロジェクト説明ファイル ├── docker-compose.yml # Dockerコンポーズ設定ファイル ├── fetch_data.sh # データ取得スクリプト ├── install_conda.sh # conda環境インストールスクリプト ├── install_pip.sh # pipパッケージインストールスクリプト ├── launch.sh # 起動スクリプト ├── main_train.py # メイントレーニングスクリプト ├── requirements.txt # プロジェクト依存のPythonパッケージリスト └── requirements_fixed.txt # 固定のプロジェクト依存ファイル
- Doc/: プロジェクトドキュメントと関連画像を保存します。
- TestSamples/: テストに使用するサンプルデータを含みます。
- configs/: プロジェクトの設定ファイルを含みます。
- data/: 事前学習モデルやテストデータなど、プロジェクトが必要とするデータファイルを保存します。
- decalib/: データローダーその他のライブラリモジュールを含みます。
- demos/: プロジェクト機能をデモンストレーションするためのスクリプトを含みます。
- logs/: トレーニングと実行プロセス中のログファイルを保存します。
プロジェクトのメイン起動ファイル
プロジェクトの主な起動ファイルはmain_train.pyです。このスクリプトはトレーニングプロセスを開始するために使用されます。以下に起動ファイルの基本的な使用方法を示します:
python main_train.py --cfg configs/release_version/deca_pretrain.yml python main_train.py --cfg configs/release_version/deca_coarse.yml python main_train.py --cfg configs/release_version/deca_detail.yml
トレーニングスクリプトを実行する際には、トレーニングプロセスのパラメータを定義する設定ファイル(--cfg)を指定する必要があります。
プロジェクトの設定ファイル
設定ファイルはconfigs/release_version/ディレクトリにあり、主に以下の設定ファイルが含まれています:
- deca_pretrain.yml: 事前学習段階の設定パラメータを定義します。
- deca_coarse.yml: 粗い再構築段階の設定パラメータを定義します。
- deca_detail.yml: 詳細な再構築段階の設定パラメータを定義します。
設定ファイルには通常、以下の内容が含まれています:
- output_dir: 出力ファイルの保存パスを定義します。
- pretrained_model_path: 事前学習済みモデルのパスを定義します。
- その他のパラメータ: 学習率、バッチサイズ、トレーニングエポック数などが含まれます。
プロジェクトを使用する際には、これらの設定ファイルを実際の状況に応じて修正し、プロジェクトが正しく実行されトレーニングされるようにする必要があります。