DECAオープンソースプロジェクトの詳細な構造と設定ガイド

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: 事前学習済みモデルのパスを定義します。
  • その他のパラメータ: 学習率、バッチサイズ、トレーニングエポック数などが含まれます。

プロジェクトを使用する際には、これらの設定ファイルを実際の状況に応じて修正し、プロジェクトが正しく実行されトレーニングされるようにする必要があります。

タグ: 3Dモデリング 表情キャプチャ SIGGRAPH Python 深層学習

6月28日 21:41 投稿