ICface 项目启动与配置教程

1. 项目目录结构及介绍

ICface项目的目录结构如下：

icface/
├── images/                       # 存放项目相关的图片文件
├── test_code_released_new/       # 包含最新测试代码和权重文件
├── test_code_released_old/       # 包含早期测试代码
├── License/                      # 许可证文件
├── README.md                     # 项目说明文件
├── image_crop.py                 # 图像裁剪脚本
├── test.py                       # 测试脚本
├── ...                           # 其他相关文件和目录

• images/：存放用于演示的源图像和生成动画的图像。
• test_code_released_new/：包含最新的测试代码和预训练的权重文件，用于生成人脸动画。
• test_code_released_old/：包含早期的测试代码，可能包含旧版本的模型和功能。
• License/：存放项目的许可证文件，说明了项目的使用和分发条款。
• README.md：项目的说明文档，介绍了项目的基本信息和如何使用。
• image_crop.py：用于裁剪图像的脚本，以便用于项目。
• test.py：主要的测试脚本，用于执行人脸动画的生成。

2. 项目的启动文件介绍

项目的启动主要通过test.py脚本进行。这个脚本用于加载预训练的模型权重，读取源图像和动作单元数据，然后生成人脸动画。

运行test.py的基本命令如下：

python test.py --dataroot ./ --model pix2pix --which_model_netG resnet_6blocks --which_direction AtoB --dataset_mode aligned --norm batch --display_id 0 --batchSize 1 --loadSize 128 --fineSize 128 --no_flip --name gpubatch_resnet --how_many 1 --ndf 256 --ngf 128 --which_ref ./new_crop/1.png --gpu_ids 1 --csv_path 00116.csv --results_dir results_video

在运行该脚本之前，需要确保已经下载了预训练的权重文件，并将其放置在正确的目录下。

3. 项目的配置文件介绍

在test.py中，可以通过命令行参数对项目进行配置。以下是一些主要的配置参数：

• --dataroot：指定数据根目录，即包含源图像和动作数据的目录。
• --model：指定使用的模型架构，例如pix2pix。
• --which_model_netG：指定生成器模型的具体类型，例如resnet_6blocks。
• --which_direction：指定数据传输的方向，例如AtoB表示从源图像到目标图像。
• --dataset_mode：指定数据集的模式，例如aligned表示使用对齐的数据。
• --norm：指定归一化类型，例如batch表示批次归一化。
• --display_id：指定显示结果的ID，通常用于可视化。
• --batchSize：指定批量大小，通常设为1，因为人脸动画生成通常一次处理一个样本。
• --loadSize和--fineSize：指定加载和细化图像的大小。
• --no_flip：指定不进行图像翻转，因为人脸动画通常不需要翻转。
• --name：指定实验的名称，用于标识生成的结果。
• --how_many：指定生成图像的数量。
• --ndf和--ngf：指定生成器和判别器中的卷积层数量。
• --which_ref：指定参考图像的路径，用于生成动画。
• --gpu_ids：指定使用的GPU ID。
• --csv_path：指定包含动作单元数据的CSV文件路径。
• --results_dir：指定存放生成视频的目录。

通过调整这些参数，用户可以根据自己的需求自定义项目的配置。