Doc3D数据集使用教程

Doc3D数据集使用教程

doc3D-datasetA hybrid dataset for document unwarping (Paper: https://www3.cs.stonybrook.edu/~cvl/projects/dewarpnet/storage/paper.pdf)项目地址:https://gitcode.com/gh_mirrors/do/doc3D-dataset

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>

这些脚本会自动处理下载过程中的中断和恢复，确保已下载的文件不会被重复下载，部分下载的文件会从中断处继续下载。

doc3D-datasetA hybrid dataset for document unwarping (Paper: https://www3.cs.stonybrook.edu/~cvl/projects/dewarpnet/storage/paper.pdf)项目地址:https://gitcode.com/gh_mirrors/do/doc3D-dataset