深度估计项目UDAV2：安装与使用指南

深度估计项目UDAV2：安装与使用指南

Upgraded-Depth-Anything-V2 Upgraded repo includes more capabilities, converted the cmd .py scripts to function more intuitively, added 147 different depth output colour map methods, introduced batch image as well as video processing, everything is automatically saved to an outputs folder (w/ file-naming conventions) & I've converted the .pth models to .safetensors. 项目地址: https://gitcode.com/gh_mirrors/up/Upgraded-Depth-Anything-V2

1. 项目目录结构及介绍

UDAV2（Upgraded Depth Anything V2）项目目录结构如下：

Upgraded-Depth-Anything-V2/
├── assets/                       # 存放示例图片和视频
├── checkpoints/                  # 存放预训练模型文件
├── depth_anything_v2/            # 深度估计相关代码
├── metric_depth/                 # 度量深度估计相关代码
├── DA-2K.md                      # 项目相关文档
├── LICENSE                       # 开源许可证
├── README.md                     # 项目说明文件
├── oc_install.bat                # Windows一键安装脚本
├── oc_install.sh                 # Linux/MacOS一键安装脚本
├── requirements.txt              # 项目依赖文件
├── requirements_macos.txt        # MacOS项目依赖文件
├── run_gradio.bat                # Windows启动Gradio WebUI脚本
├── run_gradio.py                 # Python启动Gradio WebUI脚本
├── run_image-depth_16bit.bat     # Windows处理16bit图像脚本
├── run_image-depth_16bit.py      # Python处理16bit图像脚本
├── run_image-depth_8bit.bat      # Windows处理8bit图像脚本
├── run_image-depth_8bit.py       # Python处理8bit图像脚本
├── run_video-depth.bat           # Windows处理视频脚本
├── run_video-depth.py            # Python处理视频脚本

• assets/：存放项目使用的示例图片和视频文件。
• checkpoints/：存放预训练的深度估计模型文件。
• depth_anything_v2/和metric_depth/：包含深度估计相关的代码和资源。
• DA-2K.md：项目详细介绍和相关文档。
• LICENSE：项目的开源许可证文件。
• README.md：项目的基本介绍和说明。
• oc_install.bat和oc_install.sh：一键安装脚本，用于自动安装项目依赖。
• requirements.txt和requirements_macos.txt：项目所需的依赖文件，requirements_macos.txt专门为MacOS系统提供。
• run_*.bat和run_*.py：不同类型的启动脚本，用于在不同的操作系统上执行图像和视频的深度估计。

2. 项目的启动文件介绍

UDAV2项目提供了多个启动文件，用于不同的使用场景：

• run_gradio.bat和run_gradio.py：用于启动Gradio WebUI，这是一个交互式的网页界面，可以通过浏览器访问来调整参数和查看深度估计结果。
• run_image-depth_16bit.bat和run_image-depth_16bit.py：用于处理16bit图像，并生成深度图。
• run_image-depth_8bit.bat和run_image-depth_8bit.py：用于处理8bit图像，并生成深度图。
• run_video-depth.bat和run_video-depth.py：用于处理视频文件，并生成视频的深度图。

在Windows系统上，用户可以直接双击.bat文件来执行；而在Linux或MacOS系统上，则需要在终端中运行相应的.py脚本。

3. 项目的配置文件介绍

项目的配置主要通过代码中的参数进行调整。在run_*.py脚本中，用户可以设置以下参数：

• --encoder：指定使用的深度估计模型。
• --img-path：指定输入图像或图像文件夹的路径。
• --outdir：指定输出深度图的文件夹路径。
• --input-size：（可选）设置模型输入的图像大小。
• --pred-only：（可选）仅保存预测的深度图，不保存原始图像。
• --grayscale：（可选）保存灰度深度图，不应用颜色映射。

用户可以通过修改这些参数来调整深度估计的结果。例如，要处理一个文件夹中的所有图像并保存深度图，可以运行以下命令：

python run_image-depth.py --encoder vitl --img-path assets/examples --outdir depth_vis

以上是UDAV2项目的安装和使用指南，希望对您有所帮助。

Upgraded-Depth-Anything-V2 Upgraded repo includes more capabilities, converted the cmd .py scripts to function more intuitively, added 147 different depth output colour map methods, introduced batch image as well as video processing, everything is automatically saved to an outputs folder (w/ file-naming conventions) & I've converted the .pth models to .safetensors. 项目地址: https://gitcode.com/gh_mirrors/up/Upgraded-Depth-Anything-V2