SimpleView 项目使用教程

1. 项目的目录结构及介绍

SimpleView 项目的目录结构如下：

SimpleView/
├── ScanObjectNN/
│   └── SimpleView/
├── configs/
├── data/
├── dgcnn/
├── img/
├── models/
├── pointnet2_pyt/
├── pointnet2_tf/
├── pointnet_pyt/
├── rs_cnn/
├── .gitignore
├── LICENSE
├── README.md
├── all_utils.py
├── configs.py
├── dataloader.py
├── download.sh
├── eval_models.sh
├── main.py
├── pc_utils.py
└── requirements.txt

目录介绍：

• ScanObjectNN/: 包含 ScanObjectNN 数据集的相关代码。
• configs/: 存放各种模型的配置文件。
• data/: 存放数据集文件。
• dgcnn/: 包含 DGCNN 模型的相关代码。
• img/: 存放项目相关的图片文件。
• models/: 存放各种模型的代码。
• pointnet2_pyt/: 包含 PointNet++ 模型的 PyTorch 实现。
• pointnet2_tf/: 包含 PointNet++ 模型的 TensorFlow 实现。
• pointnet_pyt/: 包含 PointNet 模型的 PyTorch 实现。
• rs_cnn/: 包含 RSCNN 模型的相关代码。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件。
• README.md: 项目介绍文件。
• all_utils.py: 包含各种工具函数。
• configs.py: 配置文件管理脚本。
• dataloader.py: 数据加载器脚本。
• download.sh: 数据和预训练模型下载脚本。
• eval_models.sh: 模型评估脚本。
• main.py: 项目主脚本，用于训练和测试模型。
• pc_utils.py: 点云处理工具函数。
• requirements.txt: 项目依赖库列表。

2. 项目的启动文件介绍

项目的启动文件是 main.py。该文件用于训练和测试模型。启动文件的使用格式如下：

python main.py --exp-config <path to the config>

其中，--exp-config 参数用于指定配置文件的路径。配置文件的命名格式为 <protocol>_<model_name><_extra>_run_<seed>.yaml。

3. 项目的配置文件介绍

配置文件存放在 configs/ 目录下，命名格式为 <protocol>_<model_name><_extra>_run_<seed>.yaml。配置文件中包含了模型的超参数、数据加载器的配置等信息。

配置文件示例：

# 示例配置文件
protocol: dgcnn
model_name: pointnet2
extra: valid
seed: 1
epochs: 100
batch_size: 32
learning_rate: 0.001
...

配置文件参数说明：

• protocol: 使用的协议，如 dgcnn、pointnet2 等。
• model_name: 使用的模型名称，如 pointnet2、simpleview 等。
• extra: 额外的配置参数，如 valid 表示验证集。
• seed: 随机种子。
• epochs: 训练的轮数。
• batch_size: 批处理大小。
• learning_rate: 学习率。

通过配置文件，用户可以灵活地调整模型的训练参数，以适应不同的实验需求。