Doc3D数据集使用教程
1. 项目的目录结构及介绍
Doc3D数据集的GitHub仓库(https://github.com/cvlab-stonybrook/doc3D-dataset)包含以下主要目录和文件:
- README.md: 项目的基本介绍和使用说明。
- LICENSE: 项目的许可证信息。
- data/: 包含数据集的示例数据。
- demo.py: 用于展示数据集中的图像和对应的地面真实数据。
- download_scripts/: 包含用于下载数据集不同部分的脚本。
- download_alb.sh: 下载Albedo数据。
- download_bm.sh: 下载Backward Mapping数据。
- download_dmap.sh: 下载Depth Map数据。
- download_doc3d.sh: 下载整个数据集。
- download_img.sh: 下载图像数据。
- download_norm.sh: 下载Normals数据。
- download_recon.sh: 下载Reconstruction数据。
- download_uv.sh: 下载UV Mapping数据。
- download_wc.sh: 下载Checkerboard数据。
2. 项目的启动文件介绍
- demo.py: 这是一个关键的启动文件,用于展示数据集中的图像和对应的地面真实数据。使用方法如下:
其中:python demo.py --data_root <path_to_doc3d_dataset> --folder <specific_folder> --download_sample
--data_root
: 指向Doc3D数据集的路径。--folder
: 指定要加载图像的特定文件夹。--download_sample
: 如果需要下载一些样本来运行demo.py,则使用此选项。
3. 项目的配置文件介绍
Doc3D数据集没有明确的配置文件,但下载脚本(如download_doc3d.sh
)需要用户提供用户名和密码。用户需要填写Google表单来请求这些凭据,并在脚本中更新这些凭据:
local uname=****
local pass=****
更新凭据后,可以使用以下命令下载整个数据集:
bash download_doc3d.sh
或者下载到特定目录:
bash download_doc3d.sh <out_dir>
这些脚本会自动处理下载过程中的中断和恢复,确保已下载的文件不会被重复下载,部分下载的文件会从中断处继续下载。