ViewRecDB-100K
收藏资源简介:
ViewRecDB-100K是一个用于AI摄影的3D视点推荐数据集,旨在解决给定一张次优摄影图像时,预测如何通过调整3D视点(包括位置、朝向和视野)来获得更优构图的任务。该数据集包含10万个训练样本和1千个测试样本,每个样本由一对图像组成:一张次优图像和一张对应的最优图像,并附带有从次优到最优的3D视点变化标注。数据来源于Unsplash Full Dataset,通过自动构建生成。其中,测试样本构成了一个专门的基准集,其最优图像均经过专家验证,在摄影构图上优于对应的次优图像。数据集按train、val和test划分。每个样本文件夹包含一张最优图像(original.jpeg)和一到两张生成的次优图像(generated_*.jpeg)及其对应的视点变化标注文件(generated_*.json)。数据实例中的图像均为RGB格式,总像素预算为1024×1024。视点变化标注包含两个部分:change_orientation(一个布尔值,指示是否需要在横屏与竖屏之间改变图像方向)和pose(一个9维描述符,其中前3维为平移向量,接着4维为旋转四元数,最后2维为视野缩放因子s,表示视野收缩比例,等同于焦距缩放比例)。由于Unsplash Full Dataset的再分发限制,本数据集中不直接包含original.jpeg文件。用户需要从官方渠道申请并下载Unsplash Full Dataset,然后使用提供的脚本工具,通过指定元数据文件路径和数据集分割目录来关联和下载原始图像。该数据集适用于计算机视觉任务,特别是相机姿态估计和视点推荐。
ViewRecDB-100K is a 3D viewpoint recommendation dataset for AI photography. It aims to address the task of predicting how to adjust the 3D viewpoint (including position, orientation, and field of view) to achieve a better composition given a suboptimal photographic image. The dataset contains 100,000 training samples and 1,000 test samples. Each sample consists of a pair of images: a suboptimal image and a corresponding optimal image, along with annotations for 3D viewpoint changes from suboptimal to optimal. The data is sourced from the Unsplash Full Dataset and generated through automated construction. The test samples form a dedicated benchmark set, where the optimal images have been verified by experts to be superior in photographic composition compared to the corresponding suboptimal images. The dataset is divided into train, val, and test splits. Each sample folder contains an optimal image (original.jpeg) and one or two generated suboptimal images (generated_*.jpeg) along with their corresponding viewpoint change annotation files (generated_*.json). The images in the dataset instances are in RGB format with a total pixel budget of 1024×1024. The viewpoint change annotations consist of two parts: change_orientation (a boolean value indicating whether to change the image orientation between landscape and portrait) and pose (a 9-dimensional descriptor, where the first 3 dimensions are translation vectors, the next 4 are rotation quaternions, and the last 2 are field-of-view scaling factors s, representing the field-of-view contraction ratio, equivalent to focal length scaling). Due to redistribution restrictions of the Unsplash Full Dataset, the original.jpeg files are not included directly in this dataset. Users need to apply for and download the Unsplash Full Dataset from official sources, then use the provided script tool to associate and download the original images by specifying metadata file paths and dataset split directories. This dataset is suitable for computer vision tasks, particularly camera pose estimation and viewpoint recommendation.
ViewRecDB-100K 数据集概述
基本信息
- 许可证: CC-BY-4.0
- 语言: 英语
- 标签: 相机姿态估计(camera-pose-estimation)、视角推荐(viewpoint_recommendation)
- 数据集规模: 10K < n < 100K
- 数据划分: 训练集(train)、验证集(val)、测试集(test)
数据集简介
ViewRecDB-100K 是一个用于 AI 摄影的 3D 视角推荐数据集。它包含 10 万个训练样本和 1 千个测试样本。每个样本由一对次优图像和最优图像,以及对应的 3D 视角变化标注组成。给定一张次优图像,任务是预测朝向最优图像的 3D 视角变化。
该数据集从 Unsplash Full Dataset 自动构建。测试样本构成了一个专用基准,其中每张最优图像都经过专家验证,确保其摄影构图优于对应的次优图像。
数据结构
数据集包含三个划分:train、val 和 test。每个样本文件夹包含一张最优图像和 1 到 2 张生成的次优图像,并附有对应的视角变化标注。
ViewRecDB-100K/ ├── train/ │ └── photo_id/ # Unsplash Full Dataset 中的 photo_id │ ├── original.jpeg # 最优图像 │ ├── generated_0.jpeg # 次优图像 │ ├── generated_0.json # 视角变化标注 │ ├── generated_1.jpeg # 可选的次优图像 │ └── generated_1.json # 可选的视角变化标注 ├── val └── test
数据字段
每个数据实例包含以下字段:
- suboptimal_image / optimal_image: 输入的次优图像。RGB 图像,总像素预算为 1024 × 1024。
- viewpoint_change: 从次优图像到最优图像的 3D 视角变化标注。
- change_orientation: 布尔值,指示是否应更改图像方向(即横竖屏切换)。
- pose: 9 维视角描述符。
pose[0:3]: 平移向量。pose[3:7]: 旋转四元数。pose[7:9]: FoV 缩放因子 s,表示视野缩小比例,等同于焦距缩放比例。
使用说明
由于 Unsplash Full Dataset 的重新分发限制,ViewRecDB-100K 版本中未直接包含 original.jpeg 文件。用户需要从 官方来源 申请并下载 Unsplash Full Dataset。
-
获取 Unsplash 元数据文件后,使用
--csv_root指定其路径,并使用--id_root指定应下载原始图像的数据集划分目录。bash python -m script.download --csv_root /path/to/unsplash_metadata --id_root /path/to/ViewRecDB-100K/train | val | test --csv_pattern ".csv"
参数说明:
- --csv_root: 包含 Unsplash 元数据文件的目录路径。
- --id_root: 数据集划分目录路径,如
train、val或test。 - --csv_pattern: 用于匹配元数据文件的文件名模式,如
*.csv*或*.tsv*。





